Interface AudioSelector.Builder

All Superinterfaces:
Buildable, CopyableBuilder<AudioSelector.Builder,AudioSelector>, SdkBuilder<AudioSelector.Builder,AudioSelector>, SdkPojo
Enclosing class:
AudioSelector
@Mutable @NotThreadSafe public static interface AudioSelector.Builder extends SdkPojo, CopyableBuilder<AudioSelector.Builder,AudioSelector>

  • Method Details

    • audioDurationCorrection

      AudioSelector.Builder audioDurationCorrection(String 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • audioDurationCorrection

      AudioSelector.Builder audioDurationCorrection(AudioDurationCorrection 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • customLanguageCode

      AudioSelector.Builder customLanguageCode(String customLanguageCode)
      Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code
      Parameters:
      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:
      Returns a reference to this object so that method calls can be chained together.

    • defaultSelection

      AudioSelector.Builder defaultSelection(String 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • defaultSelection

      AudioSelector.Builder defaultSelection(AudioDefaultSelection 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • externalAudioFileInput

      AudioSelector.Builder externalAudioFileInput(String externalAudioFileInput)
      Specify the S3, HTTP, or HTTPS URL for your external audio file input.
      Parameters:
      externalAudioFileInput - Specify the S3, HTTP, or HTTPS URL for your external audio file input.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • hlsRenditionGroupSettings

      AudioSelector.Builder hlsRenditionGroupSettings(HlsRenditionGroupSettings 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.
      Parameters:
      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:
      Returns a reference to this object so that method calls can be chained together.

    • hlsRenditionGroupSettings

      default AudioSelector.Builder hlsRenditionGroupSettings(Consumer<HlsRenditionGroupSettings.Builder> 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. This is a convenience method that creates an instance of the HlsRenditionGroupSettings.Builder avoiding the need to create one manually via HlsRenditionGroupSettings.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to hlsRenditionGroupSettings(HlsRenditionGroupSettings).

      Parameters:
      hlsRenditionGroupSettings - a consumer that will call methods on HlsRenditionGroupSettings.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • languageCode

      AudioSelector.Builder languageCode(String languageCode)
      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 https://www.loc.gov/standards/iso639-2/php/code_list.php
      Parameters:
      languageCode - 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 https://www.loc.gov/standards/iso639-2/php/code_list.php
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • languageCode

      AudioSelector.Builder languageCode(LanguageCode languageCode)
      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 https://www.loc.gov/standards/iso639-2/php/code_list.php
      Parameters:
      languageCode - 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 https://www.loc.gov/standards/iso639-2/php/code_list.php
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • offset

      AudioSelector.Builder offset(Integer 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
      Parameters:
      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
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • pids

      AudioSelector.Builder pids(Collection<Integer> pids)
      Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).
      Parameters:
      pids - Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • pids

      AudioSelector.Builder pids(Integer... pids)
      Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).
      Parameters:
      pids - Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • programSelection

      AudioSelector.Builder programSelection(Integer 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.
      Parameters:
      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:
      Returns a reference to this object so that method calls can be chained together.

    • remixSettings

      AudioSelector.Builder remixSettings(RemixSettings 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.
      Parameters:
      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:
      Returns a reference to this object so that method calls can be chained together.

    • remixSettings

      default AudioSelector.Builder remixSettings(Consumer<RemixSettings.Builder> 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. This is a convenience method that creates an instance of the RemixSettings.Builder avoiding the need to create one manually via RemixSettings.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to remixSettings(RemixSettings).

      Parameters:
      remixSettings - a consumer that will call methods on RemixSettings.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • selectorType

      AudioSelector.Builder selectorType(String 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. 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.
      Parameters:
      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. 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • selectorType

      AudioSelector.Builder selectorType(AudioSelectorType 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. 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.
      Parameters:
      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. 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • tracks

      AudioSelector.Builder tracks(Collection<Integer> 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • tracks

      AudioSelector.Builder tracks(Integer... 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.