Package software.amazon.awssdk.services.mediaconvert.model

Interface AudioNormalizationSettings.Builder

    • Method Detail

      • algorithm

        AudioNormalizationSettings.Builder algorithm​(String algorithm)
        Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
        Parameters:
        algorithm - Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        AudioNormalizationAlgorithm, AudioNormalizationAlgorithm

      • algorithm

        AudioNormalizationSettings.Builder algorithm​(AudioNormalizationAlgorithm algorithm)
        Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
        Parameters:
        algorithm - Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        AudioNormalizationAlgorithm, AudioNormalizationAlgorithm

      • algorithmControl

        AudioNormalizationSettings.Builder algorithmControl​(String algorithmControl)
        When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
        Parameters:
        algorithmControl - When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        AudioNormalizationAlgorithmControl, AudioNormalizationAlgorithmControl

      • correctionGateLevel

        AudioNormalizationSettings.Builder correctionGateLevel​(Integer correctionGateLevel)
        Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.
        Parameters:
        correctionGateLevel - Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • targetLkfs

        AudioNormalizationSettings.Builder targetLkfs​(Double targetLkfs)
        When you use Audio normalization, optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.
        Parameters:
        targetLkfs - When you use Audio normalization, optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • truePeakLimiterThreshold

        AudioNormalizationSettings.Builder truePeakLimiterThreshold​(Double truePeakLimiterThreshold)
        Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.
        Parameters:
        truePeakLimiterThreshold - Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.
        Returns:
        Returns a reference to this object so that method calls can be chained together.