/AWS1/CL_MDCMP4SETTINGS

These settings relate to your MP4 output container. You can create audio only outputs with this container. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/supported-codecs-containers-audio-only.html#output-codecs-and-containers-supported-for-audio-only.

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_c2pamanifest TYPE /AWS1/MDCMP4C2PAMANIFEST /AWS1/MDCMP4C2PAMANIFEST

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_cslgatom TYPE /AWS1/MDCMP4CSLGATOM /AWS1/MDCMP4CSLGATOM

When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools.

iv_cttsversion TYPE /AWS1/MDC__INTEGERMIN0MAX1 /AWS1/MDC__INTEGERMIN0MAX1

Ignore this setting unless compliance to the CTTS box version specification matters in your workflow. Specify a value of 1 to set your CTTS box version to 1 and make your output compliant with the specification. When you specify a value of 1, you must also set CSLG atom to the value INCLUDE. Keep the default value 0 to set your CTTS box version to 0. This can provide backward compatibility for some players and packagers.

iv_freespacebox TYPE /AWS1/MDCMP4FREESPACEBOX /AWS1/MDCMP4FREESPACEBOX

Inserts a free-space box immediately after the moov box.

iv_moovplacement TYPE /AWS1/MDCMP4MOOVPLACEMENT /AWS1/MDCMP4MOOVPLACEMENT

To place the MOOV atom at the beginning of your output, which is useful for progressive downloading: Leave blank or choose Progressive download. To place the MOOV at the end of your output: Choose Normal.

iv_mp4majorbrand TYPE /AWS1/MDC__STRING /AWS1/MDC__STRING

Overrides the "Major Brand" field in the output file. Usually not necessary to specify.

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.

---

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

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

CslgAtom

When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools.

Accessible with the following methods

Method	Description
GET_CSLGATOM()	Getter for CSLGATOM, with configurable default
ASK_CSLGATOM()	Getter for CSLGATOM w/ exceptions if field has no value
HAS_CSLGATOM()	Determine if CSLGATOM has a value

CttsVersion

Ignore this setting unless compliance to the CTTS box version specification matters in your workflow. Specify a value of 1 to set your CTTS box version to 1 and make your output compliant with the specification. When you specify a value of 1, you must also set CSLG atom to the value INCLUDE. Keep the default value 0 to set your CTTS box version to 0. This can provide backward compatibility for some players and packagers.

Accessible with the following methods

Method	Description
GET_CTTSVERSION()	Getter for CTTSVERSION, with configurable default
ASK_CTTSVERSION()	Getter for CTTSVERSION w/ exceptions if field has no value
HAS_CTTSVERSION()	Determine if CTTSVERSION has a value

FreeSpaceBox

Inserts a free-space box immediately after the moov box.

Accessible with the following methods

Method	Description
GET_FREESPACEBOX()	Getter for FREESPACEBOX, with configurable default
ASK_FREESPACEBOX()	Getter for FREESPACEBOX w/ exceptions if field has no value
HAS_FREESPACEBOX()	Determine if FREESPACEBOX has a value

MoovPlacement

To place the MOOV atom at the beginning of your output, which is useful for progressive downloading: Leave blank or choose Progressive download. To place the MOOV at the end of your output: Choose Normal.

Accessible with the following methods

Method	Description
GET_MOOVPLACEMENT()	Getter for MOOVPLACEMENT, with configurable default
ASK_MOOVPLACEMENT()	Getter for MOOVPLACEMENT w/ exceptions if field has no value
HAS_MOOVPLACEMENT()	Determine if MOOVPLACEMENT has a value

Mp4MajorBrand

Overrides the "Major Brand" field in the output file. Usually not necessary to specify.

Accessible with the following methods

Method	Description
GET_MP4MAJORBRAND()	Getter for MP4MAJORBRAND, with configurable default
ASK_MP4MAJORBRAND()	Getter for MP4MAJORBRAND w/ exceptions if field has no value
HAS_MP4MAJORBRAND()	Determine if MP4MAJORBRAND 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