AudioNormalizationSettings

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-mediaconvert/refs/heads/main/json-schema/mediaconvert-api-audio-normalization-settings-schema.json",
  "title": "AudioNormalizationSettings",
  "description": "Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard.",
  "type": "object",
  "properties": {
    "Algorithm": {
      "allOf": [
        {
          "$ref": "#/components/schemas/AudioNormalizationAlgorithm"
        },
        {
          "xml": {
            "name": "algorithm"
          },
          "description": "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."
        }
      ]
    },
    "AlgorithmControl": {
      "allOf": [
        {
          "$ref": "#/components/schemas/AudioNormalizationAlgorithmControl"
        },
        {
          "xml": {
            "name": "algorithmControl"
          },
          "description": "When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted."
        }
      ]
    },
    "CorrectionGateLevel": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMinNegative70Max0"
        },
        {
          "xml": {
            "name": "correctionGateLevel"
          },
          "description": "Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected."
        }
      ]
    },
    "LoudnessLogging": {
      "allOf": [
        {
          "$ref": "#/components/schemas/AudioNormalizationLoudnessLogging"
        },
        {
          "xml": {
            "name": "loudnessLogging"
          },
          "description": "If set to LOG, log each output's audio track loudness to a CSV file."
        }
      ]
    },
    "PeakCalculation": {
      "allOf": [
        {
          "$ref": "#/components/schemas/AudioNormalizationPeakCalculation"
        },
        {
          "xml": {
            "name": "peakCalculation"
          },
          "description": "If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness."
        }
      ]
    },
    "TargetLkfs": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__doubleMinNegative59Max0"
        },
        {
          "xml": {
            "name": "targetLkfs"
          },
          "description": "When you use Audio normalization (AudioNormalizationSettings), 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 (algorithm). If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS."
        }
      ]
    },
    "TruePeakLimiterThreshold": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__doubleMinNegative20Max0"
        },
        {
          "xml": {
            "name": "truePeakLimiterThreshold"
          },
          "description": "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 -20. Leave blank to use the default value 0."
        }
      ]
    }
  }
}