aws-sdk-ivs 1.30.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01af6c6a87f4ddf940c323c7f5221b0a41d8234106bfd2029903e0794df71a8e
-  data.tar.gz: 241f71ad9eb75b1e9a38c2a95b16b7c66ff3efda46dedd157cce4a2c76be8700
+  metadata.gz: 51044daa44af66e0a92396afc5ca6d7c0aaf32fa1f42bf7a05d222a5af1309b7
+  data.tar.gz: 6d6b6452f144ee117e9b039ea6c2e8e26d733cc966a0524e309a7bae31ff245d
 SHA512:
-  metadata.gz: e44caa9e98e1468cfb023928d7d48d0b5d24b9ddb29be6cc2dea32dde9298e76fc8a7f291b1d71da52f6b7f9892e06a492e11854dbb16eddbc1f1e08588f6838
-  data.tar.gz: 76a70414f6b1e703f607e512bf6703f052203fe357b96350d6a9871720f8dffac6fd13055054aea45f331497cc3c3bc049915babd531dfaf6e408bf99b9eeeee
+  metadata.gz: bcb5afa2b79b24603371dbd9847c64e34bd420c0fe435477ccee49e6d2677c640894e47f08f3aba274c196243bdc65cf7b038ba5ec3e9471f369c20ab7d8e57d
+  data.tar.gz: 5b80db8fb2444935228be9edd18ef708f791dc3087fa1ab827da9e52e3d54ad7a42959b979f8994dbe86ea2dfd37b6fe2e6e8707019f9a2bd2f116b8ff498c1e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.31.0 (2023-06-01)
+------------------
+
+* Feature - API Update for IVS Advanced Channel type
+
 1.30.0 (2023-05-31)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.30.0
+1.31.0

data/lib/aws-sdk-ivs/client.rb

@@ -399,10 +399,11 @@ module Aws::IVS
     #   resp.channels[0].latency_mode #=> String, one of "NORMAL", "LOW"
     #   resp.channels[0].name #=> String
     #   resp.channels[0].playback_url #=> String
+    #   resp.channels[0].preset #=> String, one of "HIGHER_BANDWIDTH_DELIVERY", "CONSTRAINED_BANDWIDTH_DELIVERY"
     #   resp.channels[0].recording_configuration_arn #=> String
     #   resp.channels[0].tags #=> Hash
     #   resp.channels[0].tags["TagKey"] #=> String
-    #   resp.channels[0].type #=> String, one of "BASIC", "STANDARD"
+    #   resp.channels[0].type #=> String, one of "BASIC", "STANDARD", "ADVANCED_SD", "ADVANCED_HD"
     #   resp.errors #=> Array
     #   resp.errors[0].arn #=> String
     #   resp.errors[0].code #=> String
@@ -473,6 +474,13 @@ module Aws::IVS
     # @option params [String] :name
     #   Channel name.
     #
+    # @option params [String] :preset
+    #   Optional transcode preset for the channel. This is selectable only for
+    #   `ADVANCED_HD` and `ADVANCED_SD` channel types. For those channel
+    #   types, the default `preset` is `HIGHER_BANDWIDTH_DELIVERY`. For other
+    #   channel types (`BASIC` and `STANDARD`), `preset` is the empty string
+    #   (`""`).
+    #
     # @option params [String] :recording_configuration_arn
     #   Recording-configuration ARN. Default: "" (empty string, recording is
     #   disabled).
@@ -490,9 +498,19 @@ module Aws::IVS
     #
     # @option params [String] :type
     #   Channel type, which determines the allowable resolution and bitrate.
