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 Player，用於 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 Support 外掛程式搭配使用的播放器，以支援 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 播放器都需要此 ID。

預設情況下，Perform 播放器不會使用此 ID；如果您已新增預期查詢字串中包含 videoId 參數的外掛程式，則可以使用此 ID。

data-playlist-id

Video Cloud 播放清單 ID。對於 AMP HTML，通常會改為使用影片 ID。如果同時指定播放清單和影片，則播放清單優先。

預設情況下，Perform 播放器不會使用此 ID；如果您已新增預期查詢字串中包含 playlistId 參數的外掛程式，則可以使用此 ID。

data-referrer

設定要在播放器中用於 Video Cloud 分析的參照位址。需要 Brightcove Player 版本 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 規則。