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>

支援的版面配置

範例

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" 變成 &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 外掛程式傳遞到播放器的 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 擴充功能。 如果存在此屬性且影片正在手動播放，則當使用者捲動到影片元件的可視區域之外時，影片將會「最小化」並固定到角落或元素。
有關更多詳細資訊，請參閱 關於停駐擴充功能本身的說明文件。
通用屬性 此元素包含 擴充至 AMP 元件的通用屬性。

驗證

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

需要更多協助嗎？

您已經閱讀這份文件十幾次了，但它仍然沒有涵蓋您的所有問題？也許其他人也有相同的感受：在 Stack Overflow 上與他們聯繫。

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

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

前往 GitHub