amp-brightcove

1.0 0.1

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

用法

amp-brightcove 组件显示 Brightcove 播放器，如 Brightcove 的 Video Cloud 或 Brightcove Player 中所使用。

width 和 height 属性决定了在响应式布局中嵌入的播放器的纵横比。

<amp-brightcove
  data-account="12345"
  data-player="default"
  data-embed="default"
  data-video-id="1234"
  layout="responsive"
  width="480"
  height="270"
>
</amp-brightcove>

播放器配置

确保您配置与 AMP 支持插件一起使用的播放器以支持 AMP 的视频接口。有关播放器配置说明，请参阅 Brightcove 的支持文档。

组件属性

data-account

Brightcove Video Cloud 或 Perform 帐户 ID。

data-player 或 data-player-id

Brightcove 播放器 ID。这是一个 GUID、shortid 或“default”。默认值为“default”。

首选 data-player。为了向后兼容，也支持 data-player-id。

data-embed

Brightcove 播放器 ID。这是一个 GUID 或“default”。默认值和最常见的值是“default”。

data-video-id

Video Cloud 视频 ID。大多数 Video Cloud 播放器都需要此项。

默认情况下，这不用于 Perform 播放器；如果您添加了需要查询字符串中的 videoId 参数的插件，请使用它。

data-playlist-id

Video Cloud 播放列表 ID。对于 AMP HTML，通常会使用视频 ID 来代替。如果同时指定了播放列表和视频，则播放列表优先。

默认情况下，这不用于 Perform 播放器；如果您添加了需要查询字符串中的 playlistId 参数的插件，请使用它。

data-referrer

设置用于播放器中 Video Cloud 分析的引荐来源网址。需要 Brightcove 播放器版本 v6.25.0+。这支持 AMP 变量，例如 EXTERNAL_REFERRER。

data-param-*

所有 data-param-* 属性都将作为查询参数添加到播放器 iframe src。这可用于将自定义值传递给播放器插件，例如 Perform 播放器的广告参数或视频 ID。

键和值将进行 URI 编码。键将使用驼峰式命名。

• data-param-language="de" 变为 &language=de
• data-param-custom-ad-data="key:value;key2:value2" 变为 &customAdData=key%3Avalue%3Bkey2%3Avalue2

autoplay

如果存在此属性，并且浏览器支持自动播放，则视频将在可见时自动播放。该组件需要满足一些条件才能播放，这些条件在 AMP 规范中的视频中概述。

dock

需要 amp-video-docking 扩展程序。如果存在此属性且视频是手动播放的，则当用户滚动出视频组件的可视区域时，视频将被“最小化”并固定到角落或元素上。

有关更多详细信息，请参阅有关停靠扩展本身的文档。

data-block-on-consent

如果使用 amp-consent，添加 data-block-on-consent="_till_responded" 将延迟播放器的加载，直到同意状态得到解决。同意状态会作为查询参数传递到播放器的 iframe，以便在播放器中自定义广告实现。有关播放器配置说明，请参阅 Brightcove 的支持文档。

通用属性

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

验证

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