Otimização de Vídeo para Incorporação Web
Transforme um clipe de origem (gravação de tela, exportação de celular, renderização HEVC) em um hero/background/loop rápido, nítido e com reprodução automática confiável e incorpore-o. A vantagem geralmente é grande: H.264 consciente de retina com um CRF razoável reduz uma gravação de tela 1080p de ~8 MB para ~1.5 MB sem perda visível e corrige problemas de reprodução automática/codec.
Para criar ou animar vídeo, use [[remotion]] / [[moviepy]] / [[motion-canvas]] — este skill otimiza material que você já possui.
Quando usar
- Adicionar/substituir um vídeo hero, de fundo ou de demonstração em loop em um site.
- O vídeo está muito pesado, não reproduz automaticamente (dispositivos móveis/Safari), apresenta erro de codec ou parece desfocado.
Receita
1. Inspecione primeiro
ffprobe -v error -select_streams v:0 \
-show_entries stream=codec_name,width,height,r_frame_rate,duration,pix_fmt,profile \
-of default=noprint_wrappers=1 in.mp4
ffprobe -v error -select_streams a -show_entries stream=codec_name -of csv=p=0 in.mp4 # áudio?
# verificação faststart: 'moov' está antes de 'mdat'? (moov no final = início lento)
2. Transcodifique (seguro para web + consciente de retina)
ffmpeg -y -i in.mp4 -vf "scale=1600:-2" \
-c:v libx264 -profile:v high -pix_fmt yuv420p -crf 23 -preset slow \
-movflags +faststart -an -r 30 out.mp4
-pix_fmt yuv420p— obrigatório para Safari/suporte amplo (yuv444/422 não reproduzem).-movflags +faststart— move o átomo moov para o início para que o vídeo comece antes do download completo. Sem ele, um hero com reprodução automática trava em conexões lentas.-an— remove áudio; um loop de fundo sem áudio nunca precisa (arquivo menor).scale=1600:-2— codifica para aproximadamente 2× a largura de exibição CSS, não 1080p/4K nativo. Em um quadro ≤820px, 1600px é nítido em retina e muito mais leve.-2mantém a altura par (exigido pelo H.264).-crf 23 -preset slow— alta qualidade, boa compressão. Conteúdo de tela/UI comprime especialmente bem; aumente o CRF para 25–26 somente se o arquivo ainda estiver pesado.
3. Frame de poster
ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg
Escolha um momento representativo (-ss), não um frame de introdução em branco.
4. Incorpore
<video autoplay muted loop playsinline preload="auto" poster="/caminho/poster.jpg">
<source src="/caminho/out.mp4" type="video/mp4"/>
</video>
muted+playsinline+autoplaysão todos necessários para reprodução automática em dispositivos móveis.- CSS do contêiner:
video{display:block;width:100%;height:auto}permite que um clipe 16:9 defina sua própria altura; envolva em um quadro comoverflow:hidden;border-radius.
5. Sirva (tenants Odoo)
Armazene como um ** ir.attachment público** e referencie /web/content/<id> (vídeo) e /web/image/<id> (poster) — veja [[everjust-website-customization]]. Transfira o binário via docker cp (o shell é executado dentro do contêiner). Use IDs de anexo novos e redirecione a view, em vez de sobrescrever IDs antigos, para evitar cache obsoleto do navegador/CDN. Edições de view exigem reinicialização do contêiner para renderizar.
Verifique (obrigatório)
Confirme se ele realmente reproduz com [[cdp-render-verification]] — inicie o Chrome com --autoplay-policy=no-user-gesture-required, então leia o elemento <video>:
readyState=== 4 (HAVE_ENOUGH_DATA),paused=== false,currentTime> 0 após uma curta espera (avançando) evideoWidth/videoHeightcorrespondem à codificação.- Verifique desktop e dispositivos móveis e se a página não possui overflow horizontal.
Relacionados
- [[everjust-website-customization]] — serviço via anexos Odoo + incorporação em view.
- [[cdp-render-verification]] — a prova de reprodução.
- [[remotion]] / [[moviepy]] — criação/animação de vídeo (o trabalho oposto).