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 video"。

通用属性

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

验证

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