-    #   *If you exceed the allowable resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Default: `STANDARD`. Valid
-    #   values:
+    #   *If you exceed the allowable input resolution or bitrate, the stream
+    #   probably will disconnect immediately.* Some types generate multiple
+    #   qualities (renditions) from the original input; this automatically
+    #   gives viewers the best experience for their devices and network
+    #   conditions. Some types provide transcoded video; transcoding allows
+    #   higher playback quality across a range of download speeds. Default:
+    #   `STANDARD`. Valid values:
+    #
+    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original input
+    #     quality to viewers. The viewer’s video-quality choice is limited to
+    #     the original input. Input resolution can be up to 1080p and bitrate
+    #     can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
+    #     between 480p and 1080p. Original audio is passed through.
     #
     #   * `STANDARD`: Video is transcoded: multiple qualities are generated
     #     from the original input, to automatically give viewers the best
@@ -500,13 +518,36 @@ module Aws::IVS
     #     allows higher playback quality across a range of download speeds.
     #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
     #     Audio is transcoded only for renditions 360p and below; above that,
-    #     audio is passed through. This is the default.
+    #     audio is passed through. This is the default when you create a
+    #     channel.
     #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original input
-    #     to viewers. The viewer’s video-quality choice is limited to the
-    #     original input. Resolution can be up to 1080p and bitrate can be up
-    #     to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions between 480p
-    #     and 1080p.
+    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are generated
+    #     from the original input, to automatically give viewers the best
+    #     experience for their devices and network conditions. Input
+    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
+    #     output is capped at SD quality (480p). You can select an optional
+    #     transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are generated
+    #     from the original input, to automatically give viewers the best
+    #     experience for their devices and network conditions. Input
+    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
+    #     output is capped at HD quality (720p). You can select an optional
+    #     transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   Optional *transcode presets* (available for the `ADVANCED` types)
+    #   allow you to trade off available download bandwidth and video quality,
+    #   to optimize the viewing experience. There are two presets:
+    #
+    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
+    #     quality level. Use it if you have low download bandwidth and/or
+    #     simple video content (e.g., talking heads)
+    #
+    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
+    #     level. Use it if you have high download bandwidth and/or complex
+    #     video content (e.g., flashes and quick scene changes).
     #
     # @return [Types::CreateChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -520,11 +561,12 @@ module Aws::IVS
     #     insecure_ingest: false,
     #     latency_mode: "NORMAL", # accepts NORMAL, LOW
     #     name: "ChannelName",
+    #     preset: "HIGHER_BANDWIDTH_DELIVERY", # accepts HIGHER_BANDWIDTH_DELIVERY, CONSTRAINED_BANDWIDTH_DELIVERY
     #     recording_configuration_arn: "ChannelRecordingConfigurationArn",
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
-    #     type: "BASIC", # accepts BASIC, STANDARD
+    #     type: "BASIC", # accepts BASIC, STANDARD, ADVANCED_SD, ADVANCED_HD
     #   })
     #
     # @example Response structure
@@ -536,10 +578,11 @@ module Aws::IVS
     #   resp.channel.latency_mode #=> String, one of "NORMAL", "LOW"
     #   resp.channel.name #=> String
     #   resp.channel.playback_url #=> String
+    #   resp.channel.preset #=> String, one of "HIGHER_BANDWIDTH_DELIVERY", "CONSTRAINED_BANDWIDTH_DELIVERY"
     #   resp.channel.recording_configuration_arn #=> String
     #   resp.channel.tags #=> Hash
     #   resp.channel.tags["TagKey"] #=> String
-    #   resp.channel.type #=> String, one of "BASIC", "STANDARD"
+    #   resp.channel.type #=> String, one of "BASIC", "STANDARD", "ADVANCED_SD", "ADVANCED_HD"
     #   resp.stream_key.arn #=> String
     #   resp.stream_key.channel_arn #=> String
     #   resp.stream_key.tags #=> Hash
@@ -833,10 +876,11 @@ module Aws::IVS
     #   resp.channel.latency_mode #=> String, one of "NORMAL", "LOW"
     #   resp.channel.name #=> String
     #   resp.channel.playback_url #=> String
+    #   resp.channel.preset #=> String, one of "HIGHER_BANDWIDTH_DELIVERY", "CONSTRAINED_BANDWIDTH_DELIVERY"
     #   resp.channel.recording_configuration_arn #=> String
     #   resp.channel.tags #=> Hash
     #   resp.channel.tags["TagKey"] #=> String
