手動で広告ブレークを再生

このガイドでは、デフォルトの広告ブレーク スケジュールをオーバーライドして、独自の広告ブレーク再生タイミングを設定する手順について説明します。手動広告ブレークの再生が実装されている場合、広告ブレークが読み込まれると 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 の実装では広告の手動再生は必要ですか？
いいえ。手動の広告再生は、広告ルールや VMAP レスポンスで設定されたとおりに IMA SDK でミッドロール挿入点を自動的に再生することを希望しないパブリッシャー向けのオプション機能です。