AMP
繁體中文
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-1.0.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