スキップしたミッドロール挿入点に戻る

プラットフォームを選択: HTML5 Android iOS tvOS Roku

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

たとえば、下の図をご覧ください。視聴者が動画を視聴していて、5 分のマークから 15 分のマークまでシークすることにした場合。ただし、10 分のマークにミッドロール挿入点があり、その後にコンテンツを視聴するには、そのミッドロール挿入点を視聴する必要があります。

このミッドロール挿入点を表示するには、次の手順を行います。

  1. ユーザーが未視聴のミッドロール挿入点をスキップするシークを実行したかどうかを確認し、実行した場合はミッドロール挿入点に戻します。
  2. ミッドロール挿入点が完了したら、元のシーク位置に戻します。

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

AdvancedExample で示されているように、IMA DAI 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;
  }
}