手動廣告插播播放

本指南說明如何覆寫預設的廣告插播時段，以及設定自己的廣告插播播放時間。導入手動廣告插播播放功能時，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 回應排定的時間自動播放廣告插播，可以選擇手動播放廣告。