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>标签中。
• 用于提供ImaSdkSettings的类型为application/json的script标签。提供链接文档中设置器的属性翻译（例如，要调用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 广告文档的网址。相对网址或使用 https 协议的网址。

data-src

您的视频内容的网址。相对网址或使用 https 协议的网址。如果不存在<source>子项，则此属性为必需属性。

data-crossorigin

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

data-poster（可选）

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

data-delay-ad-request（可选）

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

data-ad-label（可选）

类似于“广告 (%s of %s)”的格式字符串，用于在播放广告时生成广告披露信息。格式字符串中的“%s”分别替换为序列中的当前广告编号和广告总数（例如，广告 2/3）。这允许用户支持不同语言的广告披露信息。如果未提供值，则默认为“广告 (%s of %s)”。

dock

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

title（可选）

为组件定义一个title属性，以传播到底层的<iframe>元素。默认值为"IMA video"。

通用属性

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

验证

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