Skip to content

/AWS1/CL_MDCCMFCSETTINGS

These settings relate to the fragmented MP4 container for the segments in your CMAF outputs.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_audioduration TYPE /AWS1/MDCCMFCAUDIODURATION /AWS1/MDCCMFCAUDIODURATION

Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration. In all other cases, keep the default value, Default codec duration. When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec.

iv_audiogroupid TYPE /AWS1/MDC__STRING /AWS1/MDC__STRING

Specify the audio rendition group for this audio rendition. Specify up to one value for each audio output in your output group. This value appears in your HLS parent manifest in the EXT-X-MEDIA tag of TYPE=AUDIO, as the value for the GROUP-ID attribute. For example, if you specify "audio_aac_1" for Audio group ID, it appears in your manifest like this: #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio_aac_1". Related setting: To associate the rendition group that this audio track belongs to with a video rendition, include the same value that you provide here for that video output's setting Audio rendition sets.

iv_audiorenditionsets TYPE /AWS1/MDC__STRING /AWS1/MDC__STRING

List the audio rendition groups that you want included with this video rendition. Use a comma-separated list. For example, say you want to include the audio rendition groups that have the audio group IDs "audio_aac_1" and "audio_dolby". Then you would specify this value: "audio_aac_1,audio_dolby". Related setting: The rendition groups that you include in your comma-separated list should all match values that you specify in the setting Audio group ID for audio renditions in the same output group as this video rendition. Default behavior: If you don't specify anything here and for Audio group ID, MediaConvert puts each audio variant in its own audio rendition group and associates it with every video variant. Each value in your list appears in your HLS parent manifest in the EXT-X-STREAM-INF tag as the value for the AUDIO attribute. To continue the previous example, say that the file name for the child manifest for your video rendition is "amazing_video_1.m3u8". Then, in your parent manifest, each value will appear on separate lines, like this: #EXT-X-STREAM-INF:AUDIO="audio_aac_1"... amazing_video_1.m3u8 #EXT-X-STREAM-INF:AUDIO="audio_dolby"... amazing_video_1.m3u8

iv_audiotracktype TYPE /AWS1/MDCCMFCAUDIOTRACKTYPE /AWS1/MDCCMFCAUDIOTRACKTYPE

Use this setting to control the values that MediaConvert puts in your HLS parent playlist to control how the client player selects which audio track to play. Choose Audio-only variant stream (AUDIO_ONLY_VARIANT_STREAM) for any variant that you want to prohibit the client from playing with video. This causes MediaConvert to represent the variant as an EXT-X-STREAM-INF in the HLS manifest. The other options for this setting determine the values that MediaConvert writes for the DEFAULT and AUTOSELECT attributes of the EXT-X-MEDIA entry for the audio variant. For more information about these attributes, see the Apple documentation article https://developer.apple.com/documentation/http_live_streaming/example_playlists_for_http_live_streaming/adding_alternate_media_to_a_playlist. Choose Alternate audio, auto select, default to set DEFAULT=YES and AUTOSELECT=YES. Choose this value for only one variant in your output group. Choose Alternate audio, auto select, not default to set DEFAULT=NO and AUTOSELECT=YES. Choose Alternate Audio, Not Auto Select to set DEFAULT=NO and AUTOSELECT=NO. When you don't specify a value for this setting, MediaConvert defaults to Alternate audio, auto select, default. When there is more than one variant in your output group, you must explicitly choose a value for this setting.

iv_c2pamanifest TYPE /AWS1/MDCCMFCC2PAMANIFEST /AWS1/MDCCMFCC2PAMANIFEST

When enabled, a C2PA compliant manifest will be generated, signed and embeded in the output. For more information on C2PA, see https://c2pa.org/specifications/specifications/2.1/index.html

iv_certificatesecret TYPE /AWS1/MDC__STRMIN1MAX2048PAT01 /AWS1/MDC__STRMIN1MAX2048PAT01

