AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.35.1 to 2.35.3. Enhanced documentation for audio normalization algorithms, added new parameters (PeakCalculation, PeakLimiterThreshold) for loudness control, and expanded configuration options for per-PID/track audio processing including Dolby E decoding, channel remixing, and gain adjustments.
Security assessment
The changes are feature enhancements for audio processing capabilities in MediaLive, not security fixes. No vulnerabilities, exploits, or security incidents are referenced. Updates focus on expanded algorithm options (ITU-R BS.1770-3/4), true peak calculation, and finer audio control.
Diff
diff --git a/cli/latest/reference/medialive/update-channel-class.md b/cli/latest/reference/medialive/update-channel-class.md index f2f674a9f..5a11243bf 100644 --- a//cli/latest/reference/medialive/update-channel-class.md +++ b//cli/latest/reference/medialive/update-channel-class.md @@ -15 +15 @@ - * [AWS CLI 2.35.1 Command Reference](../../index.html) » + * [AWS CLI 2.35.3 Command Reference](../../index.html) » @@ -623 +623 @@ Channel -> (structure) ->>>>>> Audio normalization algorithm to use. itu17701 conforms to the CALM Act specification, itu17702 conforms to the EBU R-128 specification. +>>>>>> 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. @@ -628,0 +629,2 @@ Channel -> (structure) +>>>>>> * `ITU_1770_3` +>>>>>> * `ITU_1770_4` @@ -644,0 +647,15 @@ Channel -> (structure) +>>>>> +>>>>> PeakCalculation -> (string) +>>>>> +>>>>>> If set to TRUE_PEAK, calculate the TruePeak for each output’s audio track loudness. +>>>>>> +>>>>>> Possible values: +>>>>>> +>>>>>> * `NONE` +>>>>>> * `TRUE_PEAK` +>>>>>> + +>>>>> +>>>>> PeakLimiterThreshold -> (double) +>>>>> +>>>>>> Peak limiter threshold in decibels relative to true peak (dBTP) if TRUE_PEAK is enabled. If TRUE_PEAK is not enabled a full scale (dbFS) value is used. The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Leave blank to use the default value 0. @@ -7408,0 +7426,132 @@ Channel -> (structure) +>>>>>>>> +>>>>>>>> Pids -> (list) +>>>>>>>> +>>>>>>>>> Selects one or more unique PIDs from within a source. When using ‘pids’, you can specify per-PID audio pre-mixer settings. +>>>>>>>>> +>>>>>>>>> (structure) +>>>>>>>>> +>>>>>>>>>> Represents a single PID value for audio selection with optional pre-mixer settings +>>>>>>>>>> +>>>>>>>>>> DolbyEDecode -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Configure decoding options for Dolby E streams - these should be Dolby E frames carried in PCM streams tagged with SMPTE-337. When using the ‘pids’ array, if this field is not specified and Dolby E content is present, the decoder will extract the specified program. To maintain legacy behavior (allPrograms), explicitly set programSelection to “allChannels”. +>>>>>>>>>>> +>>>>>>>>>>> ProgramSelection -> (string) [required] +>>>>>>>>>>> +>>>>>>>>>>>> Applies only to Dolby E. Enter the program ID (according to the metadata in the audio) of the Dolby E program to extract from the specified track. One program extracted per audio selector. To select multiple programs, create multiple selectors with the same Track and different Program numbers. “All channels” means to ignore the program IDs and include all the channels in this selector; useful if metadata is known to be incorrect. +>>>>>>>>>>>> +>>>>>>>>>>>> Possible values: +>>>>>>>>>>>> +>>>>>>>>>>>> * `ALL_CHANNELS` +>>>>>>>>>>>> * `PROGRAM_1` +>>>>>>>>>>>> * `PROGRAM_2` +>>>>>>>>>>>> * `PROGRAM_3` +>>>>>>>>>>>> * `PROGRAM_4` +>>>>>>>>>>>> * `PROGRAM_5` +>>>>>>>>>>>> * `PROGRAM_6` +>>>>>>>>>>>> * `PROGRAM_7` +>>>>>>>>>>>> * `PROGRAM_8` +>>>>>>>>>>>> + +>>>>>>>>>> +>>>>>>>>>> Pid -> (integer) [required] +>>>>>>>>>> +>>>>>>>>>>> PID value from within a source. +>>>>>>>>>> +>>>>>>>>>> PremixSettings -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Optional audio pre-mixer settings for this PID. When specified, allows per-PID audio processing including channel remixing, gain adjustment, and loudness normalization before interleaving. +>>>>>>>>>>> +>>>>>>>>>>> AudioNormalizationSettings -> (structure) +>>>>>>>>>>> +>>>>>>>>>>>> Audio normalization settings for loudness control. When specified, audio loudness will be normalized according to the chosen algorithm. +>>>>>>>>>>>> +>>>>>>>>>>>> Algorithm -> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> 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. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Possible values: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * `ITU_1770_1` +>>>>>>>>>>>>> * `ITU_1770_2` +>>>>>>>>>>>>> * `ITU_1770_3` +>>>>>>>>>>>>> * `ITU_1770_4` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> AlgorithmControl -> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Possible values: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * `CORRECT_AUDIO` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> TargetLkfs -> (double) +>>>>>>>>>>>> +>>>>>>>>>>>>> Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act recommends a target of -24 LKFS. The EBU R-128 specification recommends a target of -23 LKFS. +>>>>>>>>>>>> +>>>>>>>>>>>> PeakCalculation -> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> If set to TRUE_PEAK, calculate the TruePeak for each output’s audio track loudness. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Possible values: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * `NONE` +>>>>>>>>>>>>> * `TRUE_PEAK` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> PeakLimiterThreshold -> (double) +>>>>>>>>>>>> +>>>>>>>>>>>>> Peak limiter threshold in decibels relative to true peak (dBTP) if TRUE_PEAK is enabled. If TRUE_PEAK is not enabled a full scale (dbFS) value is used. The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Leave blank to use the default value 0. +>>>>>>>>>>> +>>>>>>>>>>> Channels -> (integer) +>>>>>>>>>>> +>>>>>>>>>>>> Number of audio channels. If specified, the audio will be remixed to match this channel count. Ignored if remixSettings is specified. +>>>>>>>>>>> +>>>>>>>>>>> GainDb -> (double) +>>>>>>>>>>> +>>>>>>>>>>>> Gain adjustment in dB to apply. Range: -60 to +60 dB +>>>>>>>>>>> +>>>>>>>>>>> RemixSettings -> (structure) +>>>>>>>>>>> +>>>>>>>>>>>> Settings that control how input audio channels are remixed. When specified, allows fine-grained control over channel mapping and gain levels. Takes precedence over the ‘channels’ setting. +>>>>>>>>>>>> +>>>>>>>>>>>> ChannelMappings -> (list) [required] +>>>>>>>>>>>> +>>>>>>>>>>>>> Mapping of input channels to output channels, with appropriate gain adjustments. +>>>>>>>>>>>>> +>>>>>>>>>>>>> (structure) +>>>>>>>>>>>>> +>>>>>>>>>>>>>> Audio Channel Mapping +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> InputChannelLevels -> (list) [required] +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Indices and gain values for each input channel that should be remixed into this output channel. +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> (structure) +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> Input Channel Level +>>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> Gain -> (integer) [required] +>>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>>> Remixing value. Units are in dB and acceptable values are within the range from -60 (mute) and 6 dB. +>>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> InputChannel -> (integer) [required] +>>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>>> The index of the input channel used as a source. +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> OutputChannel -> (integer) [required] +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> The index of the output channel being produced. +>>>>>>>>>>>> +>>>>>>>>>>>> ChannelsIn -> (integer) +>>>>>>>>>>>> +>>>>>>>>>>>>> Number of input channels to be used. +>>>>>>>>>>>> +>>>>>>>>>>>> ChannelsOut -> (integer) +>>>>>>>>>>>> +>>>>>>>>>>>>> Number of output channels to be produced. Valid values: 1, 2, 4, 6, 8 @@ -7420 +7569 @@ Channel -> (structure) ->>>>>>>>>> Audio Track +>>>>>>>>>> Represents a single audio track for selection with optional pre-mixer settings @@ -7424,0 +7574,98 @@ Channel -> (structure) +>>>>>>>>>> +>>>>>>>>>> PremixSettings -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Optional audio pre-mixer settings for this track. When specified, allows per-track audio processing including channel remixing, gain adjustment, and loudness normalization before interleaving. +>>>>>>>>>>> +>>>>>>>>>>> AudioNormalizationSettings -> (structure) +>>>>>>>>>>> +>>>>>>>>>>>> Audio normalization settings for loudness control. When specified, audio loudness will be normalized according to the chosen algorithm. +>>>>>>>>>>>> +>>>>>>>>>>>> Algorithm -> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> 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. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Possible values: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * `ITU_1770_1` +>>>>>>>>>>>>> * `ITU_1770_2` +>>>>>>>>>>>>> * `ITU_1770_3` +>>>>>>>>>>>>> * `ITU_1770_4` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> AlgorithmControl -> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Possible values: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * `CORRECT_AUDIO` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> TargetLkfs -> (double) +>>>>>>>>>>>>