运动图形预飞QA 是做什么的?
用于代码渲染的运动图形和短格式视频广告的确定性广播和社交平台质量门控。旨在消除盲目的重新渲染、裁剪的字幕、静音/压碎的音频以及 iOS/QuickTime 播放错误。
先决条件
- Python 3.9+(仅标准库——无需第三方 Python 包)
- PATH 中可用的 FFmpeg 和 FFprobe
标准 QA 工作流程(每次交付前运行)
步骤 1:审核渲染的视频
针对目标平台(reels、tiktok、shorts、youtube、linkedin、square 或 auto)运行 8 门技术审核:
python3 scripts/audit_video.py path/to/video.mp4 --platform reels
当需要链接到自动化流水线时,使用 --json 获取机器可读的输出。
它验证的内容:
- 容器和编解码器: H.264(
libx264)或 HEVC MP4 兼容性。 - 像素格式(
yuv420p): 捕获在 QuickTime、Safari 和 Instagram iOS 中显示为黑屏的yuv444p/10 位导出。 - Web 快速启动(
moov在mdat之前): 验证即时渐进式移动播放,无缓冲延迟。 - 宽高比和分辨率: 检查是否匹配目标平台尺寸(例如,9:16 竖屏为
1080x1920)。 - 帧率一致性: 验证干净的标准 FPS(
24、30、60或120),并标记非标准可变帧率。 - 片段完整性(黑帧扫描): 标记任何死黑开头(开头 > 0.25 秒)或视频中间意外出现的黑帧间隙。
- 音频响度(EBU R128): 根据社交平台标准
-14 LUFS/-1.0 dBTP测量综合响度(I,以 LUFS 为单位)和真峰值(TP,以 dBTP 为单位)。 - 文件大小和比特率预算: 标记因胶片颗粒导致文件过大、从而触发平台激进重新压缩的情况。
步骤 2:生成安全区域联系表
生成一张 6 帧视觉证明表,其中像素级的平台 HUD 危险区域用半透明红色标示,标题安全区域边界用绿色标示:
python3 scripts/safe_zone_overlay.py path/to/video.mp4 --platform reels --out qa_contact_sheet.png
检查 qa_contact_sheet.png(视觉检查或使用图像读取工具):
- 红色区域 = UI 危险区域(顶部标题栏、右侧点赞/评论/分享栏、底部字幕/音频抽屉)。
- 绿色框 = 标题安全区域。 任何接触红色的标题、统计数据、产品宣传语或行动号召,都必须在交付前重新定位。
- 要以全分辨率检查单个问题时间戳,请添加
--at <秒数> --out proof_frame.png。
步骤 3:自动主输出交付(如果任何技术检查发出警告或失败)
修复像素格式,注入 +faststart,应用两遍 EBU R128 响度标准化(-14 LUFS,-1.0 dBTP),并干净地优化比特率:
python3 scripts/fix_delivery.py path/to/video.mp4 --out path/to/video_master.mp4 --crf 20
对于重胶片颗粒或嘈杂背景,使用 --crf 23 来减小文件大小,同时不导致文字模糊。然后对主输出文件重新运行步骤 1,以确认 100/100 通过。
参考文档
references/platform-safe-zones.md— 2026 年准确的 Instagram Reels、TikTok、YouTube Shorts、LinkedIn 和 16:9 宽屏的安全区域坐标和像素边距。references/delivery-specs.md— 编解码器、色彩空间、响度、比特率以及常见的代码到视频错误修复。