Specify the name or ARN of the AWS Secrets Manager secret that contains your C2PA public certificate chain in PEM format. Provide a valid secret name or ARN. Note that your MediaConvert service role must allow access to this secret. The public certificate chain is added to the COSE header (x5chain) for signature validation. Include the signer's certificate and all intermediate certificates. Do not include the root certificate. For details on COSE, see: https://opensource.contentauthenticity.org/docs/manifest/signing-manifests

iv_descriptivevideosvcflag TYPE /AWS1/MDCCMFCDESCRIPTIVEVIDE00 /AWS1/MDCCMFCDESCRIPTIVEVIDE00

Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest. When you choose Flag, MediaConvert includes the parameter CHARACTERISTICS="public.accessibility.describes-video" in the EXT-X-MEDIA entry for this track. When you keep the default choice, Don't flag, MediaConvert leaves this parameter out. The DVS flag can help with accessibility on Apple devices. For more information, see the Apple documentation.

iv_iframeonlymanifest TYPE /AWS1/MDCCMFCIFRAMEONLYMANIF00 /AWS1/MDCCMFCIFRAMEONLYMANIF00

Choose Include to have MediaConvert generate an HLS child manifest that lists only the I-frames for this rendition, in addition to your regular manifest for this rendition. You might use this manifest as part of a workflow that creates preview functions for your video. MediaConvert adds both the I-frame only child manifest and the regular child manifest to the parent manifest. When you don't need the I-frame only child manifest, keep the default value Exclude.

iv_klvmetadata TYPE /AWS1/MDCCMFCKLVMETADATA /AWS1/MDCCMFCKLVMETADATA

To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.

iv_manifestmetadatasignaling TYPE /AWS1/MDCCMFCMANIFESTMETSIGN00 /AWS1/MDCCMFCMANIFESTMETSIGN00

To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled. To enable Manifest metadata signaling, you must also set SCTE-35 source to Passthrough, ESAM SCTE-35 to insert, or ID3 metadata to Passthrough.

iv_scte35esam TYPE /AWS1/MDCCMFCSCTE35ESAM /AWS1/MDCCMFCSCTE35ESAM

Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML.

iv_scte35source TYPE /AWS1/MDCCMFCSCTE35SOURCE /AWS1/MDCCMFCSCTE35SOURCE

Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None if you don't want those SCTE-35 markers in this output.

iv_signingkmskey TYPE /AWS1/MDC__STRMIN1PATARNAWSU00 /AWS1/MDC__STRMIN1PATARNAWSU00

Specify the ID or ARN of the AWS KMS key used to sign the C2PA manifest in your MP4 output. Provide a valid KMS key ARN. Note that your MediaConvert service role must allow access to this key.

iv_timedmetadata TYPE /AWS1/MDCCMFCTIMEDMETADATA /AWS1/MDCCMFCTIMEDMETADATA

To include ID3 metadata in this output: Set ID3 metadata to Passthrough. Specify this ID3 metadata in Custom ID3 metadata inserter. MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None or leave blank.

iv_timedmetadataboxversion TYPE /AWS1/MDCCMFCTIMEDMETBOXVRS /AWS1/MDCCMFCTIMEDMETBOXVRS

Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. Leave blank to use the default value Version 0. When you specify Version 1, you must also set ID3 metadata to Passthrough.

iv_timedmetadataschemeiduri TYPE /AWS1/MDC__STRINGMAX1000 /AWS1/MDC__STRINGMAX1000

Specify the event message box (eMSG) scheme ID URI for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. Leave blank to use the default value: https://aomedia.org/emsg/ID3 When you specify a value for ID3 metadata scheme ID URI, you must also set ID3 metadata to Passthrough.

iv_timedmetadatavalue TYPE /AWS1/MDC__STRINGMAX1000 /AWS1/MDC__STRINGMAX1000

