{ "$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." } ] } } }