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-1.0.js"></script>

支援的版面配置

範例

amp-jwplayer

範例

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" becomes &token=abc
  • data-player-param-custom-data="key:value;key2:value2" becomes &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" would instead substitute "jwplayer.com" in for the __domain__ macro.

請參閱 JW Player 的 廣告標籤目標巨集 以取得更多資訊。
data-config-plugin-url 用於將外部 JS 外掛程式傳遞給播放器的 URL 字串。
data-config-skin-url 用於將外部 CSS 樣式傳遞給播放器的 URL 字串。請參閱 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 擴充功能。 如果存在此屬性且影片是手動播放，則當使用者滾動離開影片元件的可視區域時，影片將會「最小化」並固定在角落或元素上。
如需更多詳細資訊，請參閱 關於 docking 擴充功能本身的說明文件。
通用屬性 此元素包含擴充到 AMP 元件的 通用屬性。

驗證

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

需要更多協助嗎？

您已閱讀本文檔十幾次，但它仍然沒有涵蓋您的所有問題？ 也許其他人也有同樣的感覺：在 Stack Overflow 上與他們聯繫。

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

AMP 專案非常鼓勵您的參與和貢獻！ 我們希望您能成為我們開放原始碼社群的持續參與者，但我們也歡迎針對您特別熱衷的問題進行一次性貢獻。

前往 GitHub