编码与格式 / 系统课时
项目测试与交付
项目测试与交付
音视频项目能播放并不等于可以交付。本课把样本库、质量指标、兼容性测试、自动化冒烟和发布检查组合成一套可重复执行的验收流程。
学习目标
- 能建立覆盖正常、边界和异常场景的媒体样本库
- 能定义可量化的性能、质量与稳定性指标
- 能通过自动化检查和发布清单降低交付风险
建立可重复的媒体样本库
样本库应覆盖产品真实支持范围,而不是只保存几个能正常播放的文件。每个样本需要记录来源、编码格式、封装格式、分辨率、帧率、音频参数、时长、预期结果和版权状态。
建议至少包含四类样本:标准样本用于日常冒烟,边界样本覆盖高分辨率、高帧率、特殊声道和长时长,异常样本覆盖损坏、时间戳跳变和缺少关键帧,线上回归样本用于防止已修复问题再次出现。
样本文件名不应承担全部元数据。可在仓库中维护一份清单,并通过哈希值确认文件未被替换。大文件可以放在对象存储或制品库,但测试脚本必须能够按固定版本下载。
定义性能与质量指标
指标必须能够被采集、比较和判定。仅记录“播放流畅”无法支持版本回归,也无法解释不同设备上的差异。
| 维度 | 建议指标 | 判定方式 |
|---|---|---|
| 启动 | 首帧时间、首音时间 | 从打开媒体到首次输出的耗时 |
| 流畅度 | 实际帧率、丢帧数、卡顿次数 | 与目标帧率和允许阈值比较 |
| 同步 | 音画时间差 | 统计平均值、峰值和持续超限时间 |
| 性能 | CPU、内存、GPU、耗电 | 在固定样本和固定设备上采集 |
| 稳定性 | 崩溃、死锁、队列增长 | 长时间播放和反复启停验证 |
| 网络 | 端到端延迟、重连时间 | 在固定带宽、抖动和丢包条件下测试 |
阈值要结合产品场景制定。例如点播更关注首帧和拖动恢复,实时互动更关注端到端延迟和弱网恢复。指标一旦作为发布门槛,就应固定测试设备、系统版本、样本版本和采集方式。
自动化冒烟与回归
自动化流程可以先做最小闭环:读取样本清单,检查媒体流信息,完整解码到空输出,并在出现解码错误时返回非零状态。它不能替代人工听看,但能快速拦截文件损坏、编解码器不可用和基础回归问题。

下面命令会生成并执行冒烟脚本。运行环境需要已安装 ffprobe 和 ffmpeg,项目根目录下需要存在 samples 目录。
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预期输出
[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 结束,持续集成系统可据此阻止发布。
兼容性测试与验收
兼容性矩阵应从产品支持声明反推,不必盲目覆盖所有组合。常见维度包括操作系统、芯片架构、设备性能、硬件解码能力、封装格式、编码格式、网络协议和音频输出设备。
同一组合至少验证打开、播放、暂停、拖动、切换清晰度、前后台切换和结束释放。直播或实时通信还应验证断网重连、网络切换、长时间运行、摄像头与麦克风切换,以及权限被拒绝后的提示。
人工验收重点观察自动化难以判断的问题,例如轻微色偏、声音爆音、字幕错位、快速运动场景的马赛克和交互反馈延迟。人工结论也应记录样本、设备、版本和时间,避免只留下“通过”两个字。
发布与交付清单
发布前先冻结代码、依赖和媒体样本版本,再生成测试报告与制品。交付包应包含可执行文件或库、版本说明、支持格式、运行依赖、配置说明、已知限制、许可证信息和回滚方法。发布检查至少确认以下事项:
- 所有必跑样本、性能门槛和兼容性组合已通过
- 调试日志、测试密钥和内部地址已移除或替换
- 第三方编解码器、字体、滤镜和素材许可证已核对
- 崩溃日志、性能指标和关键错误码可以被线上采集
- 版本号、提交号、构建时间和制品哈希可追溯
- 上一稳定版本和配置回滚步骤已经验证
交付后的首个版本周期仍应保留重点监控。若线上指标明显偏离测试环境,应先确认样本、设备和配置是否一致,再决定回滚或热修复。