直播预提取

IMA SDK 可用于通过直播和视频点播创收。 对于直播,您需要为每个广告插播时间点发送新的广告请求。 错开这些请求,确保不会有观看者在请求 导致广告服务器出现卡顿。

为帮助解决这个问题,IMA SDK 提供了 AdsRequest.liveStreamPrefetchSeconds 属性。此属性用于指定 SDK 的秒数上限 在您调用 AdsLoader.requestAds()。实际请求时间将随机分配。对于 例如,如果您将 AdsRequest.liveStreamPrefetchSeconds 设置为 30,则 SDK 在您调用 AdsLoader.requestAds() 后,系统将等待 0 到 30 秒, 向服务器发出请求。

直播预提取功能的实际运用

我们建议您在广告插播结束后立即预提取下一个广告插播时间点。 这样可以确保预提取期限的最长时间。 假设广告插播时间点有 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();
}