dash.js — 浏览器 MPEG-DASH 参考播放器

是什么

dash.js 是 DASH-IF（DASH Industry Forum）维护的 JavaScript DASH 播放器：在支持 MSE 的浏览器里解析 .mpd manifest，拉取 fMP4 分片并自适应切换码率。

日常类比：HLS 像「按章节拆开的有声书」，DASH 像「带目录的 PDF 电子书」——都用清单描述片段，但标签与组织方式不同。dash.js 就是 Chrome 里的「DASH 朗读者」。

最小示例：

<video id="videoPlayer" controls></video>
<script src="https://cdn.dashjs.org/latest/modern/umd/dash.all.min.js"></script>
<script>
  const url = 'https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd';
  const player = dashjs.MediaPlayer().create();
  player.initialize(document.querySelector('#videoPlayer'), url, true);
</script>

为什么重要

不理解 dash.js，自适应流媒体标准会缺一半：

DASH 是 ISO 标准路线：广播、电信与部分 OTT 偏 MPD 而非 m3u8
官方参考实现：读源码可对齐 ABR、buffer 与 DRM 事件模型
与 [[hls.js]] 对照学协议：同一 MSE 底座，不同 manifest 语法
参考播放器在线可玩：reference.dashif.org 是调试 MPD 的第一站

核心要点

MPD 多 Period / AdaptationSet：视频、音频、字幕各一条轨道；dash.js 负责选 representation 与切换。
Segment 索引多样：SegmentTemplate、SegmentTimeline、SegmentList 都要支持，体现 DASH 表达力强于简单 m3u8。
ABR 模块可配置：默认吞吐估计 + 替换算法；直播低延迟有单独 beta 分支实验。
EME 集成：Encrypted Media Extensions 播 Widevine / PlayReady，企业点播必备。
事件驱动 API：METRIC_CHANGED、BUFFER_LEVEL 等便于埋点与 QoE 监控。
参考播放器与 samples 站：DASH-IF 维护在线 demo，改 MPD URL 即可对比不同编码参数的可播性。

实践案例

案例 1：打开 debug 日志

const player = dashjs.MediaPlayer().create({ debug: { logLevel: dashjs.Debug.LOG_LEVEL_DEBUG } });
player.initialize(video, url, true);

排查 MPD 解析失败或 404 分片时先看控制台 timeline。

案例 2：限制最大码率

player.updateSettings({
  streaming: { abr: { maxBitrate: { audio: -1, video: 1500000 } } }
});

弱网或省流量场景防止跳到 4K representation。

案例 3：对比 [[hls.js]] 同一 CDN 测试流

Akamai 等提供 DASH 与 HLS 并行 URL，可对比首帧、切换延迟与 buffer 深度。

案例 4：自建 MPD 用 ffmpeg 输出

ffmpeg -i input.mp4 -map 0 -codec copy -f dash -seg_duration 4 output.mpd

本地起静态服务器，用 dash.js 验证分片可播性。

踩过的坑

MPD 动态类型 live 窗口：timeShiftBufferDepth 设太小会导致 seek 范围意外缩短。
跨域与 Range 请求：部分 CDN 要对 .m4s 开 CORS 与 Accept-Ranges。
多 Period 广告插入：简单 VOD 教程未覆盖，实际 SSAI 需读 advanced 示例。
与 Safari 原生 HLS 无关：Safari 不原生播 DASH，别混用测试方法。
版本 modern vs legacy bundle：老浏览器要选 legacy 构建，否则 MSE codec 报错。
音画不同步：常因错误 initialization segment 或 timescale 配置，需回查 MPD 作者工具链。

适用 vs 不适用场景

适用：

Web 端播放 DASH 点播/直播
学习 MPD、ABR、MSE 企业栈
对接 DASH-IF 合规测试

不适用：

纯 HLS 环境（[[hls.js]] 更贴地）
需要极简依赖的嵌入式页（bundle 体积较大）
iOS 原生 App（系统播放器路线不同）

历史小故事（可跳过）

2012 起：DASH 标准发布，dash.js 作为行业论坛参考实现
与广播业结盟：机顶盒与 OTT 并行推进 ISO 23009
samples 站长期维护：reference.dashif.org 成为调试 MPD 的公共沙箱
与 shaka-player：Google 播放器亦支持 DASH，二者常并列阅读

学到什么

DASH 强在 manifest 表达力：多 Period、多轨道、时间线比纯 m3u8 更结构化
参考实现价值在「对齐标准」：遇到播放问题先对 reference player
ABR 算法可插拔：吞吐估计与切换策略决定 QoE
与 [[hls.js]] 共享 MSE 底座：学会一个，另一个上手快一半
生产环境常叠加分析 SDK：dash.js 事件是埋点天然钩子
先跑 reference player 再改自研页：可快速判断 MPD 问题在源还是在壳

关联

[[hls.js]] —— HLS 侧兄弟库
shaka-player —— 另一 DASH/HLS 播放器
[[video.js]] —— 可接插件统一 UI
nginx-rtmp-module —— 可输出 DASH 片段
ffmpeg —— 打包 MPD
streamlink —— 拉流与协议学习
obs-studio —— 推流源
mediasoup —— 实时会议与点播链路不同层
pion —— WebRTC 与点播播放器互补
aubio —— 音频分析侧能力扩展阅读

反向链接

（暂无反向链接）