编码与格式 / 系统课时

项目测试与交付

项目测试与交付

音视频项目能播放并不等于可以交付。本课把样本库、质量指标、兼容性测试、自动化冒烟和发布检查组合成一套可重复执行的验收流程。

学习目标

  • 能建立覆盖正常、边界和异常场景的媒体样本库
  • 能定义可量化的性能、质量与稳定性指标
  • 能通过自动化检查和发布清单降低交付风险

建立可重复的媒体样本库

样本库应覆盖产品真实支持范围,而不是只保存几个能正常播放的文件。每个样本需要记录来源、编码格式、封装格式、分辨率、帧率、音频参数、时长、预期结果和版权状态。

建议至少包含四类样本:标准样本用于日常冒烟,边界样本覆盖高分辨率、高帧率、特殊声道和长时长,异常样本覆盖损坏、时间戳跳变和缺少关键帧,线上回归样本用于防止已修复问题再次出现。

样本文件名不应承担全部元数据。可在仓库中维护一份清单,并通过哈希值确认文件未被替换。大文件可以放在对象存储或制品库,但测试脚本必须能够按固定版本下载。

定义性能与质量指标

指标必须能够被采集、比较和判定。仅记录“播放流畅”无法支持版本回归,也无法解释不同设备上的差异。

维度 建议指标 判定方式
启动 首帧时间、首音时间 从打开媒体到首次输出的耗时
流畅度 实际帧率、丢帧数、卡顿次数 与目标帧率和允许阈值比较
同步 音画时间差 统计平均值、峰值和持续超限时间
性能 CPU、内存、GPU、耗电 在固定样本和固定设备上采集
稳定性 崩溃、死锁、队列增长 长时间播放和反复启停验证
网络 端到端延迟、重连时间 在固定带宽、抖动和丢包条件下测试

阈值要结合产品场景制定。例如点播更关注首帧和拖动恢复,实时互动更关注端到端延迟和弱网恢复。指标一旦作为发布门槛,就应固定测试设备、系统版本、样本版本和采集方式。

自动化冒烟与回归

自动化流程可以先做最小闭环:读取样本清单,检查媒体流信息,完整解码到空输出,并在出现解码错误时返回非零状态。它不能替代人工听看,但能快速拦截文件损坏、编解码器不可用和基础回归问题。

音视频项目测试与交付流水线

下面命令会生成并执行冒烟脚本。运行环境需要已安装 ffprobe 和 ffmpeg,项目根目录下需要存在 samples 目录。

bash
cat > media-smoke-test.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

SAMPLE_DIR="${1:-samples}"
FAILED=0

while IFS= read -r -d '' file; do
  echo "[CHECK] $file"

  if ! ffprobe -v error \
    -show_entries stream=index,codec_type,codec_name \
    -of csv=p=0 "$file" >/dev/null; then
    echo "[FAIL] ffprobe: $file"
    FAILED=1
    continue
  fi

  if ! ffmpeg -v error -xerror -i "$file" -f null - >/dev/null 2>&1; then
    echo "[FAIL] decode: $file"
    FAILED=1
    continue
  fi

  echo "[PASS] $file"
done < <(find "$SAMPLE_DIR" -type f \
  \( -name "*.mp4" -o -name "*.mkv" -o -name "*.mov" -o -name "*.ts" -o -name "*.aac" \) \
  -print0)

if [[ "$FAILED" -ne 0 ]]; then
  echo "Media smoke test failed."
  exit 1
fi

echo "All media samples passed."
EOF

chmod +x media-smoke-test.sh
./media-smoke-test.sh samples

预期输出

text
[CHECK] samples/h264-aac-1080p.mp4
[PASS] samples/h264-aac-1080p.mp4
[CHECK] samples/hevc-aac-4k.mp4
[PASS] samples/hevc-aac-4k.mp4
All media samples passed.

如果样本损坏或解码器返回错误,脚本会输出 [FAIL] 并以状态码 1 结束,持续集成系统可据此阻止发布。

兼容性测试与验收

兼容性矩阵应从产品支持声明反推,不必盲目覆盖所有组合。常见维度包括操作系统、芯片架构、设备性能、硬件解码能力、封装格式、编码格式、网络协议和音频输出设备。

同一组合至少验证打开、播放、暂停、拖动、切换清晰度、前后台切换和结束释放。直播或实时通信还应验证断网重连、网络切换、长时间运行、摄像头与麦克风切换,以及权限被拒绝后的提示。

人工验收重点观察自动化难以判断的问题,例如轻微色偏、声音爆音、字幕错位、快速运动场景的马赛克和交互反馈延迟。人工结论也应记录样本、设备、版本和时间,避免只留下“通过”两个字。

发布与交付清单

发布前先冻结代码、依赖和媒体样本版本,再生成测试报告与制品。交付包应包含可执行文件或库、版本说明、支持格式、运行依赖、配置说明、已知限制、许可证信息和回滚方法。发布检查至少确认以下事项:

  • 所有必跑样本、性能门槛和兼容性组合已通过
  • 调试日志、测试密钥和内部地址已移除或替换
  • 第三方编解码器、字体、滤镜和素材许可证已核对
  • 崩溃日志、性能指标和关键错误码可以被线上采集
  • 版本号、提交号、构建时间和制品哈希可追溯
  • 上一稳定版本和配置回滚步骤已经验证

交付后的首个版本周期仍应保留重点监控。若线上指标明显偏离测试环境,应先确认样本、设备和配置是否一致,再决定回滚或热修复。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

项目测试与交付

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通