aws-sdk-mediaconvert 1.171.0 → 1.173.0

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

@@ -546,6 +546,10 @@ module Aws::MediaConvert
     #   you need to comply with a loudness standard.
     #   @return [Types::AudioNormalizationSettings]
     #
+    # @!attribute [rw] audio_pitch_correction_settings
+    #   Settings for audio pitch correction during framerate conversion.
+    #   @return [Types::AudioPitchCorrectionSettings]
+    #
     # @!attribute [rw] audio_source_name
     #   Specifies which audio data to use from each input. In the simplest
     #   case, specify an "Audio Selector":#inputs-audio\_selector by name
@@ -635,6 +639,7 @@ module Aws::MediaConvert
     class AudioDescription < Struct.new(
       :audio_channel_tagging_settings,
       :audio_normalization_settings,
+      :audio_pitch_correction_settings,
       :audio_source_name,
       :audio_type,
       :audio_type_control,
@@ -715,6 +720,26 @@ module Aws::MediaConvert
       include Aws::Structure
     end
 
+    # Settings for audio pitch correction during framerate conversion.
+    #
+    # @!attribute [rw] slow_pal_pitch_correction
+    #   Use Slow PAL pitch correction to compensate for audio pitch changes
+    #   during slow PAL frame rate conversion. This setting only applies
+    #   when Slow PAL is enabled in your output video codec settings. To
+    #   automatically apply audio pitch correction: Choose Enabled.
+    #   MediaConvert automatically applies a pitch correction to your output
+    #   to match the original content's audio pitch. To not apply audio
+    #   pitch correction: Keep the default value, Disabled.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/AudioPitchCorrectionSettings AWS API Documentation
+    #
+    class AudioPitchCorrectionSettings < Struct.new(
+      :slow_pal_pitch_correction)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Details about the media file's audio track.
     #
     # @!attribute [rw] bit_depth
@@ -854,7 +879,9 @@ module Aws::MediaConvert
     #   Identifier (PID) values for MPEG Transport Stream inputs. Use this
     #   when you know the exact PID values of your audio streams. Track:
     #   Default. Select audio by track number. This is the most common
-    #   option and works with most input container formats. Language code:
+    #   option and works with most input container formats. If more types of
+    #   audio data get recognized in the future, these numberings may shift,
+    #   but the numberings used for Stream mode will not. Language code:
     #   Select audio by language using an ISO 639-2 or ISO 639-3
     #   three-letter code in all capital letters. Use this when your source
     #   has embedded language metadata and you want to select tracks based
@@ -863,15 +890,37 @@ module Aws::MediaConvert
     #   multiple audio renditions and you want to select specific rendition
     #   groups. All PCM: Select all uncompressed PCM audio tracks from your
     #   input automatically. This is useful when you want to include all PCM
-    #   audio tracks without specifying individual track numbers.
+    #   audio tracks without specifying individual track numbers. Stream:
+    #   Select audio by stream number. Stream numbers include all tracks in
+    #   the source file, regardless of type, and correspond to either the
+    #   order of tracks in the file, or if applicable, the stream number
+    #   metadata of the track. Although all tracks count toward these stream
+    #   numbers, in this audio selector context, only the stream number of a
+    #   track containing audio data may be used. If your source file
+    #   contains a track which is not recognized by the service, then the
+    #   corresponding stream number will still be reserved for future use.
+    #   If more types of audio data get recognized in the future, these
+    #   numberings will not shift.
     #   @return [String]
     #
+    # @!attribute [rw] streams
+    #   Identify a track from the input audio to include in this selector by
+    #   entering the stream index number. These numberings count all tracks
+    #   in the input file, but only a track containing audio data may be
+    #   used here. To include several tracks in a single audio selector,
+    #   specify multiple tracks as follows. Using the console, enter a
+    #   comma-separated list. For example, type "1,2,3" to include tracks
+    #   1 through 3.
+    #   @return [Array<Integer>]
+    #
     # @!attribute [rw] tracks
     #   Identify a track from the input audio to include in this selector by
-    #   entering the track index number. To include several tracks in a
-    #   single audio selector, specify multiple tracks as follows. Using the
-    #   console, enter a comma-separated list. For example, type "1,2,3"
-    #   to include tracks 1 through 3.
+    #   entering the track index number. These numberings include only
+    #   tracks recognized as audio. If the service recognizes more types of
+    #   audio tracks in the future, these numberings may shift. To include
+    #   several tracks in a single audio selector, specify multiple tracks
+    #   as follows. Using the console, enter a comma-separated list. For
+    #   example, type "1,2,3" to include tracks 1 through 3.
     #   @return [Array<Integer>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/AudioSelector AWS API Documentation
@@ -888,6 +937,7 @@ module Aws::MediaConvert
       :program_selection,
       :remix_settings,
       :selector_type,
+      :streams,
       :tracks)
       SENSITIVE = []
       include Aws::Structure
