eac3AtmosSettings - AWS Elemental MediaConvert API Reference API Reference

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3_ATMOS.

Type: Eac3AtmosSettings (p. 206) Required: False

mp2Settings

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.

Type: Mp2Settings (p. 318) Required: False

mp3Settings

Required when you set Codec, under AudioDescriptions>CodecSettings, to the value MP3.

Type: Mp3Settings (p. 319) Required: False

opusSettings

Required when you set Codec, under AudioDescriptions>CodecSettings, to the value OPUS.

Type: OpusSettings (p. 347) Required: False

vorbisSettings

Required when you set Codec, under AudioDescriptions>CodecSettings, to the value Vorbis.

Type: VorbisSettings (p. 385) Required: False

wavSettings

Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.

Type: WavSettings (p. 393) Required: False

Properties

AudioDefaultSelection

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 ﬁnd the speciﬁed input audio. If you don't set a default, those outputs have no audio.

DEFAULT NOT_DEFAULT

AudioDescription

Settings related to one audio tab on the MediaConvert console. In your job JSON, an instance of

AudioDescription is equivalent to one audio tab in the console. Usually, one audio tab corresponds to one output audio track. Depending on how you set up your input audio selectors and whether you use audio selector groups, one audio tab can correspond to a group of output audio tracks.

audioTypeControl

When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this ﬁeld and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD.

Type: AudioTypeControl (p. 138) Required: False

audioSourceName

Speciﬁes which audio data to use from each input. In the simplest case, specify an "Audio

Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used.

If there is no audio selector marked as "default", silence will be inserted for the duration of that input.

Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be speciﬁed, with similar default/silence behavior. If no audio_source_name is speciﬁed, then "Audio Selector 1" will be chosen automatically.

Type: string Required: False

audioNormalizationSettings

Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard.

Type: AudioNormalizationSettings (p. 134) Required: False

audioChannelTaggingSettings

When you mimic a multi-channel audio layout with multiple mono-channel tracks, you can tag each channel layout manually. For example, you would tag the tracks that contain your left, right, and center audio with Left (L), Right (R), and Center (C), respectively. When you don't specify a value, MediaConvert labels your track as Center (C) by default. To use audio layout tagging, your output must be in a

QuickTime (.mov) container; your audio codec must be AAC, WAV, or AIFF; and you must set up your audio track to have only one channel.

Properties

Type: AudioChannelTaggingSettings (p. 128) Required: False

codecSettings

Settings related to audio encoding. The settings in this group vary depending on the value that you choose for your audio codec.

Type: AudioCodecSettings (p. 129) Required: False

remixSettings

Advanced audio remixing settings.

Type: RemixSettings (p. 359) Required: False

streamName

Specify a label for this output audio stream. For example, "English", "Director commentary", or "track_2".

For streaming outputs, MediaConvert passes this information into destination manifests for display on the end-viewer's player device. For outputs in other output groups, the service ignores this setting.

Type: string Required: False Pattern: ^[\w\s]*$

languageCodeControl

Specify which source for language code takes precedence for this audio track. When you choose Follow input (FOLLOW_INPUT), the service uses the language code from the input track if it's present. If there's no languge code on the input track, the service uses the code that you specify in the setting Language code (languageCode or customLanguageCode). When you choose Use conﬁgured (USE_CONFIGURED), the service uses the language code that you specify.

Type: AudioLanguageCodeControl (p. 133) Required: False

audioType

Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are deﬁned in ISO-IEC 13818-1: 0 = Undeﬁned, 1 = Clean Eﬀects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.

Type: integer Required: False Minimum: 0 Maximum: 255

customLanguageCode

Specify the language for this audio output track. The service puts this language code into your output audio track when you set Language code control (AudioLanguageCodeControl) to Use conﬁgured

Properties

(USE_CONFIGURED). The service also uses your speciﬁed custom language code when you set Language code control (AudioLanguageCodeControl) to Follow input (FOLLOW_INPUT), but your input ﬁle doesn't specify a language code. For all outputs, you can use an ISO 639-2 or ISO 639-3 code. For streaming outputs, you can also use any other code in the full RFC-5646 speciﬁcation. Streaming outputs are those that are in one of the following output groups: CMAF, DASH ISO, Apple HLS, or Microsoft Smooth Streaming.

Type: string Required: False

Pattern: ^[A-Za-z]{2,3}(-[A-Za-z-]+)?$

languageCode

Indicates the language of the audio output track. The ISO 639 language speciﬁed in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code speciﬁed by the input.

Type: LanguageCode (p. 295) Required: False

AudioLanguageCodeControl

FOLLOW_INPUT USE_CONFIGURED

AudioNormalizationAlgorithm

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: Modiﬁed 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 conﬁgurations such as 7.1.

