Motion Preflight QA
コードレンダリングされたモーション グラフィックスおよびショートフォーム動画広告向けの、決定論的な放送・ソーシャルプラットフォーム品質ゲート。ブラインドでの再レンダリング、キャプションの切り抜き、音声のミュート/クリッピング、iOS/QuickTime の再生バグを排除するために構築されました。
前提条件
- Python 3.9 以上(標準ライブラリのみ — サードパーティの Python パッケージは不要)
- FFmpeg と FFprobe が
PATHに存在すること
標準 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-bit 出力を検出。 - Web Faststart (
moovがmdatより前): モバイルでの即時プログレッシブ再生(バッファリング遅延なし)を確認。 - アスペクト比と解像度: 対象プラットフォームの寸法(例:9:16 縦向きの場合は
1080x1920)と一致するか確認。 - フレームレートの一貫性: 標準フレームレート(
24、30、60、120)のクリーンさを確認し、非標準の可変フレームレートをフラグ付け。 - フックの完全性(黒フレームスキャン): 先頭のデッドブラックイントロ(0.25 秒超)や、動画途中の予期しない黒ギャップをフラグ付け。
- オーディオラウドネス (EBU R128): 統合ラウドネス(
I、LUFS)とトゥルーピーク(TP、dBTP)を測定し、ソーシャル標準の-14 LUFS/-1.0 dBTPと比較。 - ファイルサイズとビットレート予算: プラットフォーム側の積極的な再圧縮を誘発する、肥大化したフィルムグレイン出力をフラグ付け。
ステップ 2: 安全ゾーンコンタクトシートの生成
プラットフォームのピクセル精度 HUD 危険ゾーンを半透明の赤でマスクし、タイトル安全領域を緑で囲んだ、6 フレームのビジュアルプルーフシートを生成します:
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 を注入し、2 パス 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 PASS を確認します。
リファレンスドキュメント
references/platform-safe-zones.md— Instagram Reels、TikTok、YouTube Shorts、LinkedIn、16:9 ワイドスクリーン向けの 2026 年最新安全ゾーン座標とピクセルマージン。references/delivery-specs.md— コーデック、カラースペース、ラウドネス、ビットレート、および一般的なコードから動画への変換失敗の修正方法。