手動廣告插播播放

本指南將說明如何覆寫預設廣告插播時間表，以及設定自己的廣告插播播放時間。實作手動廣告插播播放功能時，SDK 會在廣告插播載入時觸發 AD_BREAK_READY 事件，並等待您開始播放廣告插播。

必要條件

  • 已導入 IMA SDK 的 Android 應用程式。

設定手動廣告插播

如何設定手動廣告插播時間點播放功能：

  1. 告訴 SDK 您要控制廣告插播播放作業。
  2. 監聽 AD_BREAK_READY 事件。
  3. 準備就緒後，請告知 SDK 播放廣告。

以下程式碼片段示範了進階範例中必須修改的部分，才能手動播放廣告插播時間點。

public VideoPlayerController(
      Context context,
      VideoPlayerWithAdPlayback videoPlayerWithAdPlayback,
      View playButton,
      View playPauseToggle,
      String language,
      ViewGroup companionViewGroup,
      Logger log) {
  ...
  
  sdkFactory = ImaSdkFactory.getInstance();
  ImaSdkSettings imaSdkSettings = sdkFactory.createImaSdkSettings();
  imaSdkSettings.setLanguage(language);
  // Tell the SDK you want to control ad break playback.
  imaSdkSettings.setAutoPlayAdBreaks(false);
  
  ...
}
...
@Override
public void onAdEvent(AdEvent adEvent) {
    ...
    switch (adEvent.getType()) {
      // Listen for the AD_BREAK_READY event.
      case AD_BREAK_READY:
        // Tell the SDK to play ads when you're ready. To skip this ad break,
        // simply return from this handler without calling adsManager.start().
        adsManager.start();
        break;
      ...
}

常見問題

導入 IMA SDK 時，是否需要手動播放廣告？
不需要。發布商如果不希望 IMA SDK 依照廣告規則或 VMAP 回應排定的時間，自動播放廣告插播，可以選擇手動播放廣告。