Optimierung von Web-Video Einbettungen
Wandeln Sie einen Quellclip (Bildschirmaufnahme, Telefon-Export, HEVC-Rendering) in ein schnelles, scharfes, zuverlässig automatisch abspielendes Hero-/Hintergrund-/Loop-Video um und betten Sie es ein. Der Gewinn ist in der Regel groß: Ein retina-bewusstes H.264 mit einer angemessenen CRF reduziert eine 1080p-Bildschirmaufnahme von ~8 MB auf ~1,5 MB ohne sichtbaren Qualitätsverlust und behebt Autoplay-/Codec-Probleme.
Für das Erstellen oder Animieren von Videos verwenden Sie stattdessen [[remotion]] / [[moviepy]] / [[motion-canvas]] – dieses Skill optimiert bereits vorhandenes Filmmaterial.
Wann verwenden
- Hinzufügen/Ersetzen eines Hero-, Hintergrund- oder Schleifendemo-Videos auf einer Website.
- Das Video ist zu schwer, startet nicht automatisch (mobil/Safari), zeigt einen Codec-Fehler oder wirkt unscharf.
Rezept
1. Zuerst analysieren
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?
# faststart-Prüfung: Ist 'moov' vor 'mdat'? (moov am Ende = langsamer Start)
2. Transkodieren (websicher + retina-bewusst)
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– zwingend erforderlich für Safari/breite Unterstützung (yuv444/422 werden nicht abgespielt).-movflags +faststart– verschiebt das moov-Atom an den Anfang, sodass die Wiedergabe beginnt, bevor der gesamte Download abgeschlossen ist. Ohne diesen Parameter bleibt ein automatisch abspielendes Hero bei langsamen Verbindungen stecken.-an– Audio entfernen; eine stummgeschaltete Hintergrundschleife benötigt es nie (kleinere Datei).scale=1600:-2– Kodierung auf etwa 2× die CSS-Anzeigebreite, nicht native 1080p/4K. Bei einem Rahmen von ≤820px sind 1600px retina-scharf und viel leichter.-2behält eine gerade Höhe bei (von H.264 gefordert).-crf 23 -preset slow– hohe Qualität, gute Kompression. Bildschirm-/UI-Inhalte komprimieren besonders gut; erhöhen Sie CRF auf 25–26 nur, wenn die Datei immer noch zu groß ist.
3. Poster-Frame
ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg
Wählen Sie einen repräsentativen Zeitpunkt (-ss), keinen leeren Intro-Frame.
4. Einbetten
<video autoplay muted loop playsinline preload="auto" poster="/pfad/poster.jpg">
<source src="/pfad/out.mp4" type="video/mp4"/>
</video>
muted+playsinline+autoplaysind alle für die automatische Wiedergabe auf mobilen Geräten erforderlich.- Container-CSS:
video{display:block;width:100%;height:auto}erlaubt einem 16:9-Clip, seine eigene Höhe zu setzen; wickeln Sie ihn in einen Rahmen mitoverflow:hidden;border-radiusein.
5. Ausliefern (Odoo-Mandanten)
Speichern Sie als öffentliches ir.attachment und referenzieren Sie /web/content/<id> (Video) und /web/image/<id> (Poster) – siehe [[everjust-website-customization]]. Übertragen Sie die Binärdatei mittels docker cp (die Shell läuft innerhalb des Containers). Verwenden Sie frische Attachment-IDs und passen Sie die Ansicht an, anstatt alte IDs zu überschreiben, um veralteten Browser-/CDN-Cache zu vermeiden. Ansichtsänderungen erfordern einen Container-Neustart, um gerendert zu werden.
Überprüfen (obligatorisch)
Bestätigen Sie, dass es tatsächlich abgespielt wird, mit [[cdp-render-verification]] – starten Sie Chrome mit --autoplay-policy=no-user-gesture-required, lesen Sie dann das <video>-Element aus:
readyState=== 4 (HAVE_ENOUGH_DATA),paused=== false,currentTime> 0 nach kurzer Wartezeit (fortschreitend) undvideoWidth/videoHeightentsprechen der Kodierung.- Überprüfen Sie Desktop und Mobilgerät und dass die Seite keinen horizontalen Überlauf aufweist.
Verwandte Skills
- [[everjust-website-customization]] – Auslieferung über Odoo-Attachments + Ansichtseinbettung.
- [[cdp-render-verification]] – der Abspielnachweis.
- [[remotion]] / [[moviepy]] – Videos erstellen/animieren (die gegenteilige Aufgabe).