Web 视频嵌入优化
将原始剪辑(屏幕录制、手机导出、HEVC 渲染)转换为快速、清晰、可靠自动播放的英雄区/背景/循环视频并嵌入。通常能带来显著收益:视网膜适配的 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. 转码(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— 编码为大约 CSS 显示宽度的 2 倍,而非原生 1080p/4K 分辨率。在 ≤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的 div 包裹。
5. 服务端(Odoo 租户)
存储为公共 ir.attachment,并通过 /web/content/<id>(视频)和 /web/image/<id>(封面)引用——参见 [[everjust-website-customization]]。通过 docker cp 传输二进制文件(Shell 在容器内运行)。使用新的附件 ID 并重新指向视图,而不是覆盖旧 ID,以避免浏览器/CDN 缓存过期。视图编辑后需要重启容器才能生效。
验证(必须执行)
使用 [[cdp-render-verification]] 确认视频确实能播放——用 --autoplay-policy=no-user-gesture-required 启动 Chrome,然后读取 <video> 元素:
readyState=== 4(HAVE_ENOUGH_DATA),paused=== false,短暂等待后currentTime> 0(正在前进),且videoWidth/videoHeight与编码参数匹配。- 检查桌面端和移动端,并确保页面没有水平溢出。
相关
- [[everjust-website-customization]] — 通过 Odoo 附件服务 + 视图嵌入。
- [[cdp-render-verification]] — 播放验证方法。
- [[remotion]] / [[moviepy]] — 创建/制作动画视频(相反的任务)。