-    #   resp.channel.type #=> String, one of "BASIC", "STANDARD"
+    #   resp.channel.type #=> String, one of "BASIC", "STANDARD", "ADVANCED_SD", "ADVANCED_HD"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/GetChannel AWS API Documentation
     #
@@ -1020,10 +1064,11 @@ module Aws::IVS
     #   resp.stream_session.channel.latency_mode #=> String, one of "NORMAL", "LOW"
     #   resp.stream_session.channel.name #=> String
     #   resp.stream_session.channel.playback_url #=> String
+    #   resp.stream_session.channel.preset #=> String, one of "HIGHER_BANDWIDTH_DELIVERY", "CONSTRAINED_BANDWIDTH_DELIVERY"
     #   resp.stream_session.channel.recording_configuration_arn #=> String
     #   resp.stream_session.channel.tags #=> Hash
     #   resp.stream_session.channel.tags["TagKey"] #=> String
-    #   resp.stream_session.channel.type #=> String, one of "BASIC", "STANDARD"
+    #   resp.stream_session.channel.type #=> String, one of "BASIC", "STANDARD", "ADVANCED_SD", "ADVANCED_HD"
     #   resp.stream_session.end_time #=> Time
     #   resp.stream_session.ingest_configuration.audio.channels #=> Integer
     #   resp.stream_session.ingest_configuration.audio.codec #=> String
@@ -1165,9 +1210,11 @@ module Aws::IVS
     #   resp.channels[0].insecure_ingest #=> Boolean
     #   resp.channels[0].latency_mode #=> String, one of "NORMAL", "LOW"
     #   resp.channels[0].name #=> String
+    #   resp.channels[0].preset #=> String, one of "HIGHER_BANDWIDTH_DELIVERY", "CONSTRAINED_BANDWIDTH_DELIVERY"
     #   resp.channels[0].recording_configuration_arn #=> String
     #   resp.channels[0].tags #=> Hash
     #   resp.channels[0].tags["TagKey"] #=> String
+    #   resp.channels[0].type #=> String, one of "BASIC", "STANDARD", "ADVANCED_SD", "ADVANCED_HD"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListChannels AWS API Documentation
@@ -1582,9 +1629,9 @@ module Aws::IVS
       req.send_request(options)
     end
 
-    # Updates a channel's configuration. This does not affect an ongoing
-    # stream of this channel. You must stop and restart the stream for the
-    # changes to take effect.
+    # Updates a channel's configuration. Live channels cannot be updated.
+    # You must stop the ongoing stream, update the channel, and restart the
+    # stream for the changes to take effect.
     #
     # @option params [required, String] :arn
     #   ARN of the channel to be updated.
@@ -1604,6 +1651,13 @@ module Aws::IVS
     # @option params [String] :name
     #   Channel name.
     #
+    # @option params [String] :preset
+    #   Optional transcode preset for the channel. This is selectable only for
+    #   `ADVANCED_HD` and `ADVANCED_SD` channel types. For those channel
+    #   types, the default `preset` is `HIGHER_BANDWIDTH_DELIVERY`. For other
+    #   channel types (`BASIC` and `STANDARD`), `preset` is the empty string
+    #   (`""`).
+    #
     # @option params [String] :recording_configuration_arn
     #   Recording-configuration ARN. If this is set to an empty string,
     #   recording is disabled. A value other than an empty string indicates
@@ -1611,8 +1665,19 @@ module Aws::IVS
     #
     # @option params [String] :type
     #   Channel type, which determines the allowable resolution and bitrate.
