google/edash-packager

eDash Packager Docker镜像文档

镜像概述

eDash Packager是一个媒体打包SDK，旨在供C++程序员编写支持通用加密（Common Encryption）、Widevine DRM、直播（Live）和视频点播（Video-On-Demand）的DASH打包应用程序。该镜像提供了在Docker环境中运行eDash Packager的便捷方式，支持跨平台使用，尤其适用于非Linux和MacOSX系统。

核心功能与特性

支持的编解码器

注：I表示输入，O表示输出。新格式支持将在后续更新。

主要特性

• 支持通用加密（CENC），可将视频重新封装并加密为分片ISO BMFF格式
• 支持Widevine DRM加密与解密
• 支持直播和视频点播场景
• DASH打包API设计便于扩展至更多源和目标格式
• 提供DASH-IF IOP合规性支持，可通过标志启用合规MPD生成

使用场景

• 视频点播（VOD）内容的DASH打包与加密
• 直播流的DASH格式封装与密钥轮换
• 跨平台媒体处理流程集成
• 支持多种编解码器的媒体文件转换与封装

Docker使用方法

前提条件

• 安装Docker环境，参考Docker安装文档

获取镜像

方式1：从Dockerhub拉取预构建镜像

Shell
docker pull google/edash-packager

方式2：本地构建镜像

Shell
docker build -t google/edash-packager github.com/google/edash-packager.git

运行容器

将本地媒体目录挂载到容器中（替换/your_media_path为实际媒体文件夹路径）：

Shell
docker run -v /your_media_path/:/media -it --rm google/edash-packager

测试示例

进入容器后，在挂载的媒体目录中执行打包命令：

Shell
# 进入媒体目录
cd /media

# 视频点播（VOD）：MP4转DASH
packager input=/media/example.mp4,stream=audio,output=audio.mp4 \
         input=/media/example.mp4,stream=video,output=video.mp4 \
         --profile on-demand --mpd_output example.mpd

# 退出容器
exit

输出文件将保存在本地的/your_media_path目录中。

高级用法示例

直播流打包

Shell
packager \
  'input=udp://224.1.1.5:5003,stream=audio,init_segment=live-audio.mp4,segment_template=live-audio-$Number$.mp4,bandwidth=130000'  \
  'input=udp://224.1.1.5:5003,stream=video,init_segment=live-video-sd.mp4,segment_template=live-video-sd-$Number$.mp4,bandwidth=2000000' \
  'input=udp://224.1.1.5:5002,stream=video,init_segment=live-video-hd.mp4,segment_template=live-video-hd-$Number$.mp4,bandwidth=5000000' \
--profile live \
--mpd_output live.mpd

Widevine加密

Shell
packager input=sintel.mp4,stream=video,output=encrypted_sintel.mp4 \
--enable_widevine_encryption \
--key_server_url "https://license.uat.widevine.com/cenc/getcontentkey/widevine_test" \
--content_id "3031323334353637" \
--signer "widevine_test" \
--rsa_signing_key_path "widevine_test_private.der"

密钥轮换（仅直播模式支持）

Shell
packager \
  'input=udp://224.1.1.5:5003,stream=audio,init_segment=live-audio.mp4,segment_template=live-audio-$Number$.mp4,bandwidth=130000'  \
  'input=udp://224.1.1.5:5003,stream=video,init_segment=live-video-sd.mp4,segment_template=live-video-sd-$Number$.mp4,bandwidth=2000000' \
  'input=udp://224.1.1.5:5002,stream=video,init_segment=live-video-hd.mp4,segment_template=live-video-hd-$Number$.mp4,bandwidth=5000000' \
--profile live \
--mpd_output live.mpd \
--enable_widevine_encryption \
--key_server_url "https://license.uat.widevine.com/cenc/getcontentkey/widevine_test" \
--content_id "3031323334353637" \
--signer "widevine_test" \
--aes_signing_key "1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9" \
--aes_signing_iv "d58ce954203b7c9a9a9d467f59839249" \
--crypto_period_duration 1800

DASH-IF IOP合规性

默认情况下，eDash Packager已基本符合DASH-IF IOP规范，存在两个例外：

• ContentProtection元素位于Representation元素下（而非AdaptationSet）
• 使用不同密钥加密的Representation位于同一AdaptationSet下

通过启用--generate_dash_if_iop_compliant_mpd标志可解决上述问题，该标志将在未来版本中默认启用。

设计概述

主要模块包括：

• Demuxer：从多媒体文件中提取 elementary stream 样本，支持通过KeySource解密CENC和WVM源内容
• Muxer：接收 elementary stream 样本并生成媒体片段，支持通过KeySource生成加密输出
• MediaStream：连接Demuxer和Muxer，负责两者间的交互
• MpdBuilder：根据ISO/IEC 23009-1 DASH MPD规范创建媒体呈现描述（MPD）

详细设计请参考设计文档和API文档。

邮件列表

可通过公共邮件列表进行讨论和获取公告，加入列表可接收新版本通知、提问或讨论eDash Packager开发。