スナップバック

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

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

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

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

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

AdvancedExample で説明しているように、このワークフローを tvOS IMA SDK で実装する方法

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

ユーザーがシークを実行していて、再生していない広告ブレークを超えたかどうかを確認し、実行されていた場合は、ユーザーを広告ブレークに戻します。tvOS の高度な例では、ユーザーがシークを実行したことを通知するデリゲート メソッドがある AVPlayerViewController を活用しています。シーク開始時間が前のミッドロール挿入点よりも前（つまり、ユーザーが広告ブレークを超えてスキップした）で、そのブレークがまだ再生されていない場合は、ミッドロール挿入点の最初に戻ります。また、最初にリクエストしたシークの開始時刻を後で確認するために ad-break-did-end ハンドラに記録します。

- (void)playerViewController:(AVPlayerViewController *)playerViewController
  willResumePlaybackAfterUserNavigatedFromTime:(CMTime)oldTime
                      toTime:(CMTime)targetTime {
  if (self.streamManager) {
    IMACuepoint *prevCuepoint = [self.streamManager
        previousCuepointForStreamTime:CMTimeGetSeconds(targetTime)];
    if (prevCuepoint && !prevCuepoint.isPlayed && oldTime < prevCuepoint.startTime) {
      self.userSeekTime = CMTimeGetSeconds(targetTime);
      [self.playerViewController.player seekToTime:CMTimeMakeWithSeconds(
                 prevCuepoint.startTime, NSEC_PER_SEC)
                 toleranceBefore:kCMTimeZero
                  toleranceAfter:kCMTimeZero];
    }
  }
}

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

イベント デリゲートで AD_BREAK_ENDED のケースを変更して、前の広告ブレークがスナップバックの結果として再生されたかどうかを確認します。

- (void)streamManager:(IMAStreamManager *)streamManager didReceiveAdEvent:(IMAAdEvent *)event {
  NSLog(@"StreamManager event (%@).", event.typeString);
  switch (event.type) {
    // Your other events go here as normal.
    case kIMAAdEvent_AD_BREAK_ENDED: {
      if (self.userSeekTime > 0) {
        self.playerViewController.player
            seekToTime:CMTimeMakeWithSeconds(self.userSeekTime, NSEC_PER_SEC)
        toleranceBefore:kCMTimeZero
        toleranceAfter:kCMTimeZero];
        self.userSeekTime = 0;

      // existing handling for AD_BREAK_ENDED goes here.
      break;
    }
    // And so on for other events.
    default:
      break;
  }
}