unifiedstreaming/mp4split

Unified Streaming命令行工具Docker镜像

概述

本镜像集合用于构建Unified Streaming的各命令行工具Docker镜像，提供便捷的媒体处理与视频流相关命令行操作能力。所有镜像基于mp4split基础镜像构建，部分工具（如manifest_edit）会额外安装依赖（如Python及Manifest Edit包）。镜像发布于Docker Hub，支持稳定版和beta版标签。

核心功能与特性

支持的工具镜像

• unifiedstreaming/mp4split
• unifiedstreaming/cpix_verify
• unifiedstreaming/manifest_edit
• unifiedstreaming/push_input_stream
• unifiedstreaming/unified_capture
• unifiedstreaming/unified_remix

版本控制

• 稳定版：默认使用latest标签，对应最新GA版本
• Beta版：标签格式为<version>-beta（如1.11.10-beta）

便捷操作

• 提供Shell函数封装，可直接在终端中以本地工具方式运行
• 自动挂载当前工作目录到容器内/data路径，并以此为工作目录
• 支持通过环境变量传递许可证密钥（UspLicenseKey）

使用场景

适用于各类媒体处理命令行操作场景，包括但不限于：

• 视频文件分片与处理（mp4split）
• DRM内容验证（cpix_verify）
• 流媒体Manifest文件编辑（manifest_edit）
• 输入流推送（push_input_stream）
• 内容捕获与混合处理（unified_capture/unified_remix）

使用方法与配置说明

Shell函数配置

将以下Shell函数添加到bash、zsh等终端的配置文件（如.bashrc、.zshrc）中，即可像使用本地工具一样运行镜像：

bash
#!/bin/sh
# docker helper functions
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 "$@"
}

运行示例

1. 使用默认最新版本

bash
# 查看mp4split版本信息
mp4split --show_license

2. 指定具体版本

bash
# 使用1.11.9版本的mp4split
mp4split 1.11.9 --show_license

3. 使用beta版本

bash
# 使用1.11.10-beta版本的manifest_edit
manifest_edit 1.11.10-beta --help

参数说明

• 版本指定：在命令前添加版本号作为第一个参数（如mp4split 1.11.9），不指定则使用latest版本
• 环境变量：通过-e UspLicenseKey传递许可证密钥，需确保环境变量已设置
• 文件挂载：当前工作目录自动挂载到容器/data路径，可直接访问本地文件系统
• 交互模式：-it参数确保终端交互功能可用，--rm确保容器退出后自动清理

注意事项

• 首次运行无版本指定的命令时，会自动拉取latest标签镜像
• Beta版本需显式指定版本号（如1.11.10-beta）
• 所有命令操作的文件路径相对于当前工作目录，容器内对应路径为/data