SuperAPI AI 工具集

youtube-embed

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:在不拖慢页面的前提下嵌入 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;键盘可访问。

限制:资料未提供具体价格、平台适配范围、依赖版本及更详细的安装命令等信息。