Motion Preflight QA
Passerelle de qualité déterministe broadcast et plateforme sociale pour les animations graphiques et publicités vidéo courtes rendues par code. Conçue pour éliminer les re-rendus aveugles, les légendes coupées, l'audio muet/écrasé et les bugs de lecture iOS/QuickTime.
Prérequis
- Python 3.9+ (bibliothèque standard uniquement — aucun paquet Python tiers requis)
- FFmpeg & FFprobe dans le
PATH
Workflow QA Standard (À Exécuter Avant Chaque Livraison)
Étape 1 : Auditer la vidéo rendue
Exécute l'audit technique en 8 points contre la plateforme cible (reels, tiktok, shorts, youtube, linkedin, square ou auto) :
python3 scripts/audit_video.py chemin/vers/video.mp4 --platform reels
Utilisez --json pour une sortie lisible par machine lors de l'enchaînement dans des pipelines automatisés.
Ce qu'il vérifie :
- Conteneur & Codec : Compatibilité H.264 (
libx264) ou HEVC MP4. - Format Pixel (
yuv420p) : Détecte les exportsyuv444p/ 10 bits qui s'affichent en écran noir dans QuickTime, Safari et Instagram iOS. - Web Faststart (
moovavantmdat) : Vérifie la lecture mobile progressive instantanée sans délais de mise en mémoire tampon. - Ratio d'aspect & Résolution : Vérifie la conformité aux dimensions de la plateforme cible (ex.
1080x1920pour vertical 9:16). - Consistance du Taux d'Images : Vérifie les FPS standards propres (
24,30,60ou120) et signale les fréquences variables non standard. - Intégrité du Hook (Analyse des Images Noires) : Signale toute intro noire morte (> 0,25 s au début) ou trous noirs inattendus en milieu de vidéo.
- Sonie Audio (EBU R128) : Mesure la sonie intégrée (
Ien LUFS) et le pic vrai (TPen dBTP) par rapport à la norme sociale-14 LUFS/-1,0 dBTP. - Taille du Fichier & Budget de Débit : Signale les exports de grain de film gonflés qui déclenchent une recompression agressive de la plateforme.
Étape 2 : Générer la Planche Contact de Zone de Sécurité
Génère une planche de preuve visuelle à 6 images avec les zones de danger HUD de la plateforme masquées en rouge translucide et le périmètre titre-sécurisé souligné en vert :
python3 scripts/safe_zone_overlay.py chemin/vers/video.mp4 --platform reels --out qa_contact_sheet.png
Inspectez qa_contact_sheet.png (visuellement ou avec un outil de lecture d'images) :
- Zones rouges = zones de danger UI (en-tête supérieur, rail like/commentaire/partage droit, tiroir de légende/audio inférieur).
- Boîte verte = Zone titre-sécurisée. Tout titre, statistique, appel produit ou CTA touchant le rouge DOIT être repositionné avant livraison.
- Pour inspecter un seul timestamp problématique en pleine résolution, ajoutez
--at <secondes> --out proof_frame.png.
Étape 3 : Auto-Master pour Livraison (si un contrôle technique échoue ou donne un avertissement)
Corrige le format pixel, injecte +faststart, applique une normalisation de sonie EBU R128 en deux passes (-14 LUFS, -1,0 dBTP) et optimise proprement le débit binaire :
python3 scripts/fix_delivery.py chemin/vers/video.mp4 --out chemin/vers/video_master.mp4 --crf 20
Utilisez --crf 23 pour les arrière-plans à grain de film lourd ou bruyants afin de réduire la taille du fichier sans typographie baveuse. Relancez ensuite l'Étape 1 sur le fichier master pour confirmer un 100/100 PASS.
Documentation de Référence
references/platform-safe-zones.md— Coordonnées exactes des zones de sécurité 2026 et marges de pixels pour Instagram Reels, TikTok, YouTube Shorts, LinkedIn et grand écran 16:9.references/delivery-specs.md— Codec, espace colorimétrique, sonie, débit binaire et corrections courantes des pannes code-vers-vidéo.