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

このガイドでは、デフォルトのミッドロール挿入点のスケジュールをオーバーライドし、独自のミッドロール挿入点の再生タイミングを設定するための手順について説明します。手動の広告ブレーク再生が実装されている場合、広告ブレークが読み込まれると SDK は AD_BREAK_READY イベントを発生させ、ブレークの再生が開始されるまで待機します。

前提条件

• IMA SDK が実装された Android アプリ。

手動広告ブレークの再生を設定

ミッドロール挿入点の手動再生を設定するには:

1. 広告ブレークの再生を制御することを SDK に伝えます。
2. AD_BREAK_READY イベントをリッスンします。
3. 準備ができたら、SDK に広告を再生するよう指示します。

次のスニペットは、手動ミッドロール挿入点の再生を実装するために 上級者向けの例に加える必要がある変更を示しています。

キーポイント: 基本的な例では、ImaSdkSettings と AdEvents のセットアップを処理する Exoplayer-IMA 拡張機能が実装されています。そのため、このガイドの出発点として基本的な例を使用することはできません。

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 でミッドロール挿入点が自動的に再生されないようにしたいパブリッシャー向けのオプション機能です。