手動廣告插播播放

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