为直播加载前贴片广告

适用于 iOS 的 Google 互动式媒体广告 (IMA) SDK。

IMA SDK 可用于通过直播视频和视频点播创收。 对于直播，您需要为每个广告插播时间点发出新的广告请求。 错开这些请求，以确保所有观看者不会同时请求广告，从而避免广告服务器不堪重负。

为了帮助解决此问题，IMA SDK 提供了 AdsRequest.liveStreamPrefetchSeconds 属性。此属性用于指定在您调用 AdsLoader.requestAds() 后，SDK 在连接到广告服务器之前应等待的最长时间（以秒为单位）。实际请求时间将随机化。例如，如果您将 AdsRequest.liveStreamPrefetchSeconds 设置为 30，则 SDK 会在您调用 AdsLoader.requestAds() 后等待 0 到 30 秒，然后才实际向服务器发出请求。

直播预提取实践

我们建议您在广告插播结束时立即预提取下一个广告插播。 这样可确保预取窗口具有最长的时间长度。假设您在广告插播时间点之间有 5 分钟的时间。当广告插播时间点结束时，您可以请求下一个广告插播时间点，预提取窗口为 290 秒（5 分钟减去 10 秒，以确保在预提取窗口结束时发送的请求有足够的时间来解析）：

Objective-C


- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {

  ...

  switch (event.type) {

    ...

    case kIMAAdEvent_ALL_ADS_COMPLETED:

      IMAAdsRequest *request = [[IMAAdsRequest alloc]
             initWithAdTagUrl: self.adTagUrl
           adDisplayContainer: self.adDisplayContainer
         avPlayerVideoDisplay: self.avPlayerVideoDisplay
        pictureInPictureProxy: self.pictureInPictureProxy
                  userContext: nil];

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      Float64 adGap = 30;
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5;
      [self.adsLoader requestAdsWithRequest:request];
      // start new ads after adGap seconds have elapsed
      dispatch_after(dispatch_time(DISPATCH_TIME_NOW, adGap * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
        [adsManager start];
      });

      break;

    ...

  }

  ...

}

Swift

func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {
  switch event.type {

    ...

    case IMAAdEventType.ALL_ADS_COMPLETED:

      let request = IMAAdsRequest(
        adTagUrl: AdTagUrl,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: nil)

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      let adGap = 30
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5
      adsLoader.requestAds(with: request)
      // start new ads after adGap seconds have elapsed
      DispatchQueue.main.asyncAfter(deadline: .now() + adGap) {
        adsManager.start()
      }

      break

    ...
  }
}