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 或「預設值」。預設值和最常見的值為「預設值」。

data-video-id

Video Cloud 影片 ID。大多數 Video Cloud 播放器都會需要此 ID。

預設情況下，這不適用於 Perform 播放器；如果您已新增外掛程式，而該外掛程式預期查詢字串中會有 videoId 參數，則請使用此 ID。

data-playlist-id

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

預設情況下，這不適用於 Perform 播放器；如果您已新增外掛程式，而該外掛程式預期查詢字串中會有 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 規則。