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 标签相同。如果 track 托管在与文档不同的源上，则必须将 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 规则。