Class: Aws::MediaConvert::Types::AudioSelector

Inherits:

Struct

• Object
• Struct
• Aws::MediaConvert::Types::AudioSelector

Includes:

Structure

Defined in:

lib/aws-sdk-mediaconvert/types.rb

Overview

Use Audio selectors to specify a track or set of tracks from the input that you will use in your outputs. You can use multiple Audio selectors per input.

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #audio_duration_correction ⇒ String

  Apply audio timing corrections to help synchronize audio and video in your output.

• #custom_language_code ⇒ String

  Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code.

• #default_selection ⇒ String

  Enable this setting on one audio selector to set it as the default for the job.

• #external_audio_file_input ⇒ String

  Specify the S3, HTTP, or HTTPS URL for your external audio file input.

• #hls_rendition_group_settings ⇒ Types::HlsRenditionGroupSettings

  Settings specific to audio sources in an HLS alternate rendition group.

• #language_code ⇒ String

  Specify the language to select from your audio input.

• #offset ⇒ Integer

  Specify a time delta, in milliseconds, to offset the audio from the input video.

• #pids ⇒ Array<Integer>

  Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).

• #program_selection ⇒ Integer

  Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track.

• #remix_settings ⇒ Types::RemixSettings

  Use these settings to reorder the audio channels of one input to match those of another input.

• #selector_type ⇒ String

  Specify how MediaConvert selects audio content within your input.

• #tracks ⇒ Array<Integer>

  Identify a track from the input audio to include in this selector by entering the track index number.

Instance Attribute Details

#audio_duration_correction ⇒ String

Apply audio timing corrections to help synchronize audio and video in your output. To apply timing corrections, your input must meet the following requirements: * Container: MP4, or MOV, with an accurate time-to-sample (STTS) table. * Audio track: AAC. Choose from the following audio timing correction settings: * Disabled (Default): Apply no correction. * Auto: Recommended for most inputs. MediaConvert analyzes the audio timing in your input and determines which correction setting to use, if needed. * Track: Adjust the duration of each audio frame by a constant amount to align the audio track length with STTS duration. Track-level correction does not affect pitch, and is recommended for tonal audio content such as music. * Frame: Adjust the duration of each audio frame by a variable amount to align audio frames with STTS timestamps. No corrections are made to already-aligned frames. Frame-level correction may affect the pitch of corrected frames, and is recommended for atonal audio content such as speech or percussion. * Force: Apply audio duration correction, either Track or Frame depending on your input, regardless of the accuracy of your input’s STTS table. Your output audio and video may not be aligned or it may contain audio artifacts.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#custom_language_code ⇒ String

Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#default_selection ⇒ String

Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can’t find the specified input audio. If you don’t set a default, those outputs have no audio.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#external_audio_file_input ⇒ String

Specify the S3, HTTP, or HTTPS URL for your external audio file input.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#hls_rendition_group_settings ⇒ Types::HlsRenditionGroupSettings

Settings specific to audio sources in an HLS alternate rendition group. Specify the properties (renditionGroupId, renditionName or renditionLanguageCode) to identify the unique audio track among the alternative rendition groups present in the HLS manifest. If no unique track is found, or multiple tracks match the properties provided, the job fails. If no properties in hlsRenditionGroupSettings are specified, the default audio track within the video segment is chosen. If there is no audio within video segment, the alternative audio with DEFAULT=YES is chosen instead.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#language_code ⇒ String

Specify the language to select from your audio input. In the MediaConvert console choose from a list of languages. In your JSON job settings choose from an ISO 639-2 three-letter code listed at www.loc.gov/standards/iso639-2/php/code_list.php

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#offset ⇒ Integer

Specify a time delta, in milliseconds, to offset the audio from the input video. To specify no offset: Keep the default value, 0. To specify an offset: Enter an integer from -2147483648 to 2147483647

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#pids ⇒ Array<Integer>

Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#program_selection ⇒ Integer

Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#remix_settings ⇒ Types::RemixSettings

Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#selector_type ⇒ String

Specify how MediaConvert selects audio content within your input. The default is Track. PID: Select audio by specifying the Packet 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: Select audio by language using ISO 639-2 or ISO 639-3 three-letter language codes. Use this when your source has embedded language metadata and you want to select tracks based on their language. HLS rendition group: Select audio from an HLS rendition group. Use this when your input is an HLS package with 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.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end

#tracks ⇒ Array<Integer>

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.

# File 'lib/aws-sdk-mediaconvert/types.rb', line 843

class AudioSelector < Struct.new(
  :audio_duration_correction,
  :custom_language_code,
  :default_selection,
  :external_audio_file_input,
  :hls_rendition_group_settings,
  :language_code,
  :offset,
  :pids,
  :program_selection,
  :remix_settings,
  :selector_type,
  :tracks)
  SENSITIVE = []
  include Aws::Structure
end