手動啟動廣告插播

選取平台： Android iOS

本指南提供操作說明，說明如何覆寫預設廣告插播時間表，以及設定自己的廣告插播播放時間。實作手動廣告插播播放功能時，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 回應排定的時間自動播放廣告插播，即可使用這項功能。