ITU_BS_1770_1 ITU_BS_1770_2 ITU_BS_1770_3 ITU_BS_1770_4

AudioNormalizationAlgorithmControl

When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.

CORRECT_AUDIO MEASURE_ONLY

Properties

AudioNormalizationLoudnessLogging

If set to LOG, log each output's audio track loudness to a CSV ﬁle.

LOGDONT_LOG

AudioNormalizationPeakCalculation

If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.

TRUE_PEAK NONE

AudioNormalizationSettings

Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard.

algorithm

Type: AudioNormalizationAlgorithm (p. 133) Required: False

algorithmControl

When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.

Type: AudioNormalizationAlgorithmControl (p. 133) Required: False

correctionGateLevel

Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.

Type: integer Required: False Minimum: -70 Maximum: 0

loudnessLogging

If set to LOG, log each output's audio track loudness to a CSV ﬁle.

Properties

Type: AudioNormalizationLoudnessLogging (p. 134) Required: False

targetLkfs

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.

Type: number Required: False Format: ﬂoat Minimum: -59.0 Maximum: 0.0

peakCalculation

If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.

Type: AudioNormalizationPeakCalculation (p. 134) Required: False

AudioSelector

Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use multiple Audio selectors per input.

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 examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job ﬁle, provide the track numbers in an array. For example, "tracks": [1,2,3].

Type: Array of type integer Required: False

Minimum: 1

Maximum: 2147483647

oﬀset

Speciﬁes a time delta in milliseconds to oﬀset the audio from the input video.

Type: integer Required: False

Minimum: -2147483648 Maximum: 2147483647

defaultSelection

Properties

Type: AudioDefaultSelection (p. 131) Required: False

selectorType

Speciﬁes the type of the audio selector.

Type: AudioSelectorType (p. 138) Required: False

pids

Selects a speciﬁc PID from within an audio source (e.g. 257 selects PID 0x101).

Type: Array of type integer Required: False

Minimum: 1

Maximum: 2147483647

externalAudioFileInput

Speciﬁes audio data from an external ﬁle source.

Type: string Required: False

Pattern: ^((s3://([^\/]+\/+)+([^\/\.]+|(([^\/]*)\.([mM]2[pP]|[wW][eE][bB][mM]|

[pP][eE][gG]2|[mM][xX][fF]_[mM][pP][eE][gG]2|[mM][xX][fF][hH][dD]|[wW][aA]

[dD][tT][sS][eE]|[aA][tT][mM][oO][sS]|[oO][gG][gGaA]))))|(https?://([^\/]+\/

[lL][cC][hH]|[gG][xX][fF]_[mM][pP][eE][gG]2|[mM][xX][fF]_[mM][pP][eE][gG]2|

[gGaA])))(\?([^&=]+=[^&]+&)*[^&=]+=[^&]+)?))$

programSelection

Use this setting for input streams that contain Dolby E, to have the service extract speciﬁc program data from the track. To select multiple programs, create multiple selectors with the same Track and diﬀerent 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 you are sending a JSON ﬁle, provide the program ID, which is part of the audio metadata. If your input ﬁle 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.

Properties

Type: integer Required: False Minimum: 0 Maximum: 8

customLanguageCode

Selects a speciﬁc language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language code

Type: string Required: False

Pattern: ^[A-Za-z]{3}$

MinLength: 3 MaxLength: 3

languageCode

Selects a speciﬁc language code from within an audio source.

Type: LanguageCode (p. 295) Required: False

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 ﬁles into a single output, one after the other.

Type: RemixSettings (p. 359) Required: False

hlsRenditionGroupSettings

Settings speciﬁc 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 speciﬁed, 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.

Type: HlsRenditionGroupSettings (p. 270) Required: False

AudioSelectorGroup

Use audio selector groups to combine multiple sidecar audio inputs so that you can assign them to a single output audio tab (AudioDescription). Note that, if you're working with embedded audio, it's simpler to assign multiple input tracks into a single audio selector rather than use an audio selector group.

audioSelectorNames

Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.

Properties

Type: Array of type string Required: False

MinLength: 1

AudioSelectorType

Speciﬁes the type of the audio selector.

PID TRACK

LANGUAGE_CODE HLS_RENDITION_GROUP

AudioTypeControl

FOLLOW_INPUT USE_CONFIGURED

AutomatedAbrSettings

Use automated ABR to have MediaConvert set up the renditions in your ABR package for you

automatically, based on characteristics of your input video. This feature optimizes video quality while minimizing the overall size of your ABR package.

maxRenditions

Optional. The maximum number of renditions that MediaConvert will create in your automated ABR stack. The number of renditions is determined automatically, based on analysis of each job, but will never exceed this limit. When you set this to Auto in the console, which is equivalent to excluding it from your JSON job speciﬁcation, MediaConvert defaults to a limit of 15.

