局限性/不受支持的特性

• 我们无法从用于实时流媒体/OTT 电视的 动态 MPD 清单 中下载内容。这是因为我们没有实现所需的时钟功能，以了解何时新的媒体段可用，也没有实现带宽管理功能，允许自适应流媒体。然而，请注意，一些 OTT 提供商对不进行实时直播的内容（即所有媒体段都可用）公开了动态清单，我们可以以“尽可能快”的模式下载这些内容。您可以使用 allow_live_streams() 方法在 DashDownloader 上尝试从这些“伪实时”流中下载。指定 force_duration(secs) 并使用 sleep_between_requests() 也可能很有用，以确保下载速度不超过实时。

  另一种技术是使用 XSLT 样式表 tests/fixtures/rewrite-drop-dynamic.xslt 在下载之前将 dynamic 属性更改为 static，这应该允许您下载此类内容。

• 不支持具有 actuate=onRequest 语义的 XLink。

• HLS 流媒体（m3u8 清单）。

• 微软平滑流媒体。

不同流优先选项的优先级

该库允许您在DASHManifest（音频语言、视频分辨率、带宽/质量、角色标签）中表达对多个流特性的偏好排序。以下列表指定了处理这些偏好的顺序

• 首先过滤出与我们的语言偏好不对应的Manifest中的AdaptationSets。如果没有指定语言偏好，则不进行过滤。如果有多个AdaptationSets匹配语言偏好，它们都将传递到下一阶段的过滤。

• 根据角色偏好选择适配。如果没有指定角色偏好，则不根据角色标签进行过滤。如果没有适配匹配我们的任何角色偏好，则不根据角色标签进行过滤。如果至少有一个适配匹配所表达的角色偏好中的一个，则只将位于角色偏好列表首部的适配传递到下一阶段的过滤。

• 当存在多个Representation元素时，根据任何指定的质量偏好进行过滤。如果没有指定质量偏好，则不进行过滤。过滤基于Representation元素上指定的@qualityRanking属性，如果指定，否则基于指定的@bandwidth属性。请注意，当使用不同的编解码器时，质量排名可能与带宽排名不同。

• 如果指定了视频宽度偏好，则只选择视频宽度最接近请求宽度的Representation。

• 如果指定了视频高度偏好，则只选择视频高度最接近请求高度的Representation。

• 在所有前面的步骤之后，如果有多个流仍然在考虑中，则选择DASHManifest XML中首先出现的第一个流。

用法

将MPDManifest的内容解析（反序列化）到Rust结构体中

use std::time::Duration;
use dash_mpd::{MPD, parse};

fn main() {
    let client = reqwest::blocking::Client::builder()
        .timeout(Duration::new(30, 0))
        .build()
        .expect("creating HTTP client");
    let xml = client.get("https://rdmedia.bbc.co.uk/testcard/vod/manifests/avc-ctv-stereo-en.mpd")
        .header("Accept", "application/dash+xml,video/vnd.mpeg.dash.mpd")
        .send()
        .expect("requesting MPD content")
        .text()
        .expect("fetching MPD content");
    let mpd: MPD = parse(&xml)
        .expect("parsing MPD");
    if let Some(pi) = mpd.ProgramInformation {
        if let Some(title) = pi.Title {
            println!("Title: {:?}", title.content);
        }
        if let Some(source) = pi.Source {
            println!("Source: {:?}", source.content);
        }
    }
    for p in mpd.periods {
        if let Some(d) = p.duration {
            println!("Contains Period of duration {d:?}");
        }
    }
}

有关更多信息，请参阅示例dash_stream_info.rs。

以编程方式生成MPDManifest

use dash_mpd::{MPD, ProgramInformation, Title};

fn main() {
   let pi = ProgramInformation {
       Title: Some(Title { content: Some("My serialization example".into()) }),
       lang: Some("eng".into()),
       moreInformationURL: Some("https://github.com/emarsden/dash-mpd-rs".into()),
       ..Default::default()
   };
   let mpd = MPD {
       mpdtype: Some("static".into()),
       xmlns: Some("urn:mpeg:dash:schema:mpd:2011".into()),
       ProgramInformation: Some(pi),
       ..Default::default()
   };

   let xml = mpd.to_string();
}

有关更多详细信息，请参阅示例serialize.rs。

从MPDManifest中下载内容

use dash_mpd::fetch::DashDownloader;