-    #   *If you exceed the allowable resolution or bitrate, the stream
-    #   probably will disconnect immediately*. Valid values:
+    #   *If you exceed the allowable input resolution or bitrate, the stream
+    #   probably will disconnect immediately.* Some types generate multiple
+    #   qualities (renditions) from the original input; this automatically
+    #   gives viewers the best experience for their devices and network
+    #   conditions. Some types provide transcoded video; transcoding allows
+    #   higher playback quality across a range of download speeds. Default:
+    #   `STANDARD`. Valid values:
+    #
+    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original input
+    #     quality to viewers. The viewer’s video-quality choice is limited to
+    #     the original input. Input resolution can be up to 1080p and bitrate
+    #     can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
+    #     between 480p and 1080p. Original audio is passed through.
     #
     #   * `STANDARD`: Video is transcoded: multiple qualities are generated
     #     from the original input, to automatically give viewers the best
@@ -1620,13 +1685,36 @@ module Aws::IVS
     #     allows higher playback quality across a range of download speeds.
     #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
     #     Audio is transcoded only for renditions 360p and below; above that,
-    #     audio is passed through. This is the default.
+    #     audio is passed through. This is the default when you create a
+    #     channel.
     #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original input
-    #     to viewers. The viewer’s video-quality choice is limited to the
-    #     original input. Resolution can be up to 1080p and bitrate can be up
-    #     to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions between 480p
-    #     and 1080p.
+    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are generated
+    #     from the original input, to automatically give viewers the best
+    #     experience for their devices and network conditions. Input
+    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
+    #     output is capped at SD quality (480p). You can select an optional
+    #     transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are generated
+    #     from the original input, to automatically give viewers the best
+    #     experience for their devices and network conditions. Input
+    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
+    #     output is capped at HD quality (720p). You can select an optional
+    #     transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   Optional *transcode presets* (available for the `ADVANCED` types)
+    #   allow you to trade off available download bandwidth and video quality,
+    #   to optimize the viewing experience. There are two presets:
+    #
+    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
+    #     quality level. Use it if you have low download bandwidth and/or
+    #     simple video content (e.g., talking heads)
+    #
+    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
+    #     level. Use it if you have high download bandwidth and/or complex
+    #     video content (e.g., flashes and quick scene changes).
     #
     # @return [Types::UpdateChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1640,8 +1728,9 @@ module Aws::IVS
     #     insecure_ingest: false,
     #     latency_mode: "NORMAL", # accepts NORMAL, LOW
     #     name: "ChannelName",
+    #     preset: "HIGHER_BANDWIDTH_DELIVERY", # accepts HIGHER_BANDWIDTH_DELIVERY, CONSTRAINED_BANDWIDTH_DELIVERY
     #     recording_configuration_arn: "ChannelRecordingConfigurationArn",
-    #     type: "BASIC", # accepts BASIC, STANDARD
+    #     type: "BASIC", # accepts BASIC, STANDARD, ADVANCED_SD, ADVANCED_HD
     #   })
     #
     # @example Response structure
@@ -1653,10 +1742,11 @@ module Aws::IVS
     #   resp.channel.latency_mode #=> String, one of "NORMAL", "LOW"
     #   resp.channel.name #=> String
     #   resp.channel.playback_url #=> String
+    #   resp.channel.preset #=> String, one of "HIGHER_BANDWIDTH_DELIVERY", "CONSTRAINED_BANDWIDTH_DELIVERY"
     #   resp.channel.recording_configuration_arn #=> String
     #   resp.channel.tags #=> Hash
     #   resp.channel.tags["TagKey"] #=> String
-    #   resp.channel.type #=> String, one of "BASIC", "STANDARD"
+    #   resp.channel.type #=> String, one of "BASIC", "STANDARD", "ADVANCED_SD", "ADVANCED_HD"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/UpdateChannel AWS API Documentation
     #
@@ -1680,7 +1770,7 @@ module Aws::IVS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ivs'
-      context[:gem_version] = '1.30.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-ivs/client_api.rb

@@ -145,6 +145,7 @@ module Aws::IVS
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     ThumbnailConfiguration = Shapes::StructureShape.new(name: 'ThumbnailConfiguration')
     Time = Shapes::TimestampShape.new(name: 'Time', timestampFormat: "iso8601")