@@ -2376,13 +2426,16 @@ module Aws::MediaConvert
     #
     # @!attribute [rw] dash_manifest_style
     #   Specify how MediaConvert writes SegmentTimeline in your output DASH
-    #   manifest. To write a SegmentTimeline in each video Representation:
-    #   Keep the default value, Basic. To write a common SegmentTimeline in
-    #   the video AdaptationSet: Choose Compact. Note that MediaConvert will
-    #   still write a SegmentTimeline in any Representation that does not
-    #   share a common timeline. To write a video AdaptationSet for each
-    #   different output framerate, and a common SegmentTimeline in each
-    #   AdaptationSet: Choose Distinct.
+    #   manifest. To write a SegmentTimeline for outputs that you also
+    #   specify a Name modifier for: Keep the default value, Basic. Note
+    #   that if you do not specify a name modifier for an output,
+    #   MediaConvert will not write a SegmentTimeline for it. To write a
+    #   common SegmentTimeline in the video AdaptationSet: Choose Compact.
+    #   Note that MediaConvert will still write a SegmentTimeline in any
+    #   Representation that does not share a common timeline. To write a
+    #   video AdaptationSet for each different output framerate, and a
+    #   common SegmentTimeline in each AdaptationSet: Choose Distinct. To
+    #   write a SegmentTimeline in each AdaptationSet: Choose Full.
     #   @return [String]
     #
     # @!attribute [rw] destination
@@ -2749,6 +2802,23 @@ module Aws::MediaConvert
     #   output group, you must explicitly choose a value for this setting.
     #   @return [String]
     #
+    # @!attribute [rw] c2pa_manifest
+    #   When enabled, a C2PA compliant manifest will be generated, signed
+    #   and embeded in the output. For more information on C2PA, see
+    #   https://c2pa.org/specifications/specifications/2.1/index.html
+    #   @return [String]
+    #
+    # @!attribute [rw] certificate_secret
+    #   Specify the name or ARN of the AWS Secrets Manager secret that
+    #   contains your C2PA public certificate chain in PEM format. Provide a
+    #   valid secret name or ARN. Note that your MediaConvert service role
+    #   must allow access to this secret. The public certificate chain is
+    #   added to the COSE header (x5chain) for signature validation. Include
+    #   the signer's certificate and all intermediate certificates. Do not
+    #   include the root certificate. For details on COSE, see:
+    #   https://opensource.contentauthenticity.org/docs/manifest/signing-manifests
+    #   @return [String]
+    #
     # @!attribute [rw] descriptive_video_service_flag
     #   Specify whether to flag this audio track as descriptive video
     #   service (DVS) in your HLS parent manifest. When you choose Flag,
@@ -2806,6 +2876,12 @@ module Aws::MediaConvert
     #   you don't want those SCTE-35 markers in this output.
     #   @return [String]
     #
+    # @!attribute [rw] signing_kms_key
+    #   Specify the ID or ARN of the AWS KMS key used to sign the C2PA
+    #   manifest in your MP4 output. Provide a valid KMS key ARN. Note that
+    #   your MediaConvert service role must allow access to this key.
+    #   @return [String]
+    #
     # @!attribute [rw] timed_metadata
     #   To include ID3 metadata in this output: Set ID3 metadata to
     #   Passthrough. Specify this ID3 metadata in Custom ID3 metadata
