/AWS1/CL_MDCAUDIOSELECTOR

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.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_audiodurationcorrection TYPE /AWS1/MDCAUDIODURATIONCORR /AWS1/MDCAUDIODURATIONCORR

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.

iv_customlanguagecode TYPE /AWS1/MDC__STRMIN3MAX3PATAZAZ3 /AWS1/MDC__STRMIN3MAX3PATAZAZ3

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

iv_defaultselection TYPE /AWS1/MDCAUDIODEFAULTSELECTION /AWS1/MDCAUDIODEFAULTSELECTION

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.

iv_externalaudiofileinput TYPE /AWS1/MDC__STRINGPATS3HTTPS /AWS1/MDC__STRINGPATS3HTTPS

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

io_hlsrenditiongroupsettings TYPE REF TO /AWS1/CL_MDCHLSRENDITIONGRSTGS /AWS1/CL_MDCHLSRENDITIONGRSTGS

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.

iv_languagecode TYPE /AWS1/MDCLANGUAGECODE /AWS1/MDCLANGUAGECODE

Specify the language, using an ISO 639-2 three-letter code in all capital letters. You can find a list of codes at: https://www.loc.gov/standards/iso639-2/php/code_list.php

iv_offset TYPE /AWS1/MDC__INTEGERMINNEG214700 /AWS1/MDC__INTEGERMINNEG214700

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

it_pids TYPE /AWS1/CL_MDC__LSTOF__INTEGER00=>TT___LSTOF__INTEGERMIN1MAX2100 TT___LSTOF__INTEGERMIN1MAX2100

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

iv_programselection TYPE /AWS1/MDC__INTEGERMIN0MAX8 /AWS1/MDC__INTEGERMIN0MAX8

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.

io_remixsettings TYPE REF TO /AWS1/CL_MDCREMIXSETTINGS /AWS1/CL_MDCREMIXSETTINGS

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.

iv_selectortype TYPE /AWS1/MDCAUDIOSELECTORTYPE /AWS1/MDCAUDIOSELECTORTYPE

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. 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 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. 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.

it_streams TYPE /AWS1/CL_MDC__LSTOF__INTEGER00=>TT___LSTOF__INTEGERMIN1MAX2100 TT___LSTOF__INTEGERMIN1MAX2100

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.

it_tracks TYPE /AWS1/CL_MDC__LSTOF__INTEGER00=>TT___LSTOF__INTEGERMIN1MAX2100 TT___LSTOF__INTEGERMIN1MAX2100

Identify a track from the input audio to include in this selector by 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.

---

Queryable Attributes

AudioDurationCorrection

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.

Accessible with the following methods

Method	Description
GET_AUDIODURATIONCORRECTION()	Getter for AUDIODURATIONCORRECTION, with configurable defaul
ASK_AUDIODURATIONCORRECTION()	Getter for AUDIODURATIONCORRECTION w/ exceptions if field ha
HAS_AUDIODURATIONCORRECTION()	Determine if AUDIODURATIONCORRECTION has a value

CustomLanguageCode

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

Accessible with the following methods

Method	Description
GET_CUSTOMLANGUAGECODE()	Getter for CUSTOMLANGUAGECODE, with configurable default
ASK_CUSTOMLANGUAGECODE()	Getter for CUSTOMLANGUAGECODE w/ exceptions if field has no
HAS_CUSTOMLANGUAGECODE()	Determine if CUSTOMLANGUAGECODE has a value

DefaultSelection

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.

Accessible with the following methods

Method	Description
GET_DEFAULTSELECTION()	Getter for DEFAULTSELECTION, with configurable default
ASK_DEFAULTSELECTION()	Getter for DEFAULTSELECTION w/ exceptions if field has no va
HAS_DEFAULTSELECTION()	Determine if DEFAULTSELECTION has a value

ExternalAudioFileInput

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

Accessible with the following methods

Method	Description
GET_EXTERNALAUDIOFILEINPUT()	Getter for EXTERNALAUDIOFILEINPUT, with configurable default
ASK_EXTERNALAUDIOFILEINPUT()	Getter for EXTERNALAUDIOFILEINPUT w/ exceptions if field has
HAS_EXTERNALAUDIOFILEINPUT()	Determine if EXTERNALAUDIOFILEINPUT has a value

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.

Accessible with the following methods

Method	Description
GET_HLSRENDITIONGROUPSTGS()	Getter for HLSRENDITIONGROUPSETTINGS

LanguageCode

Specify the language, using an ISO 639-2 three-letter code in all capital letters. You can find a list of codes at: https://www.loc.gov/standards/iso639-2/php/code_list.php

Accessible with the following methods

Method	Description
GET_LANGUAGECODE()	Getter for LANGUAGECODE, with configurable default
ASK_LANGUAGECODE()	Getter for LANGUAGECODE w/ exceptions if field has no value
HAS_LANGUAGECODE()	Determine if LANGUAGECODE has a value

Offset

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

Accessible with the following methods

Method	Description
GET_OFFSET()	Getter for OFFSET, with configurable default
ASK_OFFSET()	Getter for OFFSET w/ exceptions if field has no value
HAS_OFFSET()	Determine if OFFSET has a value

Pids

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

Accessible with the following methods

Method	Description
GET_PIDS()	Getter for PIDS, with configurable default
ASK_PIDS()	Getter for PIDS w/ exceptions if field has no value
HAS_PIDS()	Determine if PIDS has a value

ProgramSelection

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.

Accessible with the following methods

Method	Description
GET_PROGRAMSELECTION()	Getter for PROGRAMSELECTION, with configurable default
ASK_PROGRAMSELECTION()	Getter for PROGRAMSELECTION w/ exceptions if field has no va
HAS_PROGRAMSELECTION()	Determine if PROGRAMSELECTION has a value

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.

Accessible with the following methods

Method	Description
GET_REMIXSETTINGS()	Getter for REMIXSETTINGS

SelectorType

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. 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 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. 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.

Accessible with the following methods

Method	Description
GET_SELECTORTYPE()	Getter for SELECTORTYPE, with configurable default
ASK_SELECTORTYPE()	Getter for SELECTORTYPE w/ exceptions if field has no value
HAS_SELECTORTYPE()	Determine if SELECTORTYPE has a value

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.

Accessible with the following methods

Method	Description
GET_STREAMS()	Getter for STREAMS, with configurable default
ASK_STREAMS()	Getter for STREAMS w/ exceptions if field has no value
HAS_STREAMS()	Determine if STREAMS has a value

Tracks

Identify a track from the input audio to include in this selector by 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.

Accessible with the following methods

Method	Description
GET_TRACKS()	Getter for TRACKS, with configurable default
ASK_TRACKS()	Getter for TRACKS w/ exceptions if field has no value
HAS_TRACKS()	Determine if TRACKS has a value

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT___MAPOFAUDIOSELECTOR

TYPES TT___MAPOFAUDIOSELECTOR TYPE HASHED TABLE OF /AWS1/CL_MDCAUDIOSELECTOR=>TS___MAPOFAUDIOSELECTOR_MAPROW WITH UNIQUE KEY key
.

TS___MAPOFAUDIOSELECTOR_MAPROW

TYPES: BEGIN OF TS___MAPOFAUDIOSELECTOR_MAPROW,
  key TYPE /AWS1/MDC__STRING,
  value TYPE REF TO /AWS1/CL_MDCAUDIOSELECTOR,
END OF TS___MAPOFAUDIOSELECTOR_MAPROW.