Crate dash_mpd

Expand description

A Rust library for parsing and downloading media content from a DASH MPD manifest, as used for on-demand replay of TV content and video streaming services.

DASH (dynamic adaptive streaming over HTTP), also called MPEG-DASH, is a technology used for media streaming over the web, commonly used for video on demand (VOD) services. The Media Presentation Description (MPD) is a description of the resources (manifest or “playlist”) forming a streaming service, that a DASH client uses to determine which assets to request in order to perform adaptive streaming of the content. DASH MPD manifests can be used both with content encoded as MPEG and as WebM.

This library provides a serde-based parser for the DASH MPD format, as formally defined in ISO/IEC standard 23009-1:2019. XML schema files are available for no cost from ISO. When MPD files in practical use diverge from the formal standard, this library prefers to interoperate with existing practice.

The library also provides experimental support for downloading content (audio or video) described by an MPD manifest. This involves selecting the alternative with the most appropriate encoding (in terms of bitrate, codec, etc.), fetching segments of the content using HTTP or HTTPS requests (this functionality depends on the reqwest crate) and muxing audio and video segments together (using ffmpeg via the ac_ffmpeg crate).

DASH features supported

VOD (static) stream manifests
Multi-period content
XLink elements (only with actuate=onLoad semantics, resolve-to-zero supported)
All forms of segment index info: SegmentBase@indexRange, SegmentTimeline, SegmentTemplate@duration, SegmentTemplate@index, SegmentList
Media containers of types supported by mkvmerge, ffmpeg or VLC (this includes Matroska, ISO-BMFF / CMAF / MP4, WebM, MPEG-2 TS)

Limitations / unsupported features

Dynamic MPD manifests, that are used for live streaming/OTT TV
Encrypted content using DRM such as Encrypted Media Extensions (EME) and Media Source Extension (MSE)
Subtitles (eg. WebVTT and TTML streams)
XLink with actuate=onRequest

Modules

fetch

Support for downloading content from DASH MPD media streams.

Structs

Accessibility

Specifies the accessibility scheme used by the media content.

AdaptationSet

Contains a set of Representations. For example, if multiple language streams are available for the audio content, each one can be in its own AdaptationSet.

AudioChannelConfiguration

Specifies information concerning the audio channel (eg. stereo, multichannel).

BaseURL

A URI string that specifies one or more common locations for Segments and other resources.

Binary

CencPssh

A Common Encryption “Protection System Specific Header” box. Content is typically base64 encoded.

ContentComponent

Describes a media content component.

ContentProtection

Contains information on DRM (rights management / encryption) mechanisms used in the stream, such as Widevine and Playready. Note that this library is not able to download content with DRM. If this node is not present, no content protection is applied by the source.

Copyright

Copyright information concerning the media stream.

Event

A DASH event.

EventStream

Initialization

The first media segment in a sequence of Segments. Subsequent segments can be concatenated to this segment to produce a media stream.

Latency

Location

A URI string to which a new request for an updated manifest should be made. This feature is intended for servers and clients that can’t use sticky HTTP redirects.

MPD

The root node of a parsed DASH MPD manifest.

Period

Describes a chunk of the content with a start time and a duration. Content can be split up into multiple periods (such as chapters, advertising segments).

PlaybackRate

ProgramInformation

Metainformation concerning the media stream (title, language, etc.)

Representation

A representation describes a version of the content, using a specific encoding and bitrate. Streams often have multiple representations with different bitrates, to allow the client to select that most suitable to its network conditions.

Resync

Role

The purpose of this media stream, such as captions, subtitle, main, alternate, supplementary, commentary, and dub.

S

Describes a sequence of contiguous Segments with identical duration.

SegmentBase

Specifies some common information concerning media segments.

SegmentList

Contains a sequence of SegmentURL elements.

SegmentTemplate

Allows template-based SegmentURL construction. Specifies various substitution rules using dynamic values such as $Time$ and $Number$ that map to a sequence of Segments.

SegmentTimeline

Contains a sequence of S elements, each of which describes a sequence of contiguous segments of identical duration.

SegmentURL

The URL of a media segment.

ServiceDescription

Signal

Source

The original source of the media stream.

Title

The title of the media stream.

UTCTiming

Viewpoint