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 播放器。

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、短 ID 或“default”。默认值为“default”。

data-player 优先。data-player-id 也受支持，以实现向后兼容。

data-embed

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

data-video-id

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

默认情况下，Perform 播放器不使用此 ID；如果你添加了一个在查询字符串中需要 videoId 参数的插件，则使用此 ID。

data-playlist-id

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

默认情况下，Perform 播放器不使用此 ID；如果你添加了一个在查询字符串中需要 playlistId 参数的插件，则使用此 ID。

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 规则。