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

建議使用 data-player。data-player-id 也支援回溯相容性。

data-embed

Brightcove 播放器 ID。這是一個 GUID 或「預設值」。預設值和最常見的值為「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 規則。