Specify the event message box (eMSG) value for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. When you specify a value for ID3 Metadata Value, you must also set ID3 metadata to Passthrough.

Queryable Attributes

AudioDuration

Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration. In all other cases, keep the default value, Default codec duration. When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec.

Accessible with the following methods

Method Description
GET_AUDIODURATION() Getter for AUDIODURATION, with configurable default
ASK_AUDIODURATION() Getter for AUDIODURATION w/ exceptions if field has no value
HAS_AUDIODURATION() Determine if AUDIODURATION has a value

AudioGroupId

Specify the audio rendition group for this audio rendition. Specify up to one value for each audio output in your output group. This value appears in your HLS parent manifest in the EXT-X-MEDIA tag of TYPE=AUDIO, as the value for the GROUP-ID attribute. For example, if you specify "audio_aac_1" for Audio group ID, it appears in your manifest like this: #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio_aac_1". Related setting: To associate the rendition group that this audio track belongs to with a video rendition, include the same value that you provide here for that video output's setting Audio rendition sets.

Accessible with the following methods

Method Description
GET_AUDIOGROUPID() Getter for AUDIOGROUPID, with configurable default
ASK_AUDIOGROUPID() Getter for AUDIOGROUPID w/ exceptions if field has no value
HAS_AUDIOGROUPID() Determine if AUDIOGROUPID has a value

AudioRenditionSets

List the audio rendition groups that you want included with this video rendition. Use a comma-separated list. For example, say you want to include the audio rendition groups that have the audio group IDs "audio_aac_1" and "audio_dolby". Then you would specify this value: "audio_aac_1,audio_dolby". Related setting: The rendition groups that you include in your comma-separated list should all match values that you specify in the setting Audio group ID for audio renditions in the same output group as this video rendition. Default behavior: If you don't specify anything here and for Audio group ID, MediaConvert puts each audio variant in its own audio rendition group and associates it with every video variant. Each value in your list appears in your HLS parent manifest in the EXT-X-STREAM-INF tag as the value for the AUDIO attribute. To continue the previous example, say that the file name for the child manifest for your video rendition is "amazing_video_1.m3u8". Then, in your parent manifest, each value will appear on separate lines, like this: #EXT-X-STREAM-INF:AUDIO="audio_aac_1"... amazing_video_1.m3u8 #EXT-X-STREAM-INF:AUDIO="audio_dolby"... amazing_video_1.m3u8

Accessible with the following methods

Method Description
GET_AUDIORENDITIONSETS() Getter for AUDIORENDITIONSETS, with configurable default
ASK_AUDIORENDITIONSETS() Getter for AUDIORENDITIONSETS w/ exceptions if field has no
HAS_AUDIORENDITIONSETS() Determine if AUDIORENDITIONSETS has a value

AudioTrackType

Use this setting to control the values that MediaConvert puts in your HLS parent playlist to control how the client player selects which audio track to play. Choose Audio-only variant stream (AUDIO_ONLY_VARIANT_STREAM) for any variant that you want to prohibit the client from playing with video. This causes MediaConvert to represent the variant as an EXT-X-STREAM-INF in the HLS manifest. The other options for this setting determine the values that MediaConvert writes for the DEFAULT and AUTOSELECT attributes of the EXT-X-MEDIA entry for the audio variant. For more information about these attributes, see the Apple documentation article https://developer.apple.com/documentation/http_live_streaming/example_playlists_for_http_live_streaming/adding_alternate_media_to_a_playlist. Choose Alternate audio, auto select, default to set DEFAULT=YES and AUTOSELECT=YES. Choose this value for only one variant in your output group. Choose Alternate audio, auto select, not default to set DEFAULT=NO and AUTOSELECT=YES. Choose Alternate Audio, Not Auto Select to set DEFAULT=NO and AUTOSELECT=NO. When you don't specify a value for this setting, MediaConvert defaults to Alternate audio, auto select, default. When there is more than one variant in your output group, you must explicitly choose a value for this setting.

