Class AudioSelector
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<AudioSelector.Builder,
AudioSelector>
- See Also:
-
Nested Class Summary
-
Method Summary
Modifier and TypeMethodDescriptionfinal AudioDurationCorrection
Apply audio timing corrections to help synchronize audio and video in your output.final String
Apply audio timing corrections to help synchronize audio and video in your output.static AudioSelector.Builder
builder()
final String
Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codefinal AudioDefaultSelection
Enable this setting on one audio selector to set it as the default for the job.final String
Enable this setting on one audio selector to set it as the default for the job.final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final String
Specifies audio data from an external file source.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) final int
hashCode()
final boolean
hasPids()
For responses, this returns true if the service returned a value for the Pids property.final boolean
For responses, this returns true if the service returned a value for the Tracks property.Settings specific to audio sources in an HLS alternate rendition group.final LanguageCode
Selects a specific language code from within an audio source.final String
Selects a specific language code from within an audio source.final Integer
offset()
Specifies a time delta in milliseconds to offset the audio from the input video.pids()
Selects a specific PID from within an audio source (e.g.final Integer
Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track.final RemixSettings
Use these settings to reorder the audio channels of one input to match those of another input.final AudioSelectorType
Specifies the type of the audio selector.final String
Specifies the type of the audio selector.static Class
<? extends AudioSelector.Builder> Take this object and create a builder that contains all of the current property values of this object.final String
toString()
Returns a string representation of this object.tracks()
Identify a track from the input audio to include in this selector by entering the track index number.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
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.If the service returns an enum value that is not available in the current SDK version,
audioDurationCorrection
will returnAudioDurationCorrection.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromaudioDurationCorrectionAsString()
.- Returns:
- 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.
- See Also:
-
audioDurationCorrectionAsString
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.If the service returns an enum value that is not available in the current SDK version,
audioDurationCorrection
will returnAudioDurationCorrection.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromaudioDurationCorrectionAsString()
.- Returns:
- 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.
- See Also:
-
customLanguageCode
Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code- Returns:
- Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code
-
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.If the service returns an enum value that is not available in the current SDK version,
defaultSelection
will returnAudioDefaultSelection.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromdefaultSelectionAsString()
.- Returns:
- 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.
- See Also:
-
defaultSelectionAsString
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.If the service returns an enum value that is not available in the current SDK version,
defaultSelection
will returnAudioDefaultSelection.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromdefaultSelectionAsString()
.- Returns:
- 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.
- See Also:
-
externalAudioFileInput
Specifies audio data from an external file source.- Returns:
- Specifies audio data from an external file source.
-
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.- Returns:
- 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.
-
languageCode
Selects a specific language code from within an audio source.If the service returns an enum value that is not available in the current SDK version,
languageCode
will returnLanguageCode.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromlanguageCodeAsString()
.- Returns:
- Selects a specific language code from within an audio source.
- See Also:
-
languageCodeAsString
Selects a specific language code from within an audio source.If the service returns an enum value that is not available in the current SDK version,
languageCode
will returnLanguageCode.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromlanguageCodeAsString()
.- Returns:
- Selects a specific language code from within an audio source.
- See Also:
-
offset
Specifies a time delta in milliseconds to offset the audio from the input video.- Returns:
- Specifies a time delta in milliseconds to offset the audio from the input video.
-
hasPids
public final boolean hasPids()For responses, this returns true if the service returned a value for the Pids property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
pids
Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasPids()
method.- Returns:
- Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).
-
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.- Returns:
- 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.
-
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.- Returns:
- 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.
-
selectorType
Specifies the type of the audio selector.If the service returns an enum value that is not available in the current SDK version,
selectorType
will returnAudioSelectorType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromselectorTypeAsString()
.- Returns:
- Specifies the type of the audio selector.
- See Also:
-
selectorTypeAsString
Specifies the type of the audio selector.If the service returns an enum value that is not available in the current SDK version,
selectorType
will returnAudioSelectorType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromselectorTypeAsString()
.- Returns:
- Specifies the type of the audio selector.
- See Also:
-
hasTracks
public final boolean hasTracks()For responses, this returns true if the service returned a value for the Tracks property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
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.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTracks()
method.- Returns:
- 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.
-
toBuilder
Description copied from interface:ToCopyableBuilder
Take this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilder
in interfaceToCopyableBuilder<AudioSelector.Builder,
AudioSelector> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode() -
equals
-
equalsBySdkFields
Description copied from interface:SdkPojo
Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojo
class, and is generated based on a service model.If an
SdkPojo
class does not have any inherited fields,equalsBySdkFields
andequals
are essentially the same.- Specified by:
equalsBySdkFields
in interfaceSdkPojo
- Parameters:
obj
- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value. -
getValueForField
-
sdkFields
-