Optimisation vidéo pour intégration web
Transformez un clip source (enregistrement d'écran, export téléphone, rendu HEVC) en une vidéo rapide, nette et fiable en lecture automatique pour l'intégrer en tant que héros/fond/boucle. Le gain est généralement important : un H.264 adapté à la rétine avec un CRF raisonnable fait passer un enregistrement d'écran 1080p d'environ ~8 Mo à ~1,5 Mo sans perte visible, et corrige les problèmes de lecture automatique et de codec.
Pour créer ou animer une vidéo, utilisez plutôt [[remotion]] / [[moviepy]] / [[motion-canvas]] — cette compétence optimise des séquences que vous possédez déjà.
Quand l'utiliser
- Ajout/remplacement d'une vidéo héros, de fond ou de démo en boucle sur un site.
- La vidéo est trop lourde, ne se lance pas automatiquement (mobile/Safari), présente des erreurs de codec ou semble floue.
Recette
1. Sondez d'abord
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 ?
# Vérification faststart : 'moov' est-il avant 'mdat' ? (moov à la fin = démarrage lent)
2. Transcodez (compatible web + rétine)
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— obligatoire pour Safari et une large compatibilité (yuv444/422 ne sont pas lus).-movflags +faststart— déplace l'atome moov au début pour que la lecture commence avant le téléchargement complet. Sans cela, un héros en lecture automatique s'arrête sur les connexions lentes.-an— supprime l'audio ; une boucle de fond muette n'en a jamais besoin (fichier plus léger).scale=1600:-2— encode à environ 2× la largeur d'affichage CSS, pas la résolution native 1080p/4K. Pour un cadre ≤820px, 1600px est net sur rétine et beaucoup plus léger.-2garde une hauteur paire (requis par H.264).-crf 23 -preset slow— haute qualité, bonne compression. Le contenu d'écran/UI se compresse particulièrement bien ; augmentez CRF à 25–26 seulement si le fichier reste lourd.
3. Image d'affiche
ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg
Choisissez un moment représentatif (-ss), pas une image d'introduction vide.
4. Intégrez
<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
<source src="/path/out.mp4" type="video/mp4"/>
</video>
muted+playsinline+autoplaysont tous nécessaires pour la lecture automatique sur mobile.- CSS du conteneur :
video{display:block;width:100%;height:auto}permet à un clip 16:9 de définir sa propre hauteur ; enveloppez-le dans un cadre avecoverflow:hidden;border-radius.
5. Servez (tenants Odoo)
Stockez comme ir.attachment public et référencez /web/content/<id> (vidéo) et /web/image/<id> (affiche) — voir [[everjust-website-customization]]. Transférez le binaire via docker cp (le shell s'exécute dans le conteneur). Utilisez des ID d'attachement frais et pointez la vue, plutôt que d'écraser des anciens IDs, pour éviter le cache périmé du navigateur/CDN. Les modifications de vue nécessitent un redémarrage du conteneur pour s'afficher.
Vérification (obligatoire)
Confirmez que la vidéo se lance réellement avec [[cdp-render-verification]] — lancez Chrome avec --autoplay-policy=no-user-gesture-required, puis lisez l'élément <video> :
readyState=== 4 (HAVE_ENOUGH_DATA),paused=== false,currentTime> 0 après une courte attente (en progression), etvideoWidth/videoHeightcorrespondent à l'encodage.- Vérifiez bureau et mobile, et que la page n'a pas de débordement horizontal.
Liens connexes
- [[everjust-website-customization]] — service via pièces jointes Odoo + intégration dans la vue.
- [[cdp-render-verification]] — la preuve de lecture.
- [[remotion]] / [[moviepy]] — création/animation de vidéo (le travail inverse).