動画配信者の場合は、視聴者がミッドロール広告を見落とさないようにしたい場合があります。ユーザーがミッドロール挿入点を越えてシークした場合、ユーザーをそのミッドロール挿入点の先頭に戻し、そのミッドロール挿入点の完了後にシーク位置に戻ることができます。この機能は「スナップバック」と呼ばれます。
例として、以下の図をご覧ください。視聴者が動画を視聴していて、5 分の時点から 15 分の時点までシークすることにしました。ただし、10 分の時点で広告ブレークを設定して、その後に視聴者が動画を視聴できるようにします。
このミッドロール挿入点を表示する方法は次のとおりです。
- ユーザーがシークを実行したのが再生されていないミッドロール挿入点を越えたかどうかを確認します。動作している場合は、再生前のミッドロール挿入点に戻ります。
- ミッドロール挿入点が完了したら、元の位置に戻します。
図で表すと次のようになります。
このワークフローを 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;
}