Interface AudioSelector.Builder

All Superinterfaces:
Buildable, CopyableBuilder<AudioSelector.Builder,AudioSelector>, SdkBuilder<AudioSelector.Builder,AudioSelector>, SdkPojo
Enclosing class:
AudioSelector

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.
      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.
      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.
      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.
      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)
      Specifies audio data from an external file source.
      Parameters:
      externalAudioFileInput - Specifies audio data from an external file source.
      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)
      Selects a specific language code from within an audio source.
      Parameters:
      languageCode - Selects a specific language code from within an audio source.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • languageCode

      AudioSelector.Builder languageCode(LanguageCode languageCode)
      Selects a specific language code from within an audio source.
      Parameters:
      languageCode - Selects a specific language code from within an audio source.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • offset

      Specifies a time delta in milliseconds to offset the audio from the input video.
      Parameters:
      offset - Specifies a time delta in milliseconds to offset the audio from the input video.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • 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

      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)
      Specifies the type of the audio selector.
      Parameters:
      selectorType - Specifies the type of the audio selector.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • selectorType

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