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 播放器都需要此项。

默认情况下，这不用于 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 规则。