預先擷取預先擷取

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

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

直播預先擷取

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

下列程式碼片段顯示如何將直播預先擷取功能新增至 進階範例 ,但這個方法也適用於其他 IMA 導入。

VideoPlayerController.java

/** Ads logic for handling the IMA SDK integration code and events. */
public class VideoPlayerController {

 
// 5 minutes == 300 seconds. Include a 10 second buffer
 
private float AD_INTERVAL = 290;
 
private double AD_TIMEOUT = 300;


...

  adsManager
.addAdEventListener(
   
new AdEvent.AdEventListener() {
     
/** Responds to AdEvents. */
     
@Override
     
public void onAdEvent(AdEvent adEvent) {

     
...

     
case ALL_ADS_COMPLETED:
       
if (adsManager != null) {
          adsManager
.destroy();
          adsManager
= null;
       
}

       
// When pre-fetching for live streams, be sure to destroy the current AdsManager,
       
// in case the tag you requested previously contains post-rolls
       
// (you don't want to play those now).

       
// Pre-fetch the next ad break.
       
// Play those ads in ~5 minutes. In a real-world implementation,
       
// this will likely be done as the result of a message from your
       
// streaming server, not a via the playAdsAfterThisTime parameter
       
// of requestAndPlayAds().
        requestAndPlayAds
(AD_TIMEOUT);

       
break;
     
default:
       
break;
     
}
 
}

...

public void requestAndPlayAds(double playAdsAfterThisTime) {
 
if (currentAdTagUrl == null || currentAdTagUrl == "") {
    log
("No VAST ad tag URL specified");
    resumeContent
();
   
return;
 
}

 
// Since you're switching to a new video, tell the SDK the previous video is finished.
 
if (adsManager != null) {
    adsManager
.destroy();
 
}

  playButton
.setVisibility(View.GONE);

 
// Create the ads request.
 
AdsRequest request = sdkFactory.createAdsRequest();
  request
.setAdTagUrl(currentAdTagUrl);
  request
.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());
 
request.setLiveStreamPrefetchSeconds(AD_INTERVAL);

  playAdsAfterTime
= playAdsAfterThisTime;


 
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader
.requestAds(request);
}