Edição de Vídeo & QC
Nunca edite no lugar. Escreva as saídas em um novo arquivo (*_v2.mp4, renders/), mantenha a fonte intacta
e confirme antes de sobrescrever ou excluir qualquer coisa.
Receitas de edição (FFmpeg)
# Cortar sem recodificar (corta em keyframes) / com precisão de quadro usando recodificação
ffmpeg -ss 00:00:05 -to 00:00:20 -i in.mp4 -c copy out.mp4
ffmpeg -i in.mp4 -ss 5 -to 20 -c:v libx264 -crf 16 -c:a aac out.mp4
# Concatenar clipes com codecs idênticos
printf "file '%s'\n" a.mp4 b.mp4 > list.txt && ffmpeg -f concat -safe 0 -i list.txt -c copy out.mp4
# Reenquadrar 16:9 -> 9:16 em torno de um assunto em x=CX (pixels); prefira recompor o design em vez disso
ffmpeg -i in.mp4 -vf "crop=ih*9/16:ih:CX-ih*9/32:0,scale=1080:1920" -c:a copy out_9x16.mp4
# Queimar legendas (estilo para redes sociais) / anexar como trilha soft
ffmpeg -i in.mp4 -vf "subtitles=captions.srt:force_style='FontName=Inter,FontSize=14,Outline=1,MarginV=60'" out.mp4
ffmpeg -i in.mp4 -i captions.srt -c copy -c:s mov_text out.mp4
# Substituir áudio / reduzir música sob a voz / normalizar para -14 LUFS
ffmpeg -i in.mp4 -i mix.wav -map 0:v -map 1:a -c:v copy -shortest out.mp4
ffmpeg -i music.wav -i vo.wav -filter_complex "[0][1]sidechaincompress=threshold=0.05:ratio=8:attack=150:release=300[m];[m][1]amix=inputs=2:normalize=0" mix.wav
ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1:LRA=11 -ar 48000 mix_norm.wav # duas passadas para entrega final
# Codificação para web/redes sociais (a partir do master; o master em si é CRF 16 — veja hyperframes-production)
ffmpeg -i in.mp4 -c:v libx264 -pix_fmt yuv420p -crf 18 -preset slow -movflags +faststart -c:a aac -b:a 192k out.mp4
Para recortes de cabeça falante, corte nos limites da frase a partir de uma transcrição (carimbos de tempo voice-video-sync), remova apenas os preenchimentos onde o corte é invisível e mantenha 80–150 ms de ruído de ambiente em cada corte. Para reenquadramento de movimento projetado, recomponha por proporção no projeto de origem em vez de cortar quando possível.
Portões de QC
Execute a partir do diretório do projeto (QC=<plugin-root>/scripts/qc.sh):
$QC probe final.mp4 # codec, tamanho, fps, duração, áudio presente
$QC sheet final.mp4 qc/sheet.png 4 4 # folha de contato para uma leitura completa
$QC stills final.mp4 qc/ 0.5 3 7.5 # um still por batida do storyboard; falha após o fim
$QC loudness final.mp4 # -14 ±1 LUFS (passe -23 para broadcast), pico verdadeiro <= -1 dBTP
$QC loop final.mp4 # apenas loops: a costura deve parecer um passo de quadro normal
Em seguida, revise os stills e a folha de contato contra o storyboard:
| Portão | Passa quando |
|---|---|
| Especificação | resolução, fps, duração e codec correspondem ao briefing para cada proporção |
| História | compreensível com o som desligado; os primeiros 2 segundos transmitem o valor ou o gancho |
| Continuidade | cada corte tem sua transportadora; nenhum crossfade entre telas não relacionadas; nenhuma costura de pingue-pongue |
| Ritmo | ações-chave nas batidas; nenhum quadro morto; nenhuma imobilidade sem motivo > 3 s |
| Legibilidade | nenhum texto cortado ou sobreposto; legendas ≤2 linhas dentro das áreas seguras; números legíveis através do desfoque de movimento |
| Marca | cores amostradas correspondem aos tokens; fontes e conjunto de ícones corretos; nenhum redesign |
| Fatos | todo número ou afirmação na tela está na lista de fatos do storyboard |
| Segurança | nenhum PII, nenhuma marca real de terceiros sem permissão, licenças e atribuições presentes |
| Áudio | loudness e pico verdadeiro dentro do intervalo; SFX sob a música; VO inteligível sobre a música |
| Acessibilidade | ≤3 flashes por segundo; legendas correspondem às palavras faladas |
| Loop | quando solicitado, a costura passa qc.sh loop |
| Determinismo | o mesmo timestamp renderizado duas vezes é idêntico (verifique 3 quadros) |
Relate cada portão como passa / falha / não verificado, com o caminho da evidência (still, folha, saída do comando). Corrija as falhas na fonte e renderize novamente; não as encubra na codificação final. Para vídeos longos, divida o QC por capítulo e use o agente motion-qc por capítulo em paralelo.