let url = "https://storage.googleapis.com/shaka-demo-assets/heliocentrism/heliocentrism.mpd";
match DashDownloader::new(url)
       .worst_quality()
       .download().await
{
   Ok(path) => println!("Downloaded to {path:?}"),
   Err(e) => eprintln!("Download failed: {e:?}"),
}

有关更多详细信息，请参阅示例download_bbc.rs。

一个提供方便命令行界面的下载功能的应用程序可以作为dash-mpd-cli crate单独使用。

安装

将其添加到您的Cargo.toml文件中

[dependencies]
dash-mpd = "0.17.0"

如果您不需要下载功能并希望减小代码大小，请使用

[dependencies]
dash-mpd = { version = "0.17.0", default-features = false }

尽管此crate的版本号为0.x，但我们将努力使用语义版本控制：需要用户更改库中代码的重大更改（如属性名称或类型更改）将在主版本中发布。对于版本号0.y.z，主版本意味着对y的更改。

可选功能

以下可添加的Cargo功能可以启用

• fetch （默认启用）：启用下载流内容的支持。这占用了库的大部分代码大小，因此如果您只需要用于序列化和反序列化MPD的结构定义，请禁用它。

• socks （默认启用）：在reqwest依赖项上启用socks功能，为HTTP/HTTPS请求提供SOCKS5代理支持。

• compression （默认启用）：在reqwest依赖项上启用gzip功能，以启用HTTP/HTTPS请求的gzip压缩和解压缩。

• native-tls (默认启用)：在我们的 reqwest 依赖项上启用原生-tls 功能，以使用平台默认的 TLS 实现来启用 HTTPS 请求。

• rustls-tls：在我们的 reqwest 依赖项上启用 rustls-tls 功能（使用 rustls 而不是系统原生 TLS）。您可能需要启用此功能（并构建不带 native-tls），以便在 Linux 上与 musl-libc 目标进行静态链接。

• libav：通过 ac-ffmpeg crate 启用链接到 ffmpeg 的库以支持复用（而不是调用 mkvmerge、ffmpeg 或 vlc 作为子进程）。

• hickory-dns：在我们的 reqwest 依赖项上启用 hickory-dns 功能，使用 Hickory DNS 解析库 而不是系统解析器。（此功能之前命名为 trust-dns，根据 Hickory DNS 解析器的旧名称。该功能的旧名称仍然被接受，但已弃用。）

• scte35 (默认启用)：启用对应于 SCTE-35 标准的 XML 元素以插入替代内容（主要用于动态插入广告）的支持。

• warn_ignored_elements：如果启用此功能，在解析 manifest 时，如果 DASH manifest 中存在的 XML 元素没有被反序列化为 Rust 结构体，将发出警告。默认行为是忽略我们未定义 serde 反序列化指令的元素。此功能使用 serde_ignored crate 实现。

平台

此 crate 在以下平台上进行了测试

• Linux，具有默认功能（使用 mkvmerge、ffmpeg、vlc 或 MP4Box 作为子进程进行复用）和 libav 支持，在 AMD64 和 Aarch64 架构上。这是作者使用的平台，因此是最经过测试的平台。

• MacOS/Aarch64，没有 libav 功能（在当前 ffmpeg 上构建 ac-ffmpeg crate 时存在问题）

• Microsoft Windows 10 和 Windows 11，没有 libav 功能

• 通过 termux 在 Aarch64 上运行 Android 12，没有 libav 功能。您需要安装 rust、binutils、ffmpeg 和 protobuf 软件包。

• FreeBSD/AMD64 和 OpenBSD/AMD64，没有 libav 功能。但是请注意，我们用于复用或解密媒体内容的某些外部实用程序在这些平台上支持不佳。

• Solaris 11.4 在 AMD64 和 Sparc 上（您可能需要将 CC 设置为 gcc 以构建 protobuf-src crate）。

为什么？

此库的开发是为了让作者在健身房时能够观看由公共媒体广播机构制作的新闻节目。该节目作为广播机构“重播”服务上的 DASH 流发布，但健身房的网络服务有时较差。第一世界的问题！

作者既不是道德警察也不是律师，但请注意，如果您未制作的内容进行分发，可能违反知识产权法。此外，在某些国家/地区，绕过 DRM 可能是禁止的。

许可

本项目采用 MIT 许可证授权。有关更多信息，请参阅 LICENSE-MIT 文件。

欢迎补丁和 pull request。