Optimización de video para incrustación web
Convierte un clip fuente (grabación de pantalla, exportación de teléfono, render HEVC) en un hero/background/loop de carga rápida, nítido y con reproducción automática confiable y lo incrusta. La mejora suele ser grande: H.264 retina-aware con un CRF sensato reduce una grabación de pantalla 1080p de ~8 MB a ~1.5 MB sin pérdida visible, y soluciona problemas de reproducción automática/códec.
Para crear o animar video, usa [[remotion]] / [[moviepy]] / [[motion-canvas]] en su lugar — este skill optimiza material que ya tienes.
Cuándo usarlo
- Al agregar o reemplazar un video hero, de fondo o de demostración en bucle en un sitio.
- El video es demasiado pesado, no se reproduce automáticamente (móvil/Safari), da error de códec o se ve borroso.
Receta
1. Analizar primero
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 # ¿audio?
# verificación de faststart: ¿'moov' está antes que 'mdat'? (moov al final = inicio lento)
2. Transcodificar (seguro para web + retina-aware)
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— obligatorio para Safari/soporte amplio (yuv444/422 no se reproduce).-movflags +faststart— mueve el átomo moov al frente para que comience antes de descargarse por completo. Sin esto, un hero con reproducción automática se detiene en conexiones lentas.-an— elimina audio; un fondo en bucle silenciado nunca lo necesita (archivo más pequeño).scale=1600:-2— codifica aproximadamente a 2× el ancho de visualización CSS, no a 1080p/4K nativos. Con un marco ≤820px, 1600px es retina-crisp y mucho más ligero.-2mantiene la altura par (requerido por H.264).-crf 23 -preset slow— alta calidad, buena compresión. El contenido de pantalla/UI se comprime especialmente bien; sube CRF a 25–26 solo si el archivo sigue siendo pesado.
3. Fotograma de póster
ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg
Elige un momento representativo (-ss), no un fotograma de introducción en blanco.
4. Incrustar
<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
<source src="/path/out.mp4" type="video/mp4"/>
</video>
muted+playsinline+autoplayson todos necesarios para la reproducción automática en móvil.- CSS del contenedor:
video{display:block;width:100%;height:auto}permite que un clip 16:9 establezca su propia altura; envuélvelo en un marco conoverflow:hidden;border-radius.
5. Servir (inquilinos Odoo)
Almacena como un ir.attachment público y referencia /web/content/<id> (video) y /web/image/<id> (póster) — consulta [[everjust-website-customization]]. Transfiere el binario mediante docker cp (el shell se ejecuta dentro del contenedor). Usa IDs de adjunto nuevos y reasigna la vista, en lugar de sobrescribir IDs antiguos, para evitar caché obsoleto del navegador/CDN. Los cambios de vista necesitan un reinicio del contenedor para renderizarse.
Verificar (obligatorio)
Confirma que realmente se reproduce con [[cdp-render-verification]] — lanza Chrome con --autoplay-policy=no-user-gesture-required, luego lee el elemento <video>:
readyState=== 4 (HAVE_ENOUGH_DATA),paused=== false,currentTime> 0 después de una espera breve (avanzando), yvideoWidth/videoHeightcoinciden con la codificación.- Verifica en escritorio y móvil, y que la página no tenga desbordamiento horizontal.
Relacionados
- [[everjust-website-customization]] — servir mediante adjuntos Odoo + incrustación en vista.
- [[cdp-render-verification]] — la prueba de reproducción.
- [[remotion]] / [[moviepy]] — crear/animar video (la tarea opuesta).