unifiedstreaming/unified_capture

Unified Streaming 命令行工具 Docker 镜像

镜像概述和主要用途

本镜像集合为Unified Streaming命令行工具提供Docker化部署，包含mp4split、cpix_verify、manifest_edit等多个工具，用于媒体文件处理、CPIX验证、DASH/HLS manifest编辑、输入流推送等媒体相关任务。无需本地安装依赖，通过容器化方式便捷运行，适用于媒体服务开发、测试及生产环境。

核心功能和特性

包含的工具镜像

Docker镜像发布于Docker Hub，格式为unifiedstreaming/<tool>，包含以下工具：

• unifiedstreaming/mp4split：媒体文件处理工具
• unifiedstreaming/cpix_verify：CPIX文档验证工具
• unifiedstreaming/manifest_edit：DASH/HLS manifest编辑工具（需安装Python及相关包）
• unifiedstreaming/push_input_stream：输入流推送工具
• unifiedstreaming/unified_capture：媒体捕获工具
• unifiedstreaming/unified_remix：媒体重混工具

版本支持

• GA版本：默认标签为latest，指定版本格式为<version>（如1.11.9）
• Beta版本：标签格式为<version>-beta（如1.11.10-beta）

便捷特性

• 基于mp4split镜像构建，减少冗余依赖
• 提供shell函数简化工具调用流程
• 自动挂载当前工作目录至容器/data，并设为工作目录
• 支持传递UspLicenseKey环境变量，实现授权验证

使用场景和适用范围

• 媒体文件处理：通过mp4split进行MP4文件分割、加密、碎片化等操作
• CPIX验证：使用cpix_verify验证DRM相关的CPIX文档有效性
• Manifest编辑：通过manifest_edit修改DASH/HLS的manifest文件属性
• 输入流管理：使用push_input_stream推送媒体输入流至处理系统
• 媒体捕获与重混：通过unified_capture捕获实时媒体流，unified_remix进行媒体内容重混

详细使用方法和配置说明

前提条件

• 已安装Docker引擎
• （可选）有效的UspLicenseKey授权密钥（部分工具功能需要）

使用Shell函数简化运行

推荐将以下shell函数添加至bash、zsh等shell配置文件（如~/.bashrc、~/.zshrc），简化工具调用：

bash
#!/bin/sh
# Unified Streaming 命令行工具 Docker 辅助函数

mp4split() {
  BASE_IMAGE=docker.io/unifiedstreaming/mp4split
  case $1 in
    1.[0-9]*.[0-9]* ) IMAGE=${BASE_IMAGE}:$1; shift ;;
    * ) IMAGE=${BASE_IMAGE}:latest; docker pull $IMAGE ;;
  esac
  docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data $IMAGE "$@"
}

cpix_verify() {
  BASE_IMAGE=docker.io/unifiedstreaming/cpix_verify
  case $1 in
    1.[0-9]*.[0-9]* ) IMAGE=${BASE_IMAGE}:$1; shift ;;
    * ) IMAGE=${BASE_IMAGE}:latest; docker pull $IMAGE ;;
  esac
  docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data $IMAGE "$@"
}

manifest_edit() {
  BASE_IMAGE=docker.io/unifiedstreaming/manifest_edit
  case $1 in
    1.[0-9]*.[0-9]* ) IMAGE=${BASE_IMAGE}:$1; shift ;;
    * ) IMAGE=${BASE_IMAGE}:latest; docker pull $IMAGE ;;
  esac
  docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data $IMAGE "$@"
}

push_input_stream() {
  BASE_IMAGE=docker.io/unifiedstreaming/push_input_stream
  case $1 in
    1.[0-9]*.[0-9]* ) IMAGE=${BASE_IMAGE}:$1; shift ;;
    * ) IMAGE=${BASE_IMAGE}:latest; docker pull $IMAGE ;;
  esac
  docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data $IMAGE "$@"
}

unified_capture() {
  BASE_IMAGE=docker.io/unifiedstreaming/unified_capture
  case $1 in
    1.[0-9]*.[0-9]* ) IMAGE=${BASE_IMAGE}:$1; shift ;;
    * ) IMAGE=${BASE_IMAGE}:latest; docker pull $IMAGE ;;
  esac
  docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data $IMAGE "$@"
}

unified_remix() {
  BASE_IMAGE=docker.io/unifiedstreaming/unified_remix
  case $1 in
    1.[0-9]*.[0-9]* ) IMAGE=${BASE_IMAGE}:$1; shift ;;
    * ) IMAGE=${BASE_IMAGE}:latest; docker pull $IMAGE ;;
  esac
  docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data $IMAGE "$@"
}

添加后执行source ~/.bashrc使函数生效。

基本使用方法

运行最新版本

直接调用工具名称，默认拉取并运行latest标签镜像：

bash
# 查看mp4split版本和许可证信息
mp4split --show_license

指定GA版本

将版本号作为第一个参数传递：

bash
# 运行mp4split 1.11.9版本
mp4split 1.11.9 --show_license

运行Beta版本

版本号后添加-beta：

bash
# 运行mp4split 1.11.10-beta版本
mp4split 1.11.10-beta --show_license

直接使用Docker命令运行

未使用shell函数时，可直接通过docker run命令运行：

bash
# 运行mp4split最新版本
docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data docker.io/unifiedstreaming/mp4split --show_license

# 运行指定版本的cpix_verify
docker run --rm -it -e UspLicenseKey -v ${PWD}:/data --workdir /data docker.io/unifiedstreaming/cpix_verify:1.11.9 --input sample.cpix.xml

配置说明

• 环境变量：UspLicenseKey用于传递授权密钥，支持工具功能授权
• 数据挂载：-v ${PWD}:/data将本地当前目录挂载至容器/data，实现文件访问
• 工作目录：--workdir /data设置容器工作目录，便于直接操作挂载的本地文件

版本标签说明

• latest：最新稳定GA版本
• <version>（如1.11.9）：指定GA版本
• <version>-beta（如1.11.10-beta）：指定Beta版本