スナップバック

動画パブリッシャーの場合は、視聴者がミッドロール広告をスキップしないようにするため、ユーザーが広告ブレークを過ぎてシークした場合、ユーザーをそのミッドロール挿入点の先頭に戻し、そのミッドロール挿入点の完了後にシーク位置に戻ることができます。この機能は「スナップバック」と呼ばれます。

例として、以下の図をご覧ください。動画の視聴中に 5 分の時点から 15 分の時点までシークすることにしました。ただし、10 分の時点で、視聴者がコンテンツを見る前に視聴するよう広告ブレークを設定できます。

このミッドロール挿入点を表示する方法は次のとおりです。

1. ユーザーがシークを再生し、再生されなかった広告ブレークを超えて飛んでいたかどうかを確認し、その場合は、広告ブレークに戻ります。
2. ミッドロール挿入点が完了したら、元のシークに戻します。

図で表すと次のようになります。

AdvancedExample で説明したように、このワークフローを Android IMA SDK で実装する方法を以下に示します。

シークにより広告ブレークが未視聴のままにならないようにする

ユーザーがシークを実行していて、再生していない広告ブレークを超えたかどうかを確認し、実行されていた場合は、ユーザーを広告ブレークに戻します。Android SDK では、PlayerControl オブジェクトを使用してシークを検出します。ユーザーがシークしたら、SampleAdsWrapper で実装された SampleHlsVideoPlayerCallback の onSeek() メソッドをトリガーします。このメソッド（下記で参照）は、ユーザーのシーク時間前のキューポイントを確認します。再生されていない場合、最初の目的のシーク ポイントではなく、その広告ブレークの最初にシークして、そのシークポイントを snapBackTime に保存します。

@Override
public void onSeek(int timeMillis) {
  double timeToSeek = timeMillis;
  if (streamManager != null) {
    CuePoint cuePoint =
        streamManager.getPreviousCuePointForStreamTime(timeMillis / 1000);
    if (cuePoint != null && !cuePoint.isPlayed()) {
      snapBackTime = timeToSeek / 1000.0; // Update snapback time.
      // Missed cue point, so snap back to the beginning of cue point.
      timeToSeek = cuePoint.getStartTime() * 1000;
      videoPlayer.seek(Math.round(timeToSeek));
      videoPlayer.setCanSeek(false);
      return;
    }
  }
  videoPlayer.seek(Math.round(timeToSeek));
}

ユーザーを元のシークに戻します。

onAdBreakEnded イベントを受け取ったら、snapBackTime が設定されているかどうかを確認します。ユーザーが視聴した広告ブレークはスナップバックの結果であるため、ユーザーをストリーム内のその時点まで誘導します。

@Override
public void onAdBreakEnded() {
  // Re-enable player controls.
  videoPlayer.setCanSeek(true);
  videoPlayer.enableControls(true);
  if (snapBackTime > 0) {
    videoPlayer.seek(Math.round(snapBackTime * 1000));
  }
  snapBackTime = 0;
}