網頁嵌入影片優化
將來源片段(螢幕錄製、手機匯出、HEVC 渲染)轉換為快速、清晰、可靠自動播放的橫幅/背景/循環影片並嵌入。通常能獲得顯著改善:Retina 感知的 H.264 搭配合理的 CRF 值,能將 1080p 螢幕錄製從約 8 MB 壓縮至約 1.5 MB,且幾乎無可見畫質損失,並修復自動播放與編解碼器問題。
若需要創作或動畫影片,請改用 [[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. 轉碼(網頁安全 + 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— Safari 與廣泛支援的必備設定(yuv444/422 無法播放)。-movflags +faststart— 將 moov atom 移到前端,讓影片在完全下載前就能開始播放。缺少此選項,自動播放的橫幅在慢速網路下會停滯。-an— 移除音訊;靜音的背景循環從不需要音軌(檔案更小)。scale=1600:-2— 編碼為約CSS 顯示寬度的 2 倍,而非原始 1080p/4K。在 ≤820px 的框架中,1600px 能達到 Retina 清晰度且檔案更輕。-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 傳輸二進位檔案(shell 在容器內執行)。使用全新的附件 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]] — 創作/動畫影片(相反的工作)。