Skip to content

/AWS1/CL_MDCHLSSETTINGS

Settings for HLS output groups

CONSTRUCTOR

IMPORTING

Optional arguments:

IV_AUDIOGROUPID TYPE /AWS1/MDC__STRING /AWS1/MDC__STRING

Specifies the group to which the audio rendition belongs.

IV_AUDIOONLYCONTAINER TYPE /AWS1/MDCHLSAUDIOONLYCONTAINER /AWS1/MDCHLSAUDIOONLYCONTAINER

Use this setting only in audio-only outputs. Choose MPEG-2 Transport Stream (M2TS) to create a file in an MPEG2-TS container. Keep the default value Automatic to create an audio-only file in a raw container. Regardless of the value that you specify here, if this output has video, the service will place the output into an MPEG2-TS container.

IV_AUDIORENDITIONSETS TYPE /AWS1/MDC__STRING /AWS1/MDC__STRING

List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.

IV_AUDIOTRACKTYPE TYPE /AWS1/MDCHLSAUDIOTRACKTYPE /AWS1/MDCHLSAUDIOTRACKTYPE

Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO

IV_DESCRIPTIVEVIDEOSVCFLAG TYPE /AWS1/MDCHLSDESCRIPTIVEVIDEO00 /AWS1/MDCHLSDESCRIPTIVEVIDEO00

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/MDCHLSIFRAMEONLYMANIFEST /AWS1/MDCHLSIFRAMEONLYMANIFEST

Choose Include to have MediaConvert generate a 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_SEGMENTMODIFIER TYPE /AWS1/MDC__STRING /AWS1/MDC__STRING

Use this setting to add an identifying string to the filename of each segment. The service adds this string between the name modifier and segment index number. You can use format identifiers in the string. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/using-variables-in-your-job-settings.html


Queryable Attributes

AudioGroupId

Specifies the group to which the audio rendition belongs.

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

AudioOnlyContainer

Use this setting only in audio-only outputs. Choose MPEG-2 Transport Stream (M2TS) to create a file in an MPEG2-TS container. Keep the default value Automatic to create an audio-only file in a raw container. Regardless of the value that you specify here, if this output has video, the service will place the output into an MPEG2-TS container.

Accessible with the following methods

Method Description
GET_AUDIOONLYCONTAINER() Getter for AUDIOONLYCONTAINER, with configurable default
ASK_AUDIOONLYCONTAINER() Getter for AUDIOONLYCONTAINER w/ exceptions if field has no
HAS_AUDIOONLYCONTAINER() Determine if AUDIOONLYCONTAINER has a value

AudioRenditionSets

List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.

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

Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO

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

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 a 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

SegmentModifier

Use this setting to add an identifying string to the filename of each segment. The service adds this string between the name modifier and segment index number. You can use format identifiers in the string. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/using-variables-in-your-job-settings.html

Accessible with the following methods

Method Description
GET_SEGMENTMODIFIER() Getter for SEGMENTMODIFIER, with configurable default
ASK_SEGMENTMODIFIER() Getter for SEGMENTMODIFIER w/ exceptions if field has no val
HAS_SEGMENTMODIFIER() Determine if SEGMENTMODIFIER has a value