Accessible with the following methods

Method Description
GET_AUDIOTRACKTYPE() Getter for AUDIOTRACKTYPE, with configurable default
ASK_AUDIOTRACKTYPE() Getter for AUDIOTRACKTYPE w/ exceptions if field has no valu
HAS_AUDIOTRACKTYPE() Determine if AUDIOTRACKTYPE has a value

C2paManifest

When enabled, a C2PA compliant manifest will be generated, signed and embeded in the output. For more information on C2PA, see https://c2pa.org/specifications/specifications/2.1/index.html

Accessible with the following methods

Method Description
GET_C2PAMANIFEST() Getter for C2PAMANIFEST, with configurable default
ASK_C2PAMANIFEST() Getter for C2PAMANIFEST w/ exceptions if field has no value
HAS_C2PAMANIFEST() Determine if C2PAMANIFEST has a value

CertificateSecret

Specify the name or ARN of the AWS Secrets Manager secret that contains your C2PA public certificate chain in PEM format. Provide a valid secret name or ARN. Note that your MediaConvert service role must allow access to this secret. The public certificate chain is added to the COSE header (x5chain) for signature validation. Include the signer's certificate and all intermediate certificates. Do not include the root certificate. For details on COSE, see: https://opensource.contentauthenticity.org/docs/manifest/signing-manifests

Accessible with the following methods

Method Description
GET_CERTIFICATESECRET() Getter for CERTIFICATESECRET, with configurable default
ASK_CERTIFICATESECRET() Getter for CERTIFICATESECRET w/ exceptions if field has no v
HAS_CERTIFICATESECRET() Determine if CERTIFICATESECRET has a value

DescriptiveVideoServiceFlag

Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest. When you choose Flag, MediaConvert includes the parameter CHARACTERISTICS="public.accessibility.describes-video" in the EXT-X-MEDIA entry for this track. When you keep the default choice, Don't flag, MediaConvert leaves this parameter out. The DVS flag can help with accessibility on Apple devices. For more information, see the Apple documentation.

Accessible with the following methods

Method Description
GET_DESCRIPTIVEVIDEOSVCFLAG() Getter for DESCRIPTIVEVIDEOSERVICEFLAG, with configurable de
ASK_DESCRIPTIVEVIDEOSVCFLAG() Getter for DESCRIPTIVEVIDEOSERVICEFLAG w/ exceptions if fiel
HAS_DESCRIPTIVEVIDEOSVCFLAG() Determine if DESCRIPTIVEVIDEOSERVICEFLAG has a value

IFrameOnlyManifest

Choose Include to have MediaConvert generate an HLS child manifest that lists only the I-frames for this rendition, in addition to your regular manifest for this rendition. You might use this manifest as part of a workflow that creates preview functions for your video. MediaConvert adds both the I-frame only child manifest and the regular child manifest to the parent manifest. When you don't need the I-frame only child manifest, keep the default value Exclude.

Accessible with the following methods

Method Description
GET_IFRAMEONLYMANIFEST() Getter for IFRAMEONLYMANIFEST, with configurable default
ASK_IFRAMEONLYMANIFEST() Getter for IFRAMEONLYMANIFEST w/ exceptions if field has no
HAS_IFRAMEONLYMANIFEST() Determine if IFRAMEONLYMANIFEST has a value

KlvMetadata

To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.

Accessible with the following methods

Method Description
GET_KLVMETADATA() Getter for KLVMETADATA, with configurable default
ASK_KLVMETADATA() Getter for KLVMETADATA w/ exceptions if field has no value
HAS_KLVMETADATA() Determine if KLVMETADATA has a value

ManifestMetadataSignaling

To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled. To enable Manifest metadata signaling, you must also set SCTE-35 source to Passthrough, ESAM SCTE-35 to insert, or ID3 metadata to Passthrough.

Accessible with the following methods

