預先載入媒體

選取平台： HTML5 Android

IMA SDK 支援預先載入影片廣告素材資源。 您可以在 SDK 整合中啟用這項功能，讓廣告和內容之間的轉換更加流暢。本指南將說明使用 IMA SDK 導入媒體預先載入功能的技術細節。

啟用預先載入功能

如要啟用預先載入功能，請將 AdsRenderingSettings.enablePreloading 設為 true。這項操作必須在 ADS_MANAGER_LOADED 事件後執行：

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

時間

下表摘要說明啟用預先載入功能後，廣告載入時間的變化：

活動 預先載入 不使用預先載入模式
要求的廣告 VAST AdsLoader.requestAds() AdsLoader.requestAds()
已載入片頭廣告 (單一廣告) AdsManager.init() AdsManager.start()
已載入片頭廣告 (VMAP/廣告規則) AdsManager.init() AdsManager.init()
已載入片中或片尾廣告 廣告插播中的第 1 則廣告：廣告開始時間前 8 秒。 如果是連續廣告，則為前一個廣告開始播放時。 在廣告開始時間。

限制

預先載入功能有下列限制：

  • 在 iOS 裝置的行動版網站上，或是在連網智慧型電視上使用 HTML5 IMA SDK 時，無法預先載入媒體。
  • 系統會預先載入 VPAID，但廣告執行前，不會載入任何廣告的依附元件，包括廣告播放的媒體。
  • 必須啟用自動播放功能，才能預先載入 VMAP 廣告。確認 settings.isAutoPlayAdBreaks() 已設為預設值 true。
  • 如果使用 AdsRequest.contentDuration 設定時間長度，系統會在最後一個片中廣告後預先載入片尾廣告，或在內容結束前 8 秒載入。

常見問題

媒體預先載入功能是否會載入完整廣告素材？
否，廣告開始播放時，廣告素材通常尚未完全載入。 預先載入功能旨在縮短廣告載入時間，進而提升使用者體驗。這項功能並非用於支援離線放送廣告。 IMA SDK 會載入瀏覽器允許的媒體量，但會受到使用者網際網路連線和廣告素材大小的限制。
廣告的 VAST 和媒體是否都需要啟用媒體預先載入功能？
不會，無論預先載入設定為何，SDK 一律會預先載入廣告的 VAST。