@@ -2845,12 +2921,15 @@ module Aws::MediaConvert
       :audio_group_id,
       :audio_rendition_sets,
       :audio_track_type,
+      :c2pa_manifest,
+      :certificate_secret,
       :descriptive_video_service_flag,
       :i_frame_only_manifest,
       :klv_metadata,
       :manifest_metadata_signaling,
       :scte_35_esam,
       :scte_35_source,
+      :signing_kms_key,
       :timed_metadata,
       :timed_metadata_box_version,
       :timed_metadata_scheme_id_uri,
@@ -3730,13 +3809,16 @@ module Aws::MediaConvert
     #
     # @!attribute [rw] dash_manifest_style
     #   Specify how MediaConvert writes SegmentTimeline in your output DASH
-    #   manifest. To write a SegmentTimeline in each video Representation:
-    #   Keep the default value, Basic. To write a common SegmentTimeline in
-    #   the video AdaptationSet: Choose Compact. Note that MediaConvert will
-    #   still write a SegmentTimeline in any Representation that does not
-    #   share a common timeline. To write a video AdaptationSet for each
-    #   different output framerate, and a common SegmentTimeline in each
-    #   AdaptationSet: Choose Distinct.
+    #   manifest. To write a SegmentTimeline for outputs that you also
+    #   specify a Name modifier for: Keep the default value, Basic. Note
+    #   that if you do not specify a name modifier for an output,
+    #   MediaConvert will not write a SegmentTimeline for it. To write a
+    #   common SegmentTimeline in the video AdaptationSet: Choose Compact.
+    #   Note that MediaConvert will still write a SegmentTimeline in any
+    #   Representation that does not share a common timeline. To write a
+    #   video AdaptationSet for each different output framerate, and a
+    #   common SegmentTimeline in each AdaptationSet: Choose Distinct. To
+    #   write a SegmentTimeline in each AdaptationSet: Choose Full.
     #   @return [String]
     #
     # @!attribute [rw] destination
@@ -8584,7 +8666,7 @@ module Aws::MediaConvert
     #
     # @!attribute [rw] duration
     #   Specify the duration, in milliseconds, for your video generator
-    #   input. Enter an integer from 50 to 86400000.
+    #   input. Enter an integer from 1 to 86400000.
     #   @return [Integer]
     #
     # @!attribute [rw] framerate_denominator
@@ -10877,14 +10959,31 @@ module Aws::MediaConvert
     #   output audio codec.
     #   @return [String]
     #
+    # @!attribute [rw] c2pa_manifest
+    #   When enabled, a C2PA compliant manifest will be generated, signed
+    #   and embeded in the output. For more information on C2PA, see
+    #   https://c2pa.org/specifications/specifications/2.1/index.html
+    #   @return [String]
+    #
     # @!attribute [rw] caption_container_type
     #   Use this setting only in DASH output groups that include sidecar
-    #   TTML or IMSC captions. You specify sidecar captions in a separate
-    #   output from your audio and video. Choose Raw for captions in a
-    #   single XML file in a raw container. Choose Fragmented MPEG-4 for
-    #   captions in XML format contained within fragmented MP4 files. This
-    #   set of fragmented MP4 files is separate from your video and audio
-    #   fragmented MP4 files.
+    #   TTML, IMSC or WEBVTT captions. You specify sidecar captions in a
+    #   separate output from your audio and video. Choose Raw for captions
+    #   in a single XML file in a raw container. Choose Fragmented MPEG-4
+    #   for captions in XML format contained within fragmented MP4 files.
+    #   This set of fragmented MP4 files is separate from your video and
+    #   audio fragmented MP4 files.
+    #   @return [String]
+    #
+    # @!attribute [rw] certificate_secret
+    #   Specify the name or ARN of the AWS Secrets Manager secret that
+    #   contains your C2PA public certificate chain in PEM format. Provide a
+    #   valid secret name or ARN. Note that your MediaConvert service role
+    #   must allow access to this secret. The public certificate chain is
+    #   added to the COSE header (x5chain) for signature validation. Include
+    #   the signer's certificate and all intermediate certificates. Do not
+    #   include the root certificate. For details on COSE, see:
+    #   https://opensource.contentauthenticity.org/docs/manifest/signing-manifests
     #   @return [String]
     #
     # @!attribute [rw] klv_metadata
