HLS CUE tag ad markers in AWS Elemental MediaPackage - AWS Elemental MediaPackage v2
Example HLS manifest showing SCTE-35 CUE tag signaling

HLS CUE tag ad markers in AWS Elemental MediaPackage

CUE tag ad markers are used to signal ads and program transitions in live HLS manifests using industry-standard CUE tags. When you enable SCTE-35 enhanced ad markers on your HLS or LLHLS origin endpoint, MediaPackage inserts EXT-X-CUE-OUT, EXT-X-CUE-IN, and related CUE tags into the manifest where there are SCTE-35 time_signal or splice_insert tags present. This format provides the same SCTE-35 information as DATERANGE tags but in a different manifest format that's compatible with legacy ad insertion systems.

The CUE tags generated by MediaPackage include:

  • EXT-X-CUE-OUT - Signals the start of an ad break

  • EXT-X-CUE-IN - Signals the end of an ad break

  • EXT-X-CUE-OUT-CONT - Continuation of ad break across segments

  • EXT-OATCLS-SCTE35 - OATCLS-specific SCTE-35 data

  • EXT-X-ASSET - Asset identification tags

For information about CUE tags for HLS, see the HTTP Live Streaming 2nd Edition Specification.

The following table describes how to enable CUE tag ad markers in MediaPackage.

Console

To enable CUE tag ad markers when creating or editing an origin endpoint, in the MediaPackage console, under the HLS or LL-HLS manifest settings, SCTE configuration, Ad markers, choose SCTE-35 enhanced.

AWS CLI

To enable CUE tag ad markers for your origin endpoint, run the following command in the AWS CLI replacing region with your own information:

  aws --endpoint=https://mediapackagev2.region.amazonaws.com mediapackagev2 --region region create-origin-endpoint --channel-group-name test_channel_group --channel-name test_channel --origin-endpoint-name hls_endpoint
  --hls-manifests "[{\"ManifestName\":\"main\",\"ScteHls\":{\"AdMarkerHls\":\"SCTE35_ENHANCED\"}}]"
API and SDK

To learn how to enable CUE tag ad markers for TS and CMAF origin endpoints via the MediaPackage live API or AWS SDK, see the following:

Example HLS manifest showing SCTE-35 CUE tag signaling

This example shows a HLS manifest generated by MediaPackage using CUE tags to signal events in the live stream.

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:8
#EXT-X-MEDIA-SEQUENCE:11
#EXTINF:3.3600001,
segment_h264_720p25_731013628.ts
#EXT-OATCLS-SCTE35:/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXT-X-ASSET:CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531
#EXT-X-CUE-OUT:30.04
#EXTINF:3.36,
segment_h264_720p25_731013629.ts
#EXT-X-CUE-OUT-CONT:ElapsedTime=3.36,Duration=30.04,CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531,SCTE35=/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXTINF:2.4,
segment_h264_720p25_731013630.ts
#EXT-X-CUE-OUT-CONT:ElapsedTime=5.76,Duration=30.04,CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531,SCTE35=/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXTINF:2.4,
segment_h264_720p25_731013631.ts
...
#EXT-X-CUE-OUT-CONT:ElapsedTime=27.36,Duration=30.04,CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531,SCTE35=/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXTINF:2.68,
segment_h264_720p25_731013640.ts
#EXT-OATCLS-SCTE35:/DBaAAAAAAAAAP/wBQb/tpyBAABEAkJDVUVJBAAAE3+/DjNCOlAySW5uaW5nMU92ZXIzLFA6UDIsVDpPdmVyLFM6MyxJOjEsQzpQUi0yNS0wMTgzNTE1AAD7WvT6
#EXT-X-CUE-IN
#EXTINF:2.4,
segment_h264_720p25_731013641.ts
#EXT-X-ENDLIST