預先擷取預先擷取

IMA SDK 可用來透過直播和隨選影片營利。 如果是直播，您必須針對每個廣告插播發出新的廣告請求。 分散這些要求，確保所有觀眾都沒有提出要求 同時關閉廣告伺服器。

為解決這個問題，IMA SDK 採用 AdsRequest.liveStreamPrefetchSeconds 資源。這個屬性會指定 SDK 的秒數上限 請於呼叫後與廣告伺服器連線 AdsLoader.requestAds()。實際要求時間會隨機增加。適用對象 舉例來說，如果將 AdsRequest.liveStreamPrefetchSeconds 設為 30，SDK 您呼叫 AdsLoader.requestAds() 後會等待 0 到 30 秒 向伺服器發出要求

注意： 如要查看完整的直播預先擷取範例，請參閱 GitHub 範例。

直播預先擷取

建議您在廣告時段完成後，立即預先擷取下一個廣告插播。 這麼做可確保預先擷取視窗能夠使用的時間長度上限。 假設您有 5 分鐘的廣告插播時間。廣告時段播放完畢後 可以利用 290 秒的預先擷取視窗來請求下一個廣告插播 (5 分鐘減 10 秒，以確保在最後傳送要求) 預先擷取視窗有足夠的時間可以解析)：

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the "Get Started" guide in the prerequisites above.
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(
      <linear_width>,  <linear_height>, google.ima.ViewMode.NORMAL);
  adsManager.start();
}