HLS EXT-X-DATERANGE ad markers in AWS Elemental MediaPackage - AWS Elemental MediaPackage v2
Enabling daterange via the MediaPackage API or AWS SDKExample HLS manifest showing SCTE-35 EXT-X-DATERANGE signaling

HLS EXT-X-DATERANGE ad markers in AWS Elemental MediaPackage

Daterange ad markers are used to signal ads and program transitions in live HLS manifests. When you enable daterange ad markers on your origin endpoint, MediaPackage inserts EXT-X-DATERANGE tags into the manifest where there are SCTE-35 time_signal or splice_insert tags present. EXT-X-DATERANGE is used in concert with EXT-X-PROGRAM-DATE-TIME tags.

For information about the EXT-X-DATERANGE and EXT-X-PROGRAM-DATE-TIME tags for HLS, see the HTTP Live Streaming 2nd Edition Specification.

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

Console

To enable daterange 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 Daterange.

If you choose daterange, you must also enter a Program date/time interval (sec.) value of 1 or greater. The program date/time interval is set in the same manifest fields as the ad marker settings.

AWS CLI

To enable daterange 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 mediapackage --region region create-origin-endpoint --channel-id test_channel --id hlsmuxed
  --hls-package "{\"ProgramDateTimeIntervalSeconds\":60,\"AdMarkers\":\"DATERANGE\"}"
Important

You must set a ProgramDateTimeIntervalSeconds value that's greater than 0 (zero).

API and SDK

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

Enabling daterange via the MediaPackage API or AWS SDK

To learn how to enable daterange 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 EXT-X-DATERANGE signaling

This example shows a HLS manifest generated by MediaPackage using EXT-X-DATERANGE and EXT-X-PROGRAM-DATE-TIME tags to signal events in the live stream.

Note

The DURATION, PLANNED-DURATION, and END-DATE attributes of the EXT-X-DATERANGE tag are optional. If these attributes aren't present in the SCTE-35 input, or aren't set when you create your origin endpoint via the MediaPackage API, then they are omitted from the generated manifests.

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:8
#EXT-X-MEDIA-SEQUENCE:11
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2020-05-03T00:01:00.018Z",PLANNED-DURATION=29.988,SCTE35-OUT=0xFC303000000002CDE400FFF00506FE00526C14001A021843554549900000017FC00000292EA80A04ABCD0001300000D6F17117
#EXT-X-DATERANGE:ID="2147483649",START-DATE="2020-05-03T00:00:30.030Z",PLANNED-DURATION=90.006,SCTE35-CMD=0xFC303000000002CDE400FFF00506FE00293D6C001A021843554549800000017FFF00007B9ABC0A04ABCD0001100000680F3B4B
#EXT-X-PROGRAM-DATE-TIME:2020-05-03T00:01:08.040Z
#EXTINF:7.560,
index_1_11.ts?m=1588607409
#EXTINF:7.560,
index_1_12.ts?m=1588607409
#EXTINF:6.846,
index_1_13.ts?m=1588607409
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2020-05-03T00:01:00.018Z",END-DATE="2020-05-03T00:01:30.006Z",DURATION=29.988
#EXTINF:0.714,
index_1_14.ts?m=1588607409
#EXTINF:7.560,
index_1_15.ts?m=1588607409
#EXTINF:7.560,
index_1_16.ts?m=1588607409
#EXTINF:7.560,
index_1_17.ts?m=1588607409
#EXTINF:6.636,
index_1_18.ts?m=1588607409
#EXT-X-DATERANGE:ID="2147483649",START-DATE="2020-05-03T00:00:30.030Z",END-DATE="2020-05-03T00:02:00.036Z",DURATION=90.006,SCTE35-CMD=0xFC304A00000002CDE400FFF00506FE00A4D8280034021843554549800000017FC000000000000A04ABCD0001110000021843554549800000027FFF00007B9ABC0A04ABCD000210000061166A61
#EXT-X-DATERANGE:ID="2147483650",START-DATE="2020-05-03T00:02:00.036Z",PLANNED-DURATION=90.006,SCTE35-CMD=0xFC304A00000002CDE400FFF00506FE00A4D8280034021843554549800000017FC000000000000A04ABCD0001110000021843554549800000027FFF00007B9ABC0A04ABCD000210000061166A61
#EXTINF:0.924,
index_1_19.ts?m=1588607409
#EXTINF:7.560,
index_1_20.ts?m=1588607409
#EXT-X-PROGRAM-DATE-TIME:2020-05-03T00:02:08.520Z
#EXTINF:7.560,
index_1_21.ts?m=1588607409
#EXT-X-ENDLIST