amp-ima-video

<script async custom-element="amp-ima-video" src="https://cdn.ampproject.org/v0/amp-ima-video-0.1.js"></script>

用法

使用 amp-ima-video 组件嵌入启用 IMA SDK 的视频播放器。

该组件需要一个广告代码，在 data-tag 中提供，它是一个符合 VAST 标准的广告响应的 URL（示例请参见 IMA 示例代码）。

该组件 HTML 接受以下类型的 HTML 节点作为子节点

• 用于内容视频的 source 标记，使用方式与标准 video 标记相同。
• 用于字幕的 track 标记，使用方式与标准 video 标记相同。如果轨道托管在与文档不同的来源上，则必须将 data-crossorigin 属性添加到 <amp-ima-video> 标记中。
• 类型为 application/json 的 script 标记，用于提供 ImaSdkSettings。在链接的文档中提供 setter 的属性转换（例如，要调用 setNumRedirects(4)，请提供 {"numRedirects": 4}）。

<amp-ima-video
  width="640"
  height="360"
  layout="responsive"
  data-tag="ads.xml"
  data-poster="poster.png"
>
  <source src="foo.mp4" type="video/mp4" />
  <source src="foo.webm" type="video/webm" />
  <track
    label="English subtitles"
    kind="subtitles"
    srclang="en"
    src="subtitles.vtt"
  />
  <script type="application/json">
    {
      "locale": "en",
      "numRedirects": 4
    }
  </script>
</amp-ima-video>

属性

data-tag（必需）

您的 VAST 广告文档的 URL。相对 URL 或使用 https 协议的 URL。

data-src

您的视频内容的 URL。相对 URL 或使用 https 协议的 URL。如果没有 <source> 子元素，则此属性是必需的。

data-crossorigin

如果 track 资源托管在与文档不同的来源上，则为必需。

data-poster（可选）

在视频播放开始之前显示的帧的图像。默认情况下，显示第一帧。

data-delay-ad-request（可选）

如果为 true，则将广告请求延迟到用户滚动页面或 3 秒（以先发生者为准）。默认为 false。

data-ad-label（可选）

一个看起来像“广告（%s / %s）”的格式字符串，用于在播放广告时生成广告披露。“%s”在格式字符串中分别替换为序列中的当前广告编号和广告总数（例如，广告 2 / 3）。这允许用户支持不同语言的广告披露。如果未给定值，则默认为“广告（%s / %s）”。

dock

需要 amp-video-docking 扩展。如果存在此属性并且视频是手动播放的，则当用户滚动出视频组件的可视区域时，视频将被“最小化”并固定到角落或元素。有关更多详细信息，请参阅 关于停靠扩展本身的文档。

title（可选）

为组件定义一个 title 属性，以传播到基础 <iframe> 元素。默认值为 “IMA 视频”。

通用属性

此元素包括扩展到 AMP 组件的通用属性。

验证

请参阅 AMP 验证器规范中的 amp-ima-video 规则。