直播预提取

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

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

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

我们建议您在广告插播结束后立即预提取下一个广告插播时间点。 这样可以确保预提取期限的最长时间。 假设广告插播时间点有 5 分钟。广告插播结束后 您可以请求下一个广告插播时间点,预提取时间范围为 290 秒 (5 分钟减去 10 秒,以确保在末尾 预提取窗口有足够的时间解决):


- (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;

   
...

 
}

 
...

}

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

   
...
 
}
}