+    TranscodePreset = Shapes::StringShape.new(name: 'TranscodePreset')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateChannelRequest = Shapes::StructureShape.new(name: 'UpdateChannelRequest')
@@ -191,6 +192,7 @@ module Aws::IVS
     Channel.add_member(:latency_mode, Shapes::ShapeRef.new(shape: ChannelLatencyMode, location_name: "latencyMode"))
     Channel.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "name"))
     Channel.add_member(:playback_url, Shapes::ShapeRef.new(shape: PlaybackURL, location_name: "playbackUrl"))
+    Channel.add_member(:preset, Shapes::ShapeRef.new(shape: TranscodePreset, location_name: "preset"))
     Channel.add_member(:recording_configuration_arn, Shapes::ShapeRef.new(shape: ChannelRecordingConfigurationArn, location_name: "recordingConfigurationArn"))
     Channel.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     Channel.add_member(:type, Shapes::ShapeRef.new(shape: ChannelType, location_name: "type"))
@@ -208,8 +210,10 @@ module Aws::IVS
     ChannelSummary.add_member(:insecure_ingest, Shapes::ShapeRef.new(shape: InsecureIngest, location_name: "insecureIngest"))
     ChannelSummary.add_member(:latency_mode, Shapes::ShapeRef.new(shape: ChannelLatencyMode, location_name: "latencyMode"))
     ChannelSummary.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "name"))
+    ChannelSummary.add_member(:preset, Shapes::ShapeRef.new(shape: TranscodePreset, location_name: "preset"))
     ChannelSummary.add_member(:recording_configuration_arn, Shapes::ShapeRef.new(shape: ChannelRecordingConfigurationArn, location_name: "recordingConfigurationArn"))
     ChannelSummary.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
+    ChannelSummary.add_member(:type, Shapes::ShapeRef.new(shape: ChannelType, location_name: "type"))
     ChannelSummary.struct_class = Types::ChannelSummary
 
     Channels.member = Shapes::ShapeRef.new(shape: Channel)
@@ -221,6 +225,7 @@ module Aws::IVS
     CreateChannelRequest.add_member(:insecure_ingest, Shapes::ShapeRef.new(shape: Boolean, location_name: "insecureIngest"))
     CreateChannelRequest.add_member(:latency_mode, Shapes::ShapeRef.new(shape: ChannelLatencyMode, location_name: "latencyMode"))
     CreateChannelRequest.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "name"))
+    CreateChannelRequest.add_member(:preset, Shapes::ShapeRef.new(shape: TranscodePreset, location_name: "preset"))
     CreateChannelRequest.add_member(:recording_configuration_arn, Shapes::ShapeRef.new(shape: ChannelRecordingConfigurationArn, location_name: "recordingConfigurationArn"))
     CreateChannelRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     CreateChannelRequest.add_member(:type, Shapes::ShapeRef.new(shape: ChannelType, location_name: "type"))
@@ -522,6 +527,7 @@ module Aws::IVS
     UpdateChannelRequest.add_member(:insecure_ingest, Shapes::ShapeRef.new(shape: Boolean, location_name: "insecureIngest"))
     UpdateChannelRequest.add_member(:latency_mode, Shapes::ShapeRef.new(shape: ChannelLatencyMode, location_name: "latencyMode"))
     UpdateChannelRequest.add_member(:name, Shapes::ShapeRef.new(shape: ChannelName, location_name: "name"))
+    UpdateChannelRequest.add_member(:preset, Shapes::ShapeRef.new(shape: TranscodePreset, location_name: "preset"))
     UpdateChannelRequest.add_member(:recording_configuration_arn, Shapes::ShapeRef.new(shape: ChannelRecordingConfigurationArn, location_name: "recordingConfigurationArn"))
     UpdateChannelRequest.add_member(:type, Shapes::ShapeRef.new(shape: ChannelType, location_name: "type"))
     UpdateChannelRequest.struct_class = Types::UpdateChannelRequest

