動態預檢品質保證 是做什麼的?
針對程式碼渲染的動態圖像與短影音廣告的確定性廣播與社交平台品質閘道。旨在消除盲目重新渲染、裁切字幕、靜音/壓縮音訊以及 iOS/QuickTime 播放錯誤。
先決條件
- Python 3.9+(僅使用標準函式庫 — 無需第三方 Python 套件)
- FFmpeg 與 FFprobe 需位於
PATH環境變數中
標準品質保證工作流程(每次交付前執行)
步驟 1:審查渲染完成的影片
針對目標平台(reels、tiktok、shorts、youtube、linkedin、square 或 auto)執行八道關卡的技術審查:
python3 scripts/audit_video.py path/to/video.mp4 --platform reels
若需串接自動化管線,請使用 --json 取得機器可讀的輸出。
審查項目:
- 容器與編解碼器: H.264 (
libx264) 或 HEVC MP4 相容性。 - 像素格式 (
yuv420p): 捕捉yuv444p/ 10-bit 輸出,這類輸出會在 QuickTime、Safari 和 Instagram iOS 上顯示為黑畫面。 - Web Faststart (
moov在mdat之前): 驗證是否可實現即時漸進式行動播放,無緩衝延遲。 - 長寬比與解析度: 檢查是否符合目標平台尺寸(例如 9:16 直式為
1080x1920)。 - 影格率一致性: 驗證為乾淨的標準 FPS(
24、30、60或120),並標記非標準的可變影格率。 - 開頭片段完整性(黑畫面掃描): 標記任何死黑開場(開頭 > 0.25 秒)或影片中途的意外黑畫面。
- 音量 (EBU R128): 測量整合音量(
I,單位 LUFS)與真實峰值(TP,單位 dBTP),對照社交平台標準-14 LUFS/-1.0 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 危險區域(頂部頁首、右側按讚/留言/分享列、底部字幕/音訊抽屜)。
- 綠色框線 = 標題安全區域。 任何觸及紅色區域的標題、數據、產品標語或 CTA,都必須在交付前重新定位。
- 若要檢視單一問題時間點的完整解析度畫面,請加上參數
--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— 編解碼器、色彩空間、音量、位元率及常見的程式碼轉影片故障排除方法。