Method Description
GET_MANIFESTMETSIGNALING() Getter for MANIFESTMETADATASIGNALING, with configurable defa
ASK_MANIFESTMETSIGNALING() Getter for MANIFESTMETADATASIGNALING w/ exceptions if field
HAS_MANIFESTMETSIGNALING() Determine if MANIFESTMETADATASIGNALING has a value

Scte35Esam

Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML.

Accessible with the following methods

Method Description
GET_SCTE35ESAM() Getter for SCTE35ESAM, with configurable default
ASK_SCTE35ESAM() Getter for SCTE35ESAM w/ exceptions if field has no value
HAS_SCTE35ESAM() Determine if SCTE35ESAM has a value

Scte35Source

Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None if you don't want those SCTE-35 markers in this output.

Accessible with the following methods

Method Description
GET_SCTE35SOURCE() Getter for SCTE35SOURCE, with configurable default
ASK_SCTE35SOURCE() Getter for SCTE35SOURCE w/ exceptions if field has no value
HAS_SCTE35SOURCE() Determine if SCTE35SOURCE has a value

SigningKmsKey

Specify the ID or ARN of the AWS KMS key used to sign the C2PA manifest in your MP4 output. Provide a valid KMS key ARN. Note that your MediaConvert service role must allow access to this key.

Accessible with the following methods

Method Description
GET_SIGNINGKMSKEY() Getter for SIGNINGKMSKEY, with configurable default
ASK_SIGNINGKMSKEY() Getter for SIGNINGKMSKEY w/ exceptions if field has no value
HAS_SIGNINGKMSKEY() Determine if SIGNINGKMSKEY has a value

TimedMetadata

To include ID3 metadata in this output: Set ID3 metadata to Passthrough. Specify this ID3 metadata in Custom ID3 metadata inserter. MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None or leave blank.

Accessible with the following methods

Method Description
GET_TIMEDMETADATA() Getter for TIMEDMETADATA, with configurable default
ASK_TIMEDMETADATA() Getter for TIMEDMETADATA w/ exceptions if field has no value
HAS_TIMEDMETADATA() Determine if TIMEDMETADATA has a value

TimedMetadataBoxVersion

Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. Leave blank to use the default value Version 0. When you specify Version 1, you must also set ID3 metadata to Passthrough.

Accessible with the following methods

Method Description
GET_TIMEDMETADATABOXVERSION() Getter for TIMEDMETADATABOXVERSION, with configurable defaul
ASK_TIMEDMETADATABOXVERSION() Getter for TIMEDMETADATABOXVERSION w/ exceptions if field ha
HAS_TIMEDMETADATABOXVERSION() Determine if TIMEDMETADATABOXVERSION has a value

TimedMetadataSchemeIdUri

Specify the event message box (eMSG) scheme ID URI for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. Leave blank to use the default value: https://aomedia.org/emsg/ID3 When you specify a value for ID3 metadata scheme ID URI, you must also set ID3 metadata to Passthrough.

Accessible with the following methods

Method Description
GET_TIMEDMETADATASCHEMEIDURI() Getter for TIMEDMETADATASCHEMEIDURI, with configurable defau
ASK_TIMEDMETADATASCHEMEIDURI() Getter for TIMEDMETADATASCHEMEIDURI w/ exceptions if field h
HAS_TIMEDMETADATASCHEMEIDURI() Determine if TIMEDMETADATASCHEMEIDURI has a value

TimedMetadataValue

Specify the event message box (eMSG) value for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. When you specify a value for ID3 Metadata Value, you must also set ID3 metadata to Passthrough.

Accessible with the following methods

Method Description
GET_TIMEDMETADATAVALUE() Getter for TIMEDMETADATAVALUE, with configurable default
ASK_TIMEDMETADATAVALUE() Getter for TIMEDMETADATAVALUE w/ exceptions if field has no
HAS_TIMEDMETADATAVALUE() Determine if TIMEDMETADATAVALUE has a value