スナップバック

動画配信者の場合は、視聴者がミッドロール広告を見落とさないようにしたい場合があります。ユーザーがミッドロール挿入点を越えてシークした場合、ユーザーをそのミッドロール挿入点の先頭に戻し、そのミッドロール挿入点の完了後にシーク位置に戻ることができます。この機能は「スナップバック」と呼ばれます。

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

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

1. ユーザーがシークを実行したのが再生されていないミッドロール挿入点を越えたかどうかを確認します。動作している場合は、再生前のミッドロール挿入点に戻ります。
2. ミッドロール挿入点が完了したら、元の位置に戻します。

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

このワークフローを IMA DAI SDK で実装する方法は次のとおりです（AdvancedExample を参照）。

シークによりミッドロール挿入点が未再生のままになるのを防ぐ

ユーザーがシークで再生していないミッドロール挿入点を超えたかどうかを確認し、再生されている場合はそのミッドロール挿入点に戻ります。 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;
}