Bewegungsgrafik-Qualitätssicherung (Preflight QA)
Deterministische Broadcast- und Social-Plattform-Qualitätsprüfung für code-renderte Bewegungsgrafiken und Kurzform-Videoanzeigen. Entwickelt, um blinde Neurenders, abgeschnittene Untertitel, stummgeschaltete/verzerrte Audioausgaben und iOS/QuickTime-Wiedergabefehler zu eliminieren.
Voraussetzungen
- Python 3.9+ (nur Standardbibliothek — keine Drittanbieter-Python-Pakete erforderlich)
- FFmpeg & FFprobe im
PATH
Standard-QA-Workflow (Vor jeder Auslieferung ausführen)
Schritt 1: Das gerenderte Video prüfen
Führen Sie die 8-stufige technische Prüfung gegen die Zielplattform (reels, tiktok, shorts, youtube, linkedin, square oder auto) durch:
python3 scripts/audit_video.py pfad/zu/video.mp4 --platform reels
Verwenden Sie --json für maschinenlesbare Ausgabe, wenn Sie es in automatisierte Pipelines einbinden.
Was geprüft wird:
- Container & Codec: H.264 (
libx264) oder HEVC MP4-Kompatibilität. - Pixelformat (
yuv420p): Erkenntyuv444p/ 10-Bit-Exporte, die in QuickTime, Safari und Instagram iOS als schwarze Bildschirme erscheinen. - Web Faststart (
moovvormdat): Überprüft sofortige progressive mobile Wiedergabe ohne Pufferungsverzögerungen. - Seitenverhältnis & Auflösung: Überprüft Übereinstimmung mit den Zielplattform-Maßen (z. B.
1080x1920für 9:16 vertikal). - Bildratenkonsistenz: Überprüft saubere Standard-FPS (
24,30,60oder120) und markiert nicht-standardmäßige variable Bildraten. - Einblendungsintegrität (Schwarz-Frame-Scan): Markiert tote schwarze Intro-Phasen (> 0,25 s am Anfang) oder unerwartete schwarze Lücken mitten im Video.
- Audiolautstärke (EBU R128): Misst integrierte Lautstärke (
Iin LUFS) und True Peak (TPin dBTP) gegen den-14 LUFS/-1,0 dBTPSocial-Standard. - Dateigröße & Bitratenbudget: Markiert übermäßig große Filmkorn-Exporte, die aggressive plattformspezifische Neukomprimierung auslösen.
Schritt 2: Das Safe-Zone-Kontaktblatt generieren
Erstellen Sie ein 6-Frame-visuelles Nachweisblatt mit pixelgenauen Plattform-HUD-Gefahrenzonen, die in durchscheinendem Rot maskiert sind, und dem Titel-Safe-Bereich, der in Grün umrandet ist:
python3 scripts/safe_zone_overlay.py pfad/zu/video.mp4 --platform reels --out qa_kontaktblatt.png
Überprüfen Sie qa_kontaktblatt.png (visuell oder mit einem Bildlesewerkzeug):
- Rote Zonen = UI-Gefahrenbereiche (obere Kopfzeile, rechte Like/Kommentar/Teilen-Leiste, untere Untertitel/Audio-Schublade).
- Grünes Kästchen = Titel-Safe-Zone. Jegliche Überschrift, Statistik, Produkt-Hervorhebung oder CTA, die Rot berührt, MUSS vor der Auslieferung neu positioniert werden.
- Um eine einzelne Problemzeitmarke in voller Auflösung zu inspizieren, fügen Sie
--at <Sekunden> --out proof_frame.pnghinzu.
Schritt 3: Automatische Auslieferungsversion (wenn eine technische Prüfung warnt oder fehlschlägt)
Pixelformat beheben, +faststart einfügen, Zwei-Durchgang-EBU-R128-Lautstärkenormalisierung (-14 LUFS, -1,0 dBTP) anwenden und Bitrate sauber optimieren:
python3 scripts/fix_delivery.py pfad/zu/video.mp4 --out pfad/zu/video_master.mp4 --crf 20
Verwenden Sie --crf 23 für starkes Filmkorn oder verrauschte Hintergründe, um die Dateigröße zu reduzieren, ohne die Typografie zu verwaschen. Führen Sie dann Schritt 1 für die masterisierte Datei erneut aus, um ein 100/100 BESTANDEN zu bestätigen.
Referenzdokumentation
references/platform-safe-zones.md— Exakte 2026 Safe-Zone-Koordinaten und Pixelabstände für Instagram Reels, TikTok, YouTube Shorts, LinkedIn und 16:9 Breitbild.references/delivery-specs.md— Codec, Farbraum, Lautstärke, Bitrate und häufige Code-zu-Video-Fehlerbehebungen.