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”。

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

data-embed

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

data-video-id

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

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