public static interface CmfcSettings.Builder extends SdkPojo, CopyableBuilder<CmfcSettings.Builder,CmfcSettings>
| Modifier and Type | Method and Description |
|---|---|
CmfcSettings.Builder |
audioDuration(CmfcAudioDuration 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.
|
CmfcSettings.Builder |
audioDuration(String 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.
|
CmfcSettings.Builder |
audioGroupId(String audioGroupId)
Specify the audio rendition group for this audio rendition.
|
CmfcSettings.Builder |
audioRenditionSets(String audioRenditionSets)
List the audio rendition groups that you want included with this video rendition.
|
CmfcSettings.Builder |
audioTrackType(CmfcAudioTrackType 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.
|
CmfcSettings.Builder |
audioTrackType(String 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.
|
CmfcSettings.Builder |
descriptiveVideoServiceFlag(CmfcDescriptiveVideoServiceFlag descriptiveVideoServiceFlag)
Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest.
|
CmfcSettings.Builder |
descriptiveVideoServiceFlag(String descriptiveVideoServiceFlag)
Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest.
|
CmfcSettings.Builder |
iFrameOnlyManifest(CmfcIFrameOnlyManifest 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.
|
CmfcSettings.Builder |
iFrameOnlyManifest(String 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.
|
CmfcSettings.Builder |
klvMetadata(CmfcKlvMetadata klvMetadata)
To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough.
|
CmfcSettings.Builder |
klvMetadata(String klvMetadata)
To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough.
|
CmfcSettings.Builder |
manifestMetadataSignaling(CmfcManifestMetadataSignaling manifestMetadataSignaling)
To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest
metadata signaling to Enabled.
|
CmfcSettings.Builder |
manifestMetadataSignaling(String manifestMetadataSignaling)
To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest
metadata signaling to Enabled.
|
CmfcSettings.Builder |
scte35Esam(CmfcScte35Esam scte35Esam)
Use this setting only when you specify SCTE-35 markers from ESAM.
|
CmfcSettings.Builder |
scte35Esam(String scte35Esam)
Use this setting only when you specify SCTE-35 markers from ESAM.
|
CmfcSettings.Builder |
scte35Source(CmfcScte35Source scte35Source)
Ignore this setting unless you have SCTE-35 markers in your input video file.
|
CmfcSettings.Builder |
scte35Source(String scte35Source)
Ignore this setting unless you have SCTE-35 markers in your input video file.
|
CmfcSettings.Builder |
timedMetadata(CmfcTimedMetadata timedMetadata)
To include ID3 metadata in this output: Set ID3 metadata to Passthrough.
|
CmfcSettings.Builder |
timedMetadata(String timedMetadata)
To include ID3 metadata in this output: Set ID3 metadata to Passthrough.
|
CmfcSettings.Builder |
timedMetadataBoxVersion(CmfcTimedMetadataBoxVersion timedMetadataBoxVersion)
Specify the event message box (eMSG) version for ID3 timed metadata in your output.
|
CmfcSettings.Builder |
timedMetadataBoxVersion(String timedMetadataBoxVersion)
Specify the event message box (eMSG) version for ID3 timed metadata in your output.
|
CmfcSettings.Builder |
timedMetadataSchemeIdUri(String timedMetadataSchemeIdUri)
Specify the event message box (eMSG) scheme ID URI for ID3 timed metadata in your output.
|
CmfcSettings.Builder |
timedMetadataValue(String timedMetadataValue)
Specify the event message box (eMSG) value for ID3 timed metadata in your output.
|
equalsBySdkFields, sdkFieldscopyapplyMutation, buildCmfcSettings.Builder audioDuration(String audioDuration)
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.CmfcAudioDuration,
CmfcAudioDurationCmfcSettings.Builder audioDuration(CmfcAudioDuration audioDuration)
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.CmfcAudioDuration,
CmfcAudioDurationCmfcSettings.Builder audioGroupId(String audioGroupId)
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.CmfcSettings.Builder audioRenditionSets(String audioRenditionSets)
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.m3u8CmfcSettings.Builder audioTrackType(String audioTrackType)
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.CmfcAudioTrackType,
CmfcAudioTrackTypeCmfcSettings.Builder audioTrackType(CmfcAudioTrackType audioTrackType)
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.CmfcAudioTrackType,
CmfcAudioTrackTypeCmfcSettings.Builder descriptiveVideoServiceFlag(String descriptiveVideoServiceFlag)
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.CmfcDescriptiveVideoServiceFlag,
CmfcDescriptiveVideoServiceFlagCmfcSettings.Builder descriptiveVideoServiceFlag(CmfcDescriptiveVideoServiceFlag descriptiveVideoServiceFlag)
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.CmfcDescriptiveVideoServiceFlag,
CmfcDescriptiveVideoServiceFlagCmfcSettings.Builder iFrameOnlyManifest(String iFrameOnlyManifest)
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.CmfcIFrameOnlyManifest,
CmfcIFrameOnlyManifestCmfcSettings.Builder iFrameOnlyManifest(CmfcIFrameOnlyManifest iFrameOnlyManifest)
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.CmfcIFrameOnlyManifest,
CmfcIFrameOnlyManifestCmfcSettings.Builder klvMetadata(String klvMetadata)
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.CmfcKlvMetadata,
CmfcKlvMetadataCmfcSettings.Builder klvMetadata(CmfcKlvMetadata klvMetadata)
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.CmfcKlvMetadata,
CmfcKlvMetadataCmfcSettings.Builder manifestMetadataSignaling(String manifestMetadataSignaling)
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.CmfcManifestMetadataSignaling,
CmfcManifestMetadataSignalingCmfcSettings.Builder manifestMetadataSignaling(CmfcManifestMetadataSignaling manifestMetadataSignaling)
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.CmfcManifestMetadataSignaling,
CmfcManifestMetadataSignalingCmfcSettings.Builder scte35Esam(String scte35Esam)
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.CmfcScte35Esam,
CmfcScte35EsamCmfcSettings.Builder scte35Esam(CmfcScte35Esam scte35Esam)
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.CmfcScte35Esam,
CmfcScte35EsamCmfcSettings.Builder scte35Source(String scte35Source)
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.CmfcScte35Source,
CmfcScte35SourceCmfcSettings.Builder scte35Source(CmfcScte35Source scte35Source)
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.CmfcScte35Source,
CmfcScte35SourceCmfcSettings.Builder timedMetadata(String timedMetadata)
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.CmfcTimedMetadata,
CmfcTimedMetadataCmfcSettings.Builder timedMetadata(CmfcTimedMetadata timedMetadata)
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.CmfcTimedMetadata,
CmfcTimedMetadataCmfcSettings.Builder timedMetadataBoxVersion(String timedMetadataBoxVersion)
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.CmfcTimedMetadataBoxVersion,
CmfcTimedMetadataBoxVersionCmfcSettings.Builder timedMetadataBoxVersion(CmfcTimedMetadataBoxVersion timedMetadataBoxVersion)
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.CmfcTimedMetadataBoxVersion,
CmfcTimedMetadataBoxVersionCmfcSettings.Builder timedMetadataSchemeIdUri(String timedMetadataSchemeIdUri)
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.CmfcSettings.Builder timedMetadataValue(String timedMetadataValue)
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.Copyright © 2023. All rights reserved.