amp-ima-video

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

用法

使用 amp-ima-video 元件嵌入已啟用 IMA SDK 的影片播放器。

此元件需要廣告代碼 (在 data-tag 中提供)，也就是符合 VAST 標準的廣告回應網址 (範例請參閱 IMA 範例代碼)。

元件 HTML 接受下列 HTML 節點類型做為子項

• 用於內容影片的 source 標記，使用方式與標準 video 標記相同。
• 用於字幕的 track 標記，使用方式與標準 video 標記相同。如果軌跡託管於與文件不同的來源，您必須將 data-crossorigin 屬性新增至 <amp-ima-video> 標記。
• 類型為 application/json 的 script 標記，用於提供 ImaSdkSettings。請在連結的文件中提供 setter 的屬性翻譯 (例如，若要呼叫 setNumRedirects(4)，請提供 {"numRedirects": 4})。

<amp-ima-video
  width="640"
  height="360"
  layout="responsive"
  data-tag="ads.xml"
  data-poster="poster.png"
>
  <source src="foo.mp4" type="video/mp4" />
  <source src="foo.webm" type="video/webm" />
  <track
    label="English subtitles"
    kind="subtitles"
    srclang="en"
    src="subtitles.vtt"
  />
  <script type="application/json">
    {
      "locale": "en",
      "numRedirects": 4
    }
  </script>
</amp-ima-video>

屬性

data-tag (必填)

您的 VAST 廣告文件的網址。相對網址或使用 https 通訊協定的網址。

data-src

您的影片內容的網址。相對網址或使用 https 通訊協定的網址。如果沒有 <source> 子項，則此屬性為必填。

data-crossorigin

如果 track 資源託管於與文件不同的來源，則為必填。

data-poster (選填)

在影片開始播放前顯示的影格圖片。預設會顯示第一個影格。

data-delay-ad-request (選填)

若為 true，則延遲廣告請求，直到使用者捲動頁面或經過 3 秒 (以先發生者為準)。預設值為 false。

data-ad-label (選填)

格式字串，看起來像「廣告 (%s / %s)」，用於在廣告播放時產生廣告揭露訊息。格式字串中的「%s」會分別替換為序列中的目前廣告編號和廣告總數 (例如，廣告 2 / 3)。這可讓使用者支援不同語言的廣告揭露訊息。如果未提供任何值，則預設為「廣告 (%s / %s)」。

dock

需要 amp-video-docking 擴充功能。如果此屬性存在且影片為手動播放，則當使用者捲動離開影片元件的可見區域時，影片將會「最小化」並固定在角落或元素上。如需更多詳細資訊，請參閱關於停駐擴充功能本身的說明文件。

title (選填)

為元件定義 title 屬性，以傳播至基礎 <iframe> 元素。預設值為 "IMA video"。

通用屬性

此元素包含擴充至 AMP 元件的通用屬性。

驗證

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