Web埋め込み動画最適化
ソースクリップ(画面収録、スマートフォン書き出し、HEVCレンダリング)を、高速で鮮明、確実に自動再生される ヒーロー/背景/ループ動画に変換し、埋め込みます。効果は通常大きく、網膜ディスプレイ対応のH.264を適切なCRFでエンコードすることで、1080pの画面収録が約8MBから目に見える劣化なく約1.5MBになり、自動再生やコーデックの問題も解決します。
動画の作成やアニメーションには、代わりに [[remotion]] / [[moviepy]] / [[motion-canvas]] を使用してください。このスキルは既存の映像素材を最適化します。
使用するタイミング
- サイトのヒーロー、背景、またはループするデモ動画を追加/置き換える場合。
- 動画が重すぎる、自動再生できない(モバイル/Safari)、コーデックでエラーが発生する、またはぼやけて見える場合。
レシピ
1. まずプローブ
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 # 音声?
# faststartの確認: 'moov' が 'mdat' より前にあるか? (moovが末尾にあると起動が遅い)
2. トランスコード(Webセーフ + 網膜ディスプレイ対応)
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— Safari/広範なサポートに必須(yuv444/422は再生不可)。-movflags +faststart— moovアトムを先頭に移動し、完全にダウンロードされる前に再生を開始できるようにします。これがないと、自動再生ヒーローが遅いリンクで停止します。-an— オーディオを除去。ミュートされた背景ループでは不要です(ファイルサイズが小さくなります)。scale=1600:-2— ネイティブの1080p/4Kではなく、CSS表示幅の約2倍にエンコードします。フレームが≤820pxの場合、1600pxで網膜ディスプレイに鮮明であり、はるかに軽量です。-2は高さを偶数に保ちます(H.264で必要)。-crf 23 -preset slow— 高品質、良好な圧縮。画面/UIコンテンツは特に圧縮効率が良いです。それでもファイルが重い場合のみ、CRFを25~26に上げてください。
3. ポスターフレーム
ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg
空白のイントロフレームではなく、代表的な瞬間(-ss)を選びます。
4. 埋め込み
<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
<source src="/path/out.mp4" type="video/mp4"/>
</video>
muted+playsinline+autoplayはモバイルでの自動再生にすべて必須です。- コンテナCSS:
video{display:block;width:100%;height:auto}とすると、16:9のクリップが自身の高さを設定できます。枠で囲み、overflow:hidden;border-radiusを設定します。
5. 配信(Odooテナント)
公開 ir.attachment として保存し、/web/content/<id>(動画)と /web/image/<id>(ポスター)で参照します — [[everjust-website-customization]] を参照してください。バイナリは docker cp で転送します(シェルはコンテナ内で実行)。新しい添付ファイルID を使用してビューを再ポイントし、古いIDを上書きしないようにして、ブラウザ/CDNキャッシュの問題を回避します。ビューの編集後は、レンダリングのためにコンテナの再起動が必要です。
確認(必須)
実際に再生されることを、[[cdp-render-verification]] を使用して確認します — Chromeを --autoplay-policy=no-user-gesture-required で起動し、<video> 要素を読み取ります:
readyState=== 4 (HAVE_ENOUGH_DATA)、paused=== false、短い待機後にcurrentTime> 0(進行中)、videoWidth/videoHeightがエンコードと一致すること。- デスクトップとモバイルの両方で確認し、ページに水平方向のオーバーフローがないことを確認します。
関連
- [[everjust-website-customization]] — Odoo添付ファイル+ビュー埋め込みによる配信。
- [[cdp-render-verification]] — 再生の証明。
- [[remotion]] / [[moviepy]] — 動画の作成/アニメーション(逆の作業)。