DASH parser
This module is available to use in your EdgeWorkers code bundle to parse and modify Dynamic Adaptive Streaming over HTTP (DASH) Media Presentation Description (MPD) files.
The protocols for transferring unbounded streams of multimedia data as described in the Guidelines for Implementation: DASH-IF Interoperability Points were applied when creating this EdgeWorkers module.
Refer to Import a JavaScript module for instructions on how to load an external JavaScript module into the EdgeWorkers
main.js
file.
Code samples and use cases
Go to the the EdgeWorkers GitHub repo for access to the DASH module, the main helper class you need to import into your main.js
file and the TypeScript definition file.
To help you learn more about how to use the DASH Parser module, we've added the following use cases to this guide. You can also find the code samples in the EdgeWorkers GitHub repo.
-
Manifest and Playlist Manipulation
Dynamically create personalized renditions of available Video on demand (VOD) manifest files using the DASH parser. -
Content insertion
Dynamically add auxiliary media content to an existing Video on Demand (VOD) asset using Pre-Roll, Mid-Roll, and Post-Roll operations.
Manifest parsing
parseMPD()
Parses and creates an internal object such as a MPD file using the input text manifest. This function does not return a value.
parseMPD(textManifest)
Parameter | Type | Description |
---|---|---|
textManifest | String | The Dash MPD file contents loaded using httpRequest in responseProvider or A hardcoded Dash MPD xml string. |
getJSON()
Returns the internal object such as an MPD created using parseMPD()
.
stringifyMPD()
Converts the JavaScript Object (MPD) back to an XML string. Returns a string representation of the object parsed using parseMPD()
.
Variant Manipulation
filterRepresentationsByBandwidth()
Removes variants other than the matched bitrates passed as the input. Tolerance is also taken into account. This function does not return a value.
filterRepresentationsByBandwidth(mpd: any, ranges: string[], tolerance?: number)
Parameter | Type | Description |
---|---|---|
mpd | Any | A JSON Object returned after calling the parseMPD and getJSON() methods. |
ranges | Array of strings | Represents the bandwidths to filter-in. Bitrate Filtering supports either an array of range of values or array of values. A tolerance of Ā±100,000 is used for an array of values. For example, a parameter value of 2200000 bps will be a match for any bitrate value within 2100000 and 2300000 such as, 2185000. Inputs such as, ['600000','2000000'] or [600000-2000000', '700000-7000000'] are. both accepted. You can also pass a single value as ['1000000']. |
tolerance | Number | Optional Default value is 100000. |
filterRepresentationsByResolution()
Removes variants with resolutions higher than the specified maxSupportedResolution
. Returns true
if a variant is deleted by this function, false
otherwise.
filterRepresentationsByResolution(mpd, maxSupportedResolution)
Parameter | Type | Description |
---|---|---|
mpd | Any | JSON Object returned after calling the parseMPD and getJSON() methods. |
maxSupportedResolution | String | '320-240' |
filterAdaptationSetsByAudioLanguage()
Removes audio variants with languages not specified. This function does not return a value.
filterAdaptationSetsByAudioLanguage(mpd,language)
Parameter | Type | Description |
---|---|---|
mpd | Any | JSON Object returned after calling the parseMPD and getJSON() methods. |
languages | String Array of strings | One or more languages to filter-in. For example, ['en','fr']. |
filterAdaptationSetsBySubtitlesLanguage()
Removes subtitle variants with languages not specified. This function does not return a value.
filterAdaptationSetsBySubtitlesLanguage(mpd,language)
Parameter | Type | Description |
---|---|---|
mpd | Any | JSON Object returned after calling the parseMPD and getJSON() methods. |
language | String Array of strings | One or more languages to filter-in. For example, ['en','fr']. |
Content (bumper) insertion
The following restrictions apply to bumper insertion.
- The bumper MPD and primary MPD must be present on the origin server.
- You can insert the bumper MPD as pre (before), mid (middle), post (after) roll. The roll refers to the primary MPD.
- You need to specify the
segmentTemplate
andsegmentTimeline
and preferably use the same segment durations for audio, video, and subtitles while encoding. There is currently no error to inform you if the audio and video segment durations are incompatible. - You should configure the
afterSeconds
parameter for a mid roll bumper insertion to be greater than0
. You should also create multiple segment durations as it is not possible to split a segment.
bumperInsertion()
Used for pre, post, or mid-roll bumper insertions. This function does not return a value.
bumperInsertion(mpd: any, bumperPlaylistArrayObject: Bumper[])
Parameter | Type | Description |
---|---|---|
mpd | Any | JSON Object returned after calling the parseMPD and getJSON() methods. |
bumperPlaylistArrayObject | Bumper[] | A holder for a bumper Dash MPD, that will be inserted into the main Dash MPD at the specified duration. |
Bumper
A holder for an bumper Dash MPD, that will be inserted into the main Dash MPD at the specified duration.
Bumper = {
responseBodyObject: any;
afterSeconds: number;
};
Parameter | Type | Description |
---|---|---|
afterSeconds | Number | 0 indicates the postroll bumper insertion, where the period from the bumper MPD will be inserted at the end of the primary MPD.-1 indicates the preroll bumper insertion, where the period from the bumper MPD will be inserted at the start of primary MPD.Any other positive values such as, 10 indicates the number of seconds after which the bumper MPD will be inserted into the primary MPD. The afterSeconds parameter is relative to the primary MPD, where the bumper MPDs will be inserted. |
responseBodyObject | Object | JSON Object returned after calling parseMPD and getJSON() methods. |
Updated 3 months ago