Motion Preflight QA
Gate de qualidade determinística para broadcast e plataformas sociais, para motion graphics e anúncios em vídeo curto renderizados por código. Construído para eliminar re-renderizações cegas, legendas cortadas, áudio mudo/comprimido e bugs de reprodução no iOS/QuickTime.
Pré-requisitos
- Python 3.9+ (apenas biblioteca padrão — nenhum pacote Python de terceiros necessário)
- FFmpeg e FFprobe no
PATH
Fluxo de Trabalho Padrão de Garantia de Qualidade (Execute Antes de Cada Entrega)
Passo 1: Audite o vídeo renderizado
Execute a auditoria técnica de 8 portas contra a plataforma de destino (reels, tiktok, shorts, youtube, linkedin, square ou auto):
python3 scripts/audit_video.py path/to/video.mp4 --platform reels
Use --json para saída legível por máquina ao encadear em pipelines automatizados.
O que verifica:
- Container e Codec: Compatibilidade com H.264 (
libx264) ou HEVC MP4. - Formato de Pixel (
yuv420p): Detecta exportaçõesyuv444p/ 10-bit que resultam em telas pretas no QuickTime, Safari e Instagram iOS. - Web Faststart (
moovantes demdat): Verifica reprodução móvel progressiva instantânea sem atrasos de buffer. - Proporção e Resolução: Verifica correspondência com as dimensões da plataforma de destino (ex.:
1080x1920para 9:16 vertical). - Consistência da Taxa de Quadros: Verifica FPS padrão limpo (
24,30,60ou120) e sinaliza taxas de quadros variáveis não padrão. - Integridade do Gancho (Escaneamento de Quadro Preto): Sinaliza qualquer introdução preta morta (> 0,25 s no início) ou lacunas pretas inesperadas no meio do vídeo.
- Altura do Áudio (EBU R128): Mede a Altura Integrada (
Iem LUFS) e o Pico Verdadeiro (TPem dBTP) contra o padrão social de-14 LUFS/-1,0 dBTP. - Tamanho do Arquivo e Orçamento de Bitrate: Sinaliza exportações de grão de filme inchadas que disparam recompressão agressiva da plataforma.
Passo 2: Gere a Folha de Contato da Zona de Segurança
Gere uma folha de prova visual de 6 quadros com zonas de perigo HUD da plataforma, com precisão de pixel, mascaradas em vermelho translúcido e o perímetro de segurança do título delineado em verde:
python3 scripts/safe_zone_overlay.py path/to/video.mp4 --platform reels --out qa_contact_sheet.png
Inspecione qa_contact_sheet.png (visualmente ou com uma ferramenta de leitura de imagem):
- Zonas vermelhas = áreas de perigo da interface do usuário (cabeçalho superior, trilho direito de like/comentário/compartilhar, gaveta inferior de legenda/áudio).
- Caixa verde = Zona de segurança do título. Qualquer título, estatística, chamada de produto ou CTA que toque o vermelho DEVE ser reposicionado antes da entrega.
- Para inspecionar um único timestamp problemático em resolução total, adicione
--at <segundos> --out proof_frame.png.
Passo 3: Auto-Mestre para Entrega (se qualquer verificação técnica avisar ou falhar)
Corrija o formato de pixel, injete +faststart, aplique normalização de altura EBU R128 de duas passagens (-14 LUFS, -1,0 dBTP) e otimize o bitrate de forma limpa:
python3 scripts/fix_delivery.py path/to/video.mp4 --out path/to/video_master.mp4 --crf 20
Use --crf 23 para grão de filme pesado ou fundos ruidosos para reduzir o tamanho do arquivo sem tipografia borrada. Em seguida, reexecute o Passo 1 no arquivo mestre para confirmar um PASSO 100/100.
Documentação de Referência
references/platform-safe-zones.md— Coordenadas exatas das zonas de segurança de 2026 e margens de pixel para Instagram Reels, TikTok, YouTube Shorts, LinkedIn e widescreen 16:9.references/delivery-specs.md— Codec, espaço de cor, altura, bitrate e correções comuns de falhas de código para vídeo.