Format Parameters

These are the general format parameters available for our adaptive outputs.

❗️

Note

Audio and video parameters aren’t applicable to the level and should instead be set in each parameter.

ParameterDescriptionAvailable ValuesDefault Value
duration_precisionSpecify the number of decimal accuracy for the duration of the playlist file.Integer0
segment_durationSpecify the duration to split output into segment files, measured in seconds.Positive float number9.0
fragment_durationSpecify the duration of fMP4 fragment inside of segment file, measured in seconds.Positive integer numberequals to <segment_duration />
pack_filesSpecify whether to package output in compressed file.yes, noyes
pack_typeSpecify the type of compressed file to package output.tar, ziptar
pack_each_streamSpecify whether or not to package each stream in its own file.yes, nono
encryptionEnable AES-128 encryption.yes, nono
encryption_methodSpecify the encryption method used.advanced_hls: aes-128-cbc, sample-aes
fmp4_hls: aes-128-cbc, mpeg_cbcs, mpeg_cens, mpeg_cbc1, mpeg_cenc
advanced_dash, advanced_mss, advanced_fmp4: mpeg_cbcs, mpeg_cens, mpeg_cbc1, mpeg_cenc
advanced_hls, fmp4_hls: aes-128-cbc
advanced_fmp4, advanced_dash, advanced_mss: mpeg_cenc
encryption_keySpecify the encryption key.32 hexidecimal characters ([0-9a-f])none
encryption_key_fileURL to encryption key file.Valid URL.none
encryption_ivSpecify the encryption initialization vector.32 hexidecimal characters ([0-9a-f]).aes-128-cbc – sequence number of the segment file,
sample-aes – randomly generated value
segmenterSpecify which segmenter to use.v1 – This is the segmenter bundled with FFMPEG and carries significant overhead (as much as 27% with a 364kbps file or 17.3% with a 864kbps file!), and generated several warnings.
v2 – This is based on HTTP Live Segmenter tool. It carries with it the same overhead, but generates far fewer warnings.
v3 – This version, we call tsparser was built in-house from the ground up to be optimized for our cloud infrastructure. This has significantly less overhead (5.8% with a 364kbps file or 3.8% with a 864kbps file), and does not generate any warnings.
dolby_segmenter – Dolby Media Generator segmenter(dolby_segmenter) will update libfaac audio codec to dolby_aac, in case libfaac codec specified. In case copy specified as audio_codec then source audio codec will be tried. In case iframe stream requested then v3 segmenter wil be used.
playlist_versionSpecify the version of the m3u8 playlist file.Integer(EXT-X-VERSION)none
merge_small_segmentsMerge the next chunk with the previous chunk if previous length is less than one second.yes, nono
dash_profileSpecify which dash output profile to use.ondemand — urn:mpeg:​dash:profile:isoff-on-demand:2011,
live — urn:mpeg:​dash:profile:isoff-live:2011,
live_static — live with mpd@type=static
ondemand
cmaf_conformantThis will create an output that is CMAF conformant.yes, nono
reduce_structural_overheadPerform reducing mpeg-ts structural overhead.yes, noyes
add_audio_onlyAdd an audio only stream to master HLS manifest.yes, noyes
init_extensionInitialization file's extension.string (max length: 4 characters)mp4
segment_extensionSegment file's extension.string (max length: 4 characters)m4s
split_segmentsSplit output to segmentsyes, noyes
widevine_drmApply Widevine DRM for whole outputyes. nono
playready_drmApply PlayReady DRM for whole outputyes. nono
hls_manifestsCreate HLS manifestsyes. noyes
dash_manifestsCreate DASH manifestsyes. noyes
mss_manifestsCreate MSS manifestsyes. nono
segment_templateSelect which SegmentTemplate placeholder will be usednumber$Number$
time$Time$
number
output_jsonUpload output format processing summary to the output destination or the specified URLyes, Valid URLnone
disable_alternate_source_indexDisable adding an alternate source index to the segment nameyes, nono

🚧

For pack_type parameter

<pack_type /> parameter is ignored if <pack_files /> is disabled.

🚧

For pack_each_stream parameter

<pack_each_stream /> parameter is ignored if <pack_files /> is disabled.

🚧

For dash_profile parameter

<dash_profile /> options available only for advanced_dash output.

🚧

For cmaf_conformant parameter

<cmaf_conformant /> feature available only for advanced_dash, fmp4_hls, advanced_fmp4, advanced_mss output formats.

🚧

For cmaf_conformant parameter

<cmaf_conformant /> feature not working with muxed streams.

🚧

For duration_precision parameter

<duration_precision /> parameter not available if parameter set to dolby_segmenter.

🚧

For reduce_structural_overhead parameter

<reduce_structural_overhead /> feature is available only for advanced_hss output format.

This feature is available only if set to v3

🚧

For add_audio_only parameter

<add_audio_only /> parameter is available only for advanced_hls, fmp4_hls, and advanced_fmp4 output formats.

It works only for unmuxed output, where audio and video are stored in separate variant streams.

🚧

For init_extension and segment_extension parameters

<init_extension /> and <segment_extension /> parameters are available only for fmp4_hls output format.

🚧

For fragment_duration parameter

<fragment_duration /> parameter is available only for advanced_fmp4 output format.

🚧

For widevine_drm and playready_drm parameters

<widevine_drm /> and <playready_drm /> parameters are available only for advanced_dash and dash manifests of advanced_fmp4 output formats.

🚧

For segment_template parameter

<segment_template /> parameter is available only for advanced_dash and advanced_fmp4 output formats.

Nielsen Metadata Settings

🚧

Note

This feature is available only for advanced_dash and advanced_hls output.

Nielsen Metadata Settings