data/lib/aws-sdk-ivs/types.rb

@@ -168,6 +168,14 @@ module Aws::IVS
     #   Channel playback URL.
     #   @return [String]
     #
+    # @!attribute [rw] preset
+    #   Optional transcode preset for the channel. This is selectable only
+    #   for `ADVANCED_HD` and `ADVANCED_SD` channel types. For those channel
+    #   types, the default `preset` is `HIGHER_BANDWIDTH_DELIVERY`. For
+    #   other channel types (`BASIC` and `STANDARD`), `preset` is the empty
+    #   string (`""`).
+    #   @return [String]
+    #
     # @!attribute [rw] recording_configuration_arn
     #   Recording-configuration ARN. A value other than an empty string
     #   indicates that recording is enabled. Default: "" (empty string,
@@ -188,9 +196,20 @@ module Aws::IVS
     #
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
-    #   *If you exceed the allowable resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Default: `STANDARD`. Valid
-    #   values:
+    #   *If you exceed the allowable input resolution or bitrate, the stream
+    #   probably will disconnect immediately.* Some types generate multiple
+    #   qualities (renditions) from the original input; this automatically
+    #   gives viewers the best experience for their devices and network
+    #   conditions. Some types provide transcoded video; transcoding allows
+    #   higher playback quality across a range of download speeds. Default:
+    #   `STANDARD`. Valid values:
+    #
+    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
+    #     input quality to viewers. The viewer’s video-quality choice is
+    #     limited to the original input. Input resolution can be up to 1080p
+    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
+    #     resolutions between 480p and 1080p. Original audio is passed
+    #     through.
     #
     #   * `STANDARD`: Video is transcoded: multiple qualities are generated
     #     from the original input, to automatically give viewers the best
