AMP
EN
Deutsch Français العربية Español Italiano Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt

重要事項：本文件不適用於您目前選取的格式 廣告！

amp-jwplayer

說明

顯示雲端託管的 JW Player。

 

必要指令碼

<script async custom-element="amp-jwplayer" src="https://cdn.ampproject.org/v0/amp-jwplayer-0.1.js"></script>

支援的版面配置

範例

width 和 height 屬性決定了嵌入於回應式版面配置中的播放器長寬比。

範例

<amp-jwplayer
  data-player-id="aBcD1234"
  data-media-id="5678WxYz"
  layout="responsive"
  width="16"
  height="9"
>
</amp-jwplayer>

也支援非回應式版面配置。

範例

<amp-jwplayer
  data-player-id="aBcD1234"
  data-playlist-id="5678WxYz"
  width="160"
  height="90"
>
</amp-jwplayer>

屬性

data-player-id JW Platform 播放器 ID。這是一個 8 位數的英數字元序列，可以在您的 JW Player 儀表板的「播放器」區段中找到。(必填)
data-media-id JW Platform 媒體 ID。這是一個 8 位數的英數字元序列，可以在您的 JW Player 儀表板的「內容」區段中找到。(若未定義 data-playlist-id 則為必填。)。注意：outstream 也是有效值。
data-playlist-id JW Platform 播放清單 ID。這是一個 8 位數的英數字元序列，可以在您的 JW Player 儀表板的「播放清單」區段中找到。如果同時指定了 data-playlist-id 和 data-media-id，則以 data-playlist-id 為優先。(若未定義 data-media-id 則為必填。)
data-content-search 表示播放清單的類型。如果需要情境文章比對，請使用值 `__CONTEXTUAL__`。如果需要搜尋播放清單，請輸入用於產生搜尋播放清單的關鍵字或詞組。
data-content-backfill 確保搜尋或情境播放清單始終返回結果。如果給定查詢沒有相關結果，此參數可確保改為提供熱門影片列表。(布林值，預設值：true)
data-player-querystring 將新增至播放器 iframe src 的參數查詢字串。這可用於權杖簽署之類的功能。
data-player-param-* 將作為查詢參數新增至播放器 iframe src 的屬性。

金鑰和值將會進行 URI 編碼。金鑰將會使用駝峰式命名。
  • data-player-param-token="abc" 變成 &token=abc
  • data-player-param-custom-data="key:value;key2:value2" 變成 &customData=key%3Avalue%3Bkey2%3Avalue2
是使用 data-player-querystring 的替代方案。
data-ad-cust-params 要新增至廣告代碼的自訂參數 JSON 字串。
data-ad-cust-params='{
      "key1": "value"
    }'
data-ad-macro-* 用於覆寫廣告代碼中巨集預設值的屬性。支援的巨集包括
  • domain (網域)
  • referrer (參照網址)
  • page-url (頁面網址)
  • item-{custparam}
  • item-{custparam}-list
data-ad-macro-domain="jwplayer.com" 會將 "jwplayer.com" 替換為 __domain__ 巨集。

有關更多資訊，請參閱 JW Player 的「廣告代碼指定目標巨集」。
data-config-plugin-url 用於將外部 JS 外掛程式傳遞到播放器的網址字串。
data-config-skin-url 用於將外部 CSS 佈景主題傳遞到播放器的網址字串。有關更多資訊，請參閱 JW Player 的「CSS 佈景主題參考」。
data-config-json 播放器設定的 JSON 字串。這可用於在播放器上設定特定的設定屬性。
data-config-json='{"playbackRateControls":true,"displaytitle":false}'
也可以使用此方法指定廣告設定。
data-config-json='{
      "advertising": {
        "client": "vast",
        "schedule": [
          {
            "tag": "http://adserver.com/vastTag.xml",
            "offset": "pre"
          }
        ]
      }
    }'
媒體和捲動時浮動屬性無法使用此屬性進行設定。請在您的 JW Player 儀表板中更新媒體屬性。有關更多資訊，請參閱 JW Player 的「播放器設定參考」。
data-block-on-consent 需要 amp-consent 擴充功能。 如果存在此屬性，播放器載入將會延遲，直到同意狀態獲得解決。然後，同意資料將作為查詢參數傳遞到播放器的 iframe，以用於廣告實作。
有關更多詳細資訊，請參閱 amp-consent 文件。
autoplay (自動播放) 如果存在此屬性，且瀏覽器支援自動播放，則影片將在可見時自動播放。元件需要滿足一些條件才能播放，這些條件在 AMP 規格中的影片章節中概述。
dock (停駐) 需要 amp-video-docking 擴充功能。 如果存在此屬性且影片是手動播放，當使用者捲動離開影片元件的可視區域時，影片將會「最小化」並固定到角落或元素。
有關更多詳細資訊，請參閱 關於停駐擴充功能本身的文件。
通用屬性 此元素包含 擴充到 AMP 元件的通用屬性。

驗證

請參閱 AMP 驗證器規格中的 amp-jwplayer 規則。

需要更多協助嗎？

您已經閱讀這份文件很多次，但它仍然沒有真正涵蓋您的所有問題？也許其他人也有同樣的感覺：在 Stack Overflow 上與他們交流。

前往 Stack Overflow
發現錯誤或缺少功能？

AMP 專案強烈鼓勵您的參與和貢獻！我們希望您能成為我們開放原始碼社群的長期參與者，但我們也歡迎針對您特別關注的問題提供一次性貢獻。

前往 GitHub