07 July 2022
over 2 years ago by Encoding.com Product Team #2
Custom CUE point tags
Added ability to insert custom CUE points tags into HLS output formats.
Also added option to prevent video stream segmentation in given CUE point.
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required-->
<format>
<output>[advanced_hls|fmp4_hls|advanced_fmp4|advanced_dash]</output>
<!-- multiple cue_inserts may be included -->
<cue_insert>
<marker_type>custom-tag</marker_type>
<custom_tag>[CustomTag]</custom_tag>
<add_video_keyframe>[yes|no]</add_video_keyframe>
<!-- cue_insert params -->
</cue_insert>
<cue_insert>
<!-- cue_insert params -->
</cue_insert>
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "[Action]", // // requiredrequired
"source": "[SourceFile]",
"format": { // required
"output": "[advanced_hls|fmp4_hls|advanced_fmp4|advanced_dash]",
"cue_insert": [
{
"marker_type": "custom-tag",
"custom_tag": "[CustomTag]",
"add_video_keyframe": "[yes|no]"
// cue_insert params
},
{
// cue_insert params
}
]
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| marker_type (cue_insert) | Break Marker Type | For advanced_dash: • scte35-opening-credit – adds <scte35:signal /> opening credits block. • scte35-closing-credit – adds <scte35:signal /> closing credits block. • scte35-chapter-marker – adds <scte35:signal /> chapter marker block. • scte35-content-identification – adds <scte35:signal /> content identification block. For advanced_hls, fmp4_hls, advanced_fmp4: • scte35-opening-credit – adds #EXT-X-SCTE35 opening credits tag. • scte35-closing-credit – adds #EXT-X-SCTE35 closing credits tag. • scte35-chapter-marker – adds #EXT-X-SCTE35 chapter marker tag. • scte35-content-identification – adds #EXT-X-SCTE35 content identification tag. • scte35-provider-overlay – adds #EXT-X-SCTE35 provider overlay placement opportunity data. • custom-tag – adds custom CUE point tag specified in <scte35:custom_tag /> parameter. | cue-out-in |
| custom_tag | Value of custom cue_insert with "custom-tag" marker_type. | Valid HLS m3u8 tag | none |
| add_video_keyframe | Segment video stream at given CUE point | yes, no | yes |
For custom-tag marker_type and custom_tag parameter
- The <marker_type /> value custom-tag available only for <cue_insert /> of HLS output formats.
- The <custom_tag /> parameter is required for <cue_insert /> if <marker_type /> set to custom-tag.