AMP
繁
德語 法語 阿拉伯語 西班牙語 義大利語 印尼語 日語 韓語 葡萄牙語 俄語 土耳其語 簡體中文 波蘭語 越南語

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

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-* 用於覆寫廣告標籤中巨集預設值的屬性。支援的巨集包括
  • 網域
  • 參照網址
  • 頁面網址
  • 項目-{custparam}
  • 項目-{custparam}-清單
data-ad-macro-domain="jwplayer.com" 會改為將 "jwplayer.com" 替換為 __domain__ 巨集。

如需更多資訊，請參閱 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 文件。
自動播放 如果存在此屬性，且瀏覽器支援自動播放，則影片將會在變得可見時自動播放。元件需要滿足一些條件才能播放，AMP 規格中的影片中概述了這些條件。
停駐 需要 amp-video-docking 擴充功能。 如果存在此屬性且影片為手動播放，則當使用者捲動超出影片元件的可視區域時，影片將會「最小化」並固定在角落或元素上。
如需更多詳細資訊，請參閱 關於停駐擴充功能本身的說明文件。
通用屬性 此元素包含延伸至 AMP 元件的 通用屬性。

驗證

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

需要更多協助嗎？

您已閱讀此文件數十次，但仍未真正涵蓋您的所有問題嗎？也許其他人也有同感：請在 Stack Overflow 上與他們聯繫。

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

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

前往 GitHub