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 Sample Tags)。

此元件 HTML 接受以下 HTML 節點類型作為子項

• source 標籤用於內容影片，使用方式與標準 video 標籤相同。
• track 標籤用於字幕，使用方式與標準 video 標籤相同。如果 track 託管於與文件不同的來源，您必須將 data-crossorigin 屬性新增至 <amp-ima-video> 標籤。
• 類型為 application/json 的 script 標籤，用於提供 ImaSdkSettings。

<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 擴充功能。如果此屬性存在且影片為手動播放，當使用者捲動離開影片元件的可視區域時，影片會「最小化」並固定在角落或元素上。如需更多詳細資訊，請參閱 docking 擴充功能本身的說明文件。

title (選填)

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

通用屬性

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

驗證

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