Type: integer Required: False Minimum: 3 Maximum: 15

maxAbrBitrate

Optional. The maximum target bit rate used in your automated ABR stack. Use this value to set an upper limit on the bandwidth consumed by the highest-quality rendition. This is the rendition that is delivered to viewers with the fastest internet connections. If you don't specify a value, MediaConvert uses 8,000,000 (8 mb/s) by default.

Type: integer Required: False Minimum: 100000 Maximum: 100000000

Properties

minAbrBitrate

Optional. The minimum target bitrate used in your automated ABR stack. Use this value to set a lower limit on the bitrate of video delivered to viewers with slow internet connections. If you don't specify a value, MediaConvert uses 600,000 (600 kb/s) by default.

Type: integer Required: False Minimum: 100000 Maximum: 100000000

AutomatedEncodingSettings

Use automated encoding to have MediaConvert choose your encoding settings for you, based on characteristics of your input video.

abrSettings

Use automated ABR to have MediaConvert set up the renditions in your ABR package for you

automatically, based on characteristics of your input video. This feature optimizes video quality while minimizing the overall size of your ABR package.

Type: AutomatedAbrSettings (p. 138) Required: False

Av1AdaptiveQuantization

Specify the strength of any adaptive quantization ﬁlters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdaptiveQuantization).

OFF LOW MEDIUM HIGH HIGHER MAX

Av1BitDepth

Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10).

BIT_8 BIT_10

Av1FramerateControl

If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job speciﬁcation as a JSON ﬁle without the console, use FramerateControl to specify which value the service uses for the frame rate for this output.

Properties

Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator.

INITIALIZE_FROM_SOURCE SPECIFIED

Av1FramerateConversionAlgorithm

Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate.

We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a signiﬁcant add-on cost.

DUPLICATE_DROP INTERPOLATE FRAMEFORMER

Av1QvbrSettings

Settings for quality-deﬁned variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode).

qvbrQualityLevel

Use this setting only when you set Rate control mode (RateControlMode) to QVBR. Specify the target quality level for this output. MediaConvert determines the right number of bits to use for each part of the video to maintain the video quality that you specify. When you keep the default value, AUTO, MediaConvert picks a quality level for you, based on characteristics of your input video. If you prefer to specify a quality level, specify a number from 1 through 10. Use higher numbers for greater quality.

Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9. Optionally, to specify a value between whole numbers, also provide a value for the setting qvbrQualityLevelFineTune. For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set qvbrQualityLevelFineTune to .33.

Type: integer Required: False Minimum: 1 Maximum: 10

qvbrQualityLevelFineTune

Optional. Specify a value here to set the QVBR quality to a level that is between whole numbers.

For example, if you want your QVBR quality level to be 7.33, set qvbrQualityLevel to 7 and set

qvbrQualityLevelFineTune to .33. MediaConvert rounds your QVBR quality level to the nearest third of a whole number. For example, if you set qvbrQualityLevel to 7 and you set qvbrQualityLevelFineTune to .25, your actual QVBR quality level is 7.33.

Type: number Required: False Format: ﬂoat

Properties

Minimum: 0.0 Maximum: 1.0

Av1RateControlMode

'With AV1 outputs, for rate control mode, MediaConvert supports only quality-deﬁned variable bitrate (QVBR). You can''t use CBR or VBR.'

QVBR

Av1Settings

Required when you set Codec, under VideoDescription>CodecSettings to the value AV1.

gopSize

Specify the GOP length (keyframe interval) in frames. With AV1, MediaConvert doesn't support GOP length in seconds. This value must be greater than zero and preferably equal to 1 + ((numberBFrames + 1) * x), where x is an integer value.

Type: number Required: False Format: ﬂoat Minimum: 0.0

numberBFramesBetweenReferenceFrames

Specify from the number of B-frames, in the range of 0-15. For AV1 encoding, we recommend using 7 or 15. Choose a larger number for a lower bitrate and smaller ﬁle size; choose a smaller number for better video quality.

Type: integer Required: False Minimum: 0 Maximum: 15

slices

Specify the number of slices per picture. This value must be 1, 2, 4, 8, 16, or 32. For progressive pictures, this value must be less than or equal to the number of macroblock rows. For interlaced pictures, this value must be less than or equal to half the number of macroblock rows.

Type: integer Required: False Minimum: 1 Maximum: 32

bitDepth

Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT_8) or 10-bit (BIT_10).

Type: Av1BitDepth (p. 139) Required: False

Properties

rateControlMode

'With AV1 outputs, for rate control mode, MediaConvert supports only quality-deﬁned variable bitrate (QVBR). You can''t use CBR or VBR.'

Type: Av1RateControlMode (p. 141) Required: False

在文檔中 AWS Elemental MediaConvert API Reference API Reference (頁 134-154)