預先載入媒體內容

IMA SDK 支援預先載入影片廣告素材資源。您可以在 SDK 整合中啟用這項功能，讓廣告和內容之間的轉換更加流暢。本指南將介紹使用 IMA SDK 實作媒體預先載入功能的技術細節。

修課條件

預先載入功能需要 IMA Android SDK 3.17.0 以上版本。

啟用預先載入功能

如要啟用預先載入功能，請使用 AdsRenderingSettings.setEnablePreloading() 將預先載入設為 true。這項操作必須在 onAdsManagerLoaded() 回呼中完成：

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent adsManagerLoadedEvent) {
  ...
  AdsRenderingSettings adsRenderingSettings =
      ImaSdkFactory.getInstance().createAdsRenderingSettings();
  adsRenderingSettings.setEnablePreloading(true);
  mAdsManager.init(adsRenderingSettings);
}

使用自訂 VideoAdPlayer 支援預先載入

我們建議您使用 Android ExoPlayer 範例應用程式中使用的 ExoPlayer-IMA 擴充功能。整合後，ExoPlayer-IMA 擴充功能會預設啟用預先載入功能，並提供內建的預先載入支援功能。

如果您在未使用 ExoPlayer-IMA 擴充功能的情況下實作預先載入功能，則在呼叫 setEnablePreloading() 時，需要進行額外變更。為了讓影片播放器支援預先載入廣告，必須追蹤從 loadAd() 和 playAd() 呼叫傳遞的 AdMediaInfo 物件，並在 AdPlayerCallback 呼叫中加入正確的 AdMediaInfo。由於後續 AdMediaInfo 的 loadAd() 可能會在先前 AdMediaInfo 播放時發生，因此這可能需要資料結構來管理 AdMediaInfo 物件。以下範例說明應用程式可能需要進行的部分變更，才能支援預先載入功能：

// enum for cases of PlayerState.
static enum PlayerState {
  IDLE,
  LOADED,
  PLAYING,
  PAUSED,
}

...

private final List<VideoAdPlayer.VideoAdPlayerCallback> callbacks;
private final ArrayList<AdMediaInfo> mediaInfos = new ArrayList<>();
private PlayerState playerState;
private boolean adCurrentlyLoaded;

...

@Override
public void playAd(AdMediaInfo adMediaInfo) {
  switch (playerState) {
    case LOADED:
      for (VideoAdPlayerCallback callback : callbacks) {
        callback.onPlay(adMediaInfo);
      }
      break;
    case PAUSED:
      for (VideoAdPlayerCallback callback : callbacks) {
        callback.onResume(adMediaInfo);
      }
      break;
    case PLAYING:
      // Intentionally and silently ignore since it is already playing from a prior media item,
      // note that onPlay is triggered by positionDiscontinuity.
      return;
    case IDLE:
      throw new IllegalStateException("Call to playAd when player state is not LOADED.");
  }
  playerState = PlayerState.PLAYING;
  player.setPlayWhenReady(true);
}

@Override
public void loadAd(AdMediaInfo adMediaInfo, AdPodInfo adPodInfo) {
  if (adCurrentlyLoaded == true) {
    mediaInfos.add(adMediaInfo);
    return;
  }
  player.stop();
  player.seekTo(0);
  mediaInfos.clear();
  mediaInfos.add(adMediaInfo);
  player.setPlayWhenReady(false);
  player.loadMedia(adMediaInfo.getUrl());
  playerState = PlayerState.LOADED;
  adCurrentlyLoaded = true;
}

@Override
public void stopAd(AdMediaInfo adMediaInfo) {
  if (allAdsInBreakHavePlayed()) {
    if (isFinalAd(adMediaInfo)) {
      // handle clean up after all ads have played.
    } else {
      seekToNextItem(player);
    }
  } else {
    mediaInfos.remove(adMediaInfo);
  }
}

private boolean allAdsInBreakHavePlayed() {
  // Code to determine if all the ads in the current ad break have completed.
}

private boolean isFinalAd(AdMediaInfo adMediaInfo) {
  // Code to determine if this adMediaInfo is the final ad.
}

private void seekToNextItem(YourPlayerClass player) {
  // Code to seek your player to the next media item.
}

測試自訂預先載入實作

針對自訂預先載入實作項目，建議您測試下列極端情況，以驗證正確的預先載入設定：

• 單一廣告片頭
• 3 個廣告連播片頭廣告
• 3 個廣告連播片中廣告
• 在第一個中插廣告開始預先載入但尚未播放時，尋找第二個中插廣告
• 片尾廣告播放

時間

下表概略說明啟用預先載入功能後，廣告載入時間的變更情形：

活動	附預先載入	不使用預先載入
已要求的廣告 VAST	AdsLoader.requestAds()	AdsLoader.requestAds()
載入片頭廣告 (單一廣告)	AdsManager.init()	AdsManager.start()
載入片頭廣告 (VMAP/廣告規則)	AdsManager.init()	AdsManager.init()
載入片中或片尾廣告	廣告插播中第 1 個廣告的廣告開始時間前 8 秒。 如果是連續廣告，則是上一個廣告開始播放時。	廣告開始播放時。

常見問題

媒體預先載入功能是否會載入完整廣告素材？

否，廣告素材通常不會在廣告開始播放時就完全載入。預先載入可縮短廣告載入時間，進而改善使用者體驗。不支援離線廣告放送。

是否需要為廣告的 VAST 和媒體啟用媒體預先載入功能？

否，無論預先載入設定為何，SDK 一律會預先載入廣告的 VAST。