@@ -10923,6 +11022,12 @@ module Aws::MediaConvert
     #   you don't want those SCTE-35 markers in this output.
     #   @return [String]
     #
+    # @!attribute [rw] signing_kms_key
+    #   Specify the ID or ARN of the AWS KMS key used to sign the C2PA
+    #   manifest in your MP4 output. Provide a valid KMS key ARN. Note that
+    #   your MediaConvert service role must allow access to this key.
+    #   @return [String]
+    #
     # @!attribute [rw] timed_metadata
     #   To include ID3 metadata in this output: Set ID3 metadata to
     #   Passthrough. Specify this ID3 metadata in Custom ID3 metadata
@@ -10960,11 +11065,14 @@ module Aws::MediaConvert
     class MpdSettings < Struct.new(
       :accessibility_caption_hints,
       :audio_duration,
+      :c2pa_manifest,
       :caption_container_type,
+      :certificate_secret,
       :klv_metadata,
       :manifest_metadata_signaling,
       :scte_35_esam,
       :scte_35_source,
+      :signing_kms_key,
       :timed_metadata,
       :timed_metadata_box_version,
       :timed_metadata_scheme_id_uri,
@@ -12183,6 +12291,41 @@ module Aws::MediaConvert
       include Aws::Structure
     end
 
+    # Optional settings when you set Codec to the value Passthrough.
+    #
+    # @!attribute [rw] frame_control
+    #   Choose how MediaConvert handles start and end times for input
+    #   clipping with video passthrough. Your input video codec must be
+    #   H.264 or H.265 to use IFRAME. To clip at the nearest IDR-frame:
+    #   Choose Nearest IDR. If an IDR-frame is not found at the frame that
+    #   you specify, MediaConvert uses the next compatible IDR-frame. Note
+    #   that your output may be shorter than your input clip duration. To
+    #   clip at the nearest I-frame: Choose Nearest I-frame. If an I-frame
+    #   is not found at the frame that you specify, MediaConvert uses the
+    #   next compatible I-frame. Note that your output may be shorter than
+    #   your input clip duration. We only recommend this setting for special
+    #   workflows, and when you choose this setting your output may not be
+    #   compatible with most players.
+    #   @return [String]
+    #
+    # @!attribute [rw] video_selector_mode
+    #   AUTO will select the highest bitrate input in the video selector
+    #   source. REMUX\_ALL will passthrough all the selected streams in the
+    #   video selector source. When selecting streams from multiple
+    #   renditions (i.e. using Stream video selector type): REMUX\_ALL will
+    #   only remux all streams selected, and AUTO will use the highest
+    #   bitrate video stream among the selected streams as source.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/PassthroughSettings AWS API Documentation
+    #
+    class PassthroughSettings < Struct.new(
+      :frame_control,
+      :video_selector_mode)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A policy configures behavior that you allow or disallow for your
     # account. For information about MediaConvert policies, see the user
     # guide at
@@ -13669,6 +13812,21 @@ module Aws::MediaConvert
     # your caption source is IMSC 1.1 in a separate xml file, use
     # FileSourceSettings instead of TrackSourceSettings.
     #
+    # @!attribute [rw] stream_number
+    #   Use this setting to select a single captions track from a source.
+    #   Stream numbers include all tracks in the source file, regardless of
+    #   type, and correspond to either the order of tracks in the file, or
+    #   if applicable, the stream number metadata of the track. Although all
+    #   tracks count toward these stream numbers, in this caption selector
+    #   context, only the stream number of a track containing caption data
+    #   may be used. To include more than one captions track in your job
+    #   outputs, create multiple input captions selectors. Specify one
+    #   stream per selector. If your source file contains a track which is
+    #   not recognized by the service, then the corresponding stream number
+    #   will still be reserved for future use. If more types of caption data
+    #   get recognized in the future, these numberings will not shift.
+    #   @return [Integer]
+    #
     # @!attribute [rw] track_number
     #   Use this setting to select a single captions track from a source.
     #   Track numbers correspond to the order in the captions source file.
@@ -13676,12 +13834,15 @@ module Aws::MediaConvert
     #   captions appear in the CPL. For example, use 1 to select the
     #   captions asset that is listed first in the CPL. To include more than
     #   one captions track in your job outputs, create multiple input
-    #   captions selectors. Specify one track per selector.
+    #   captions selectors. Specify one track per selector. If more types of
+    #   caption data get recognized in the future, these numberings may
+    #   shift, but the numberings used for streamNumber will not.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/TrackSourceSettings AWS API Documentation
     #
     class TrackSourceSettings < Struct.new(
+      :stream_number,
       :track_number)
       SENSITIVE = []
       include Aws::Structure
@@ -14221,6 +14382,10 @@ module Aws::MediaConvert
     #   Required when you set Codec to the value MPEG2.
     #   @return [Types::Mpeg2Settings]
     #
+    # @!attribute [rw] passthrough_settings
+    #   Optional settings when you set Codec to the value Passthrough.
+    #   @return [Types::PassthroughSettings]
+    #
     # @!attribute [rw] prores_settings
     #   Required when you set Codec to the value PRORES.
     #   @return [Types::ProresSettings]
@@ -14257,6 +14422,7 @@ module Aws::MediaConvert
       :h264_settings,
       :h265_settings,
       :mpeg_2_settings,
+      :passthrough_settings,
       :prores_settings,
       :uncompressed_settings,
       :vc_3_settings,
@@ -14692,6 +14858,12 @@ module Aws::MediaConvert
     #   enter a value for Height and leave Width blank.
     #   @return [Integer]
     #
+    # @!attribute [rw] opacity
+    #   Use Opacity to specify how much of the underlying video shows
+    #   through the overlay video. 0 is transparent and 100 is fully opaque.
+    #   Default is 100.
+    #   @return [Integer]
+    #
     # @!attribute [rw] unit
     #   Specify the Unit type to use when you enter a value for X position,
     #   Y position, Width, or Height. You can choose Pixels or Percentage.
@@ -14742,6 +14914,7 @@ module Aws::MediaConvert
     #
     class VideoOverlayPosition < Struct.new(
       :height,
+      :opacity,
       :unit,
       :width,
       :x_position,
@@ -14754,7 +14927,7 @@ module Aws::MediaConvert
     # Transitions to reposition or resize your overlay over time. To use the
     # same position and size for the duration of your video overlay: Leave
     # blank. To specify a Transition: Enter a value for Start timecode, End
-    # Timecode, X Position, Y Position, Width, or Height.
+    # Timecode, X Position, Y Position, Width, Height, or Opacity
     #
     # @!attribute [rw] end_position
     #   Specify the ending position for this transition, relative to the
@@ -15062,8 +15235,14 @@ module Aws::MediaConvert
     #   @return [String]
     #
     # @!attribute [rw] streams
-    #   Specify a stream for MediaConvert to use from your HLS input. Enter
-    #   an integer corresponding to the stream order in your HLS manifest.
+    #   Specify one or more video streams for MediaConvert to use from your
+    #   HLS input. Enter an integer corresponding to the stream number, with
+    #   the first stream in your HLS multivariant playlist starting at 1.For
+    #   re-encoding workflows, MediaConvert uses the video stream that you
+    #   select with the highest bitrate as the input.For video passthrough
+    #   workflows, you specify whether to passthrough a single video stream
+    #   or multiple video streams under Video selector source in the output
+    #   video encoding settings.
     #   @return [Array<Integer>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/VideoSelector AWS API Documentation

data/lib/aws-sdk-mediaconvert.rb

@@ -54,7 +54,7 @@ module Aws::MediaConvert
   autoload :EndpointProvider, 'aws-sdk-mediaconvert/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-mediaconvert/endpoints'
 
-  GEM_VERSION = '1.171.0'
+  GEM_VERSION = '1.173.0'
 
 end