google/shaka-packager

Shaka Packager

!https://raw.githubusercontent.com/google/shaka-packager/master/docs/shaka-packager.png

![Build Status]([] ![Build status]([]

1. 镜像概述与主要用途

Shaka Packager 是一款用于 DASH 和 HLS 打包与加密的工具及媒体打包 SDK。它能够准备和打包媒体内容，以支持在线流媒体传输。

2. 核心功能与特性

2.1 基本支持能力

• 同时支持视频点播（Video-On-Demand）和直播（Live）场景

2.2 流媒体格式

• DASH（动态自适应流媒体）
• HLS（HTTP 实时流媒体）

2.3 密钥系统

• Widevine（Widevine DRM）
• PlayReady¹（PlayReady DRM）
• FairPlay¹（FairPlay DRM）
• Marlin¹（Marlin DRM）

2.4 加密标准

• CENC（MPEG 通用加密）
• SAMPLE-AES（样本级 AES 加密）

2.5 媒体容器与编解码器支持

注：

• I 表示输入（Input），O 表示输出（Output）
• ²：参考 HLS 打包音频规范
• ³：ISO-BMFF 中的 Opus 支持为实验性特性

2.6 字幕支持

• WebVTT（文本形式及嵌入 MP4 中）
• TTML（文本形式，仅支持 DASH）

2.7 支持平台

• Linux
• Mac
• Windows
• 支持 ARM 架构交叉编译

^{1：有限支持}

3. 使用场景与适用范围

Shaka Packager 适用于以下场景：

• 在线流媒体服务的媒体内容打包（DASH/HLS 格式）
• 视频点播（VOD）平台的内容预处理与加密
• 直播流媒体的实时打包与传输
• 需要多 DRM 系统（Widevine/PlayReady/FairPlay 等）保护的媒体内容加密
• 跨平台流媒体服务的内容适配（支持 Linux/Mac/Windows 及 ARM 设备）

4. 使用方法与配置说明

4.1 获取方式

获取 Shaka Packager 有以下途径：

• Docker 镜像：推荐使用 Docker 快速部署
• 预编译二进制：从 https://github.com/google/shaka-packager/releases 获取
• 源码构建：参考 https://github.com/google/shaka-packager/blob/master/docs/source/build_instructions.md

4.2 Docker 部署示例

4.2.1 基本 docker run 命令

通过 Docker 运行时，需将本地媒体目录挂载到容器中，基本命令格式：

bash
docker run --rm -v <本地媒体目录>:/media google/shaka-packager packager <打包参数>

示例 1：DASH 格式打包

bash
docker run --rm -v $(pwd)/media:/media google/shaka-packager packager \
  input=/media/input_video.mp4,stream=video,output=/media/video_out.mp4 \
  input=/media/input_audio.mp4,stream=audio,output=/media/audio_out.mp4 \
  --dash_output /media/dash_output

示例 2：HLS 加密打包（Widevine）

bash
docker run --rm -v $(pwd)/media:/media google/shaka-packager packager \
  input=/media/input.mp4,stream=video,output=/media/video_hls.m3u8 \
  input=/media/input.mp4,stream=audio,output=/media/audio_hls.m3u8 \
  --hls_output /media/hls_output \
  --enable_widevine_encryption \
  --key_server_url https://license-server.example.com \
  --content_id "my_content_123" \
  --signer "my_signer" \
  --aes_signing_key "00112233445566778899aabbccddeeff" \
  --aes_signing_iv "000102030405060708090a0b0c0d0e0f"

4.2.2 常用命令参数说明

查看完整参数列表：

bash
docker run --rm google/shaka-packager packager --help

5. 有用链接

• 公告列表（订阅获取版本更新和调查）
• https://google.github.io/shaka-packager/html/
• https://google.github.io/shaka-packager/html/tutorials/tutorials.html
• 推荐播放器：
  • https://github.com/google/shaka-player%EF%BC%88Web 端 DASH/HLS 播放器）
  • https://github.com/Dash-Industry-Forum/dash.js%EF%BC%88Web 端 DASH 播放器）
  • https://github.com/video-dev/hls.js%EF%BC%88Web 端 HLS 播放器）
  • https://github.com/google/ExoPlayer%EF%BC%88Android 端 DASH/HLS 播放器）