用途:在不拖慢页面的前提下嵌入 YouTube 视频。采用 facade 模式,点击前只渲染封面图与播放按钮,不加载 YouTube 的 iframe 和脚本,点击后才替换为 iframe 并自动播放,从而显著提升性能。
主要能力:
- Facade 模式:封面图加播放按钮,点击前无 iframe。
- 本地封面:下载并优化缩略图,本地存放。
- 隐私增强:只使用 youtube-nocookie.com。
- 互动追踪:点击时触发 GA4 video_play 事件。
- 结构化数据:为含视频页面添加 VideoObject 标记。
- 键盘可访问:支持 Enter/Space 操作。
流程:点击前显示封面图与播放按钮;点击后替换为 iframe、触发 GA4 事件并自动播放。
封面图:下载地址 https://i.ytimg.com/vi/{VIDEO_ID}/maxresdefault.jpg,maxres 不可用时回退 sddefault.jpg;可用 Picture skill 转换为 avif、webp、jpg;存放在 src/assets/videos/{slug}.jpg。
禁止事项:点击前加载 YouTube iframe/脚本;使用 youtube.com(必须用 youtube-nocookie.com);在视频 facade 上使用 fetchpriority="high";用 YouTube 标志作播放按钮(商标问题);使用远程封面图(必须本地);缺少封面图或标题。
完成标准:创建 VideoFacade 组件;封面图已下载并优化;点击触发 iframe 替换与自动播放;GA4 video_play 事件正常触发;含视频页面具备 VideoObject schema;键盘可访问。
限制:资料未提供具体价格、平台适配范围、依赖版本及更详细的安装命令等信息。