@@ -198,13 +217,36 @@ module Aws::IVS
     #     allows higher playback quality across a range of download speeds.
     #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
     #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default.
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input to viewers. The viewer’s video-quality choice is limited to
-    #     the original input. Resolution can be up to 1080p and bitrate can
-    #     be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
-    #     between 480p and 1080p.
+    #     that, audio is passed through. This is the default when you create
+    #     a channel.
+    #
+    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at SD quality (480p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at HD quality (720p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   Optional *transcode presets* (available for the `ADVANCED` types)
+    #   allow you to trade off available download bandwidth and video
+    #   quality, to optimize the viewing experience. There are two presets:
+    #
+    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
+    #     quality level. Use it if you have low download bandwidth and/or
+    #     simple video content (e.g., talking heads)
+    #
+    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
+    #     level. Use it if you have high download bandwidth and/or complex
+    #     video content (e.g., flashes and quick scene changes).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/Channel AWS API Documentation
@@ -217,6 +259,7 @@ module Aws::IVS
       :latency_mode,
       :name,
       :playback_url,
+      :preset,
       :recording_configuration_arn,
       :tags,
       :type)
@@ -262,6 +305,14 @@ module Aws::IVS
     #   Channel name.
     #   @return [String]
     #
+    # @!attribute [rw] preset
+    #   Optional transcode preset for the channel. This is selectable only
+    #   for `ADVANCED_HD` and `ADVANCED_SD` channel types. For those channel
+    #   types, the default `preset` is `HIGHER_BANDWIDTH_DELIVERY`. For
+    #   other channel types (`BASIC` and `STANDARD`), `preset` is the empty
+    #   string (`""`).
+    #   @return [String]
+    #
     # @!attribute [rw] recording_configuration_arn
     #   Recording-configuration ARN. A value other than an empty string
     #   indicates that recording is enabled. Default: "" (empty string,
@@ -280,6 +331,61 @@ module Aws::IVS
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] type
+    #   Channel type, which determines the allowable resolution and bitrate.
+    #   *If you exceed the allowable input resolution or bitrate, the stream
+    #   probably will disconnect immediately.* Some types generate multiple
+    #   qualities (renditions) from the original input; this automatically
+    #   gives viewers the best experience for their devices and network
+    #   conditions. Some types provide transcoded video; transcoding allows
+    #   higher playback quality across a range of download speeds. Default:
+    #   `STANDARD`. Valid values:
+    #
+    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
+    #     input quality to viewers. The viewer’s video-quality choice is
+    #     limited to the original input. Input resolution can be up to 1080p
+    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
+    #     resolutions between 480p and 1080p. Original audio is passed
+    #     through.
+    #
+    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
+    #     from the original input, to automatically give viewers the best
+    #     experience for their devices and network conditions. Transcoding
+    #     allows higher playback quality across a range of download speeds.
+    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
+    #     Audio is transcoded only for renditions 360p and below; above
+    #     that, audio is passed through. This is the default when you create
+    #     a channel.
+    #
+    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at SD quality (480p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at HD quality (720p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   Optional *transcode presets* (available for the `ADVANCED` types)
+    #   allow you to trade off available download bandwidth and video
+    #   quality, to optimize the viewing experience. There are two presets:
+    #
+    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
+    #     quality level. Use it if you have low download bandwidth and/or
+    #     simple video content (e.g., talking heads)
+    #
+    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
+    #     level. Use it if you have high download bandwidth and/or complex
+    #     video content (e.g., flashes and quick scene changes).
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ChannelSummary AWS API Documentation
     #
     class ChannelSummary < Struct.new(
@@ -288,8 +394,10 @@ module Aws::IVS
       :insecure_ingest,
       :latency_mode,
       :name,
+      :preset,
       :recording_configuration_arn,
-      :tags)
+      :tags,
+      :type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -326,6 +434,14 @@ module Aws::IVS
     #   Channel name.
     #   @return [String]
     #
+    # @!attribute [rw] preset
+    #   Optional transcode preset for the channel. This is selectable only
+    #   for `ADVANCED_HD` and `ADVANCED_SD` channel types. For those channel
+    #   types, the default `preset` is `HIGHER_BANDWIDTH_DELIVERY`. For
+    #   other channel types (`BASIC` and `STANDARD`), `preset` is the empty
+    #   string (`""`).
+    #   @return [String]
+    #
     # @!attribute [rw] recording_configuration_arn
     #   Recording-configuration ARN. Default: "" (empty string, recording
     #   is disabled).
@@ -345,9 +461,20 @@ module Aws::IVS
     #
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
-    #   *If you exceed the allowable resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Default: `STANDARD`. Valid
-    #   values:
+    #   *If you exceed the allowable input resolution or bitrate, the stream
+    #   probably will disconnect immediately.* Some types generate multiple
+    #   qualities (renditions) from the original input; this automatically
+    #   gives viewers the best experience for their devices and network
+    #   conditions. Some types provide transcoded video; transcoding allows
+    #   higher playback quality across a range of download speeds. Default:
+    #   `STANDARD`. Valid values:
+    #
+    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
+    #     input quality to viewers. The viewer’s video-quality choice is
+    #     limited to the original input. Input resolution can be up to 1080p
+    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
+    #     resolutions between 480p and 1080p. Original audio is passed
+    #     through.
     #
     #   * `STANDARD`: Video is transcoded: multiple qualities are generated
     #     from the original input, to automatically give viewers the best
@@ -355,13 +482,36 @@ module Aws::IVS
     #     allows higher playback quality across a range of download speeds.
     #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
     #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default.
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input to viewers. The viewer’s video-quality choice is limited to
-    #     the original input. Resolution can be up to 1080p and bitrate can
-    #     be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
-    #     between 480p and 1080p.
+    #     that, audio is passed through. This is the default when you create
+    #     a channel.
+    #
+    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at SD quality (480p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at HD quality (720p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   Optional *transcode presets* (available for the `ADVANCED` types)
+    #   allow you to trade off available download bandwidth and video
+    #   quality, to optimize the viewing experience. There are two presets:
+    #
+    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
+    #     quality level. Use it if you have low download bandwidth and/or
+    #     simple video content (e.g., talking heads)
+    #
+    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
+    #     level. Use it if you have high download bandwidth and/or complex
+    #     video content (e.g., flashes and quick scene changes).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/CreateChannelRequest AWS API Documentation
@@ -371,6 +521,7 @@ module Aws::IVS
       :insecure_ingest,
       :latency_mode,
       :name,
+      :preset,
       :recording_configuration_arn,
       :tags,
       :type)
@@ -1759,6 +1910,14 @@ module Aws::IVS
     #   Channel name.
     #   @return [String]
     #
+    # @!attribute [rw] preset
+    #   Optional transcode preset for the channel. This is selectable only
+    #   for `ADVANCED_HD` and `ADVANCED_SD` channel types. For those channel
+    #   types, the default `preset` is `HIGHER_BANDWIDTH_DELIVERY`. For
+    #   other channel types (`BASIC` and `STANDARD`), `preset` is the empty
+    #   string (`""`).
+    #   @return [String]
+    #
     # @!attribute [rw] recording_configuration_arn
     #   Recording-configuration ARN. If this is set to an empty string,
     #   recording is disabled. A value other than an empty string indicates
@@ -1767,8 +1926,20 @@ module Aws::IVS
     #
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
-    #   *If you exceed the allowable resolution or bitrate, the stream
-    #   probably will disconnect immediately*. Valid values:
+    #   *If you exceed the allowable input resolution or bitrate, the stream
+    #   probably will disconnect immediately.* Some types generate multiple
+    #   qualities (renditions) from the original input; this automatically
+    #   gives viewers the best experience for their devices and network
+    #   conditions. Some types provide transcoded video; transcoding allows
+    #   higher playback quality across a range of download speeds. Default:
+    #   `STANDARD`. Valid values:
+    #
+    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
+    #     input quality to viewers. The viewer’s video-quality choice is
+    #     limited to the original input. Input resolution can be up to 1080p
+    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
+    #     resolutions between 480p and 1080p. Original audio is passed
+    #     through.
     #
     #   * `STANDARD`: Video is transcoded: multiple qualities are generated
     #     from the original input, to automatically give viewers the best
@@ -1776,13 +1947,36 @@ module Aws::IVS
     #     allows higher playback quality across a range of download speeds.
     #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
     #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default.
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input to viewers. The viewer’s video-quality choice is limited to
-    #     the original input. Resolution can be up to 1080p and bitrate can
-    #     be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
-    #     between 480p and 1080p.
+    #     that, audio is passed through. This is the default when you create
+    #     a channel.
+    #
+    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at SD quality (480p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
+    #     generated from the original input, to automatically give viewers
+    #     the best experience for their devices and network conditions.
+    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
+    #     Mbps; output is capped at HD quality (720p). You can select an
+    #     optional transcode preset (see below). Audio for all renditions is
+    #     transcoded, and an audio-only rendition is available.
+    #
+    #   Optional *transcode presets* (available for the `ADVANCED` types)
+    #   allow you to trade off available download bandwidth and video
+    #   quality, to optimize the viewing experience. There are two presets:
+    #
+    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
+    #     quality level. Use it if you have low download bandwidth and/or
+    #     simple video content (e.g., talking heads)
+    #
+    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
+    #     level. Use it if you have high download bandwidth and/or complex
+    #     video content (e.g., flashes and quick scene changes).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/UpdateChannelRequest AWS API Documentation
@@ -1793,6 +1987,7 @@ module Aws::IVS
       :insecure_ingest,
       :latency_mode,
       :name,
+      :preset,
       :recording_configuration_arn,
       :type)
       SENSITIVE = []

data/lib/aws-sdk-ivs.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-ivs/customizations'
 # @!group service
 module Aws::IVS
 
-  GEM_VERSION = '1.30.0'
+  GEM_VERSION = '1.31.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivs
 version: !ruby/object:Gem::Version
-  version: 1.30.0
+  version: 1.31.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-31 00:00:00.000000000 Z
+date: 2023-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core