返回到跳过的广告插播时间点

选择平台： HTML5 Android iOS tvOS Roku

作为视频发布商，您可能不希望观看者跳过中贴片广告。当用户跳过广告插播时间点时，您可以将他们带回至该广告插播时间点的起始处，并在该广告插播时间点结束后将他们返回至其跳转时的位置。此功能称为“跳回”。

如需查看示例，请参阅下图。您的观看者正在观看视频，并决定从 5 分钟标记处跳转到 15 分钟标记处。 不过，在 10 分钟标记处有一个广告插播时间点，您希望他们先观看该广告插播时间点，然后再观看其后的内容：

如需展示此广告插播时间点，请按以下步骤操作：

  1. 检查用户是否执行了跳转，跳过了未观看的广告插播时间点，如果是，则将他们带回至该广告插播时间点。
  2. 广告插播时间点结束后，将他们返回至其原始跳转位置。

以图表形式表示，如下所示：

下面介绍了如何在 IMA DAI SDK 中实现此工作流，如 AdvancedExample中所示。

禁止跳过未观看的广告

如果用户尝试跳过广告插播时间点，播放器必须检测到跳转，并强制播放到该特定广告插播时间点的起始处。如需禁止跳过未观看的广告，请执行以下操作：

  1. 当用户开始与进度条互动时，记录其当前播放时间。
  2. 在用户完成跳转到视频流中的其他时间后，确定此时间之前最近的广告插播时间点。
  3. 如果广告插播时间点在记录的开始时间之后开始，表示发生了跳过，并且尚未播放，则将播放器跳转到广告插播时间点的开头。
  4. 启用 snapbackMode 标志，以跟踪此广告插播时间点是否被强制播放。

Objective-C

- (IBAction)videoControlsTouchStarted:(id)sender {
  [NSObject cancelPreviousPerformRequestsWithTarget:self
                                            selector:@selector(hideFullscreenControls)
                                              object:self];

  self.currentlySeeking = YES;
  self.seekStartTime = self.contentPlayer.currentTime;
}

- (IBAction)videoControlsTouchEnded:(id)sender {
  if (self.fullscreen) {
    [self startHideControlsTimer];
  }
  self.currentlySeeking = NO;
  if (!self.adPlaying) {
    self.seekEndTime = CMTimeMake(self.progressBar.value, 1);
    IMACuepoint *lastCuepoint =
        [self.streamManager previousCuepointForStreamTime:CMTimeGetSeconds(self.seekEndTime)];
    if (!lastCuepoint.played && (lastCuepoint.startTime > CMTimeGetSeconds(self.seekStartTime))) {
      self.snapbackMode = YES;
      // Add 1 to the seek time to get the keyframe at the start of the ad to be our landing
      // place.
      [self.contentPlayer
          seekToTime:CMTimeMakeWithSeconds(lastCuepoint.startTime + 1, NSEC_PER_SEC)];
    }
  }
}
VideoViewController.m

Swift

@IBAction func progressBarTouchStarted(_ sender: UISlider) {
  guard !isAdPlaying else { return }
  currentlySeeking = true
  seekStartTime = contentPlayer.currentTime().seconds
}

// MARK: Snapback Logic
@IBAction func progressBarTouchEnded(_ sender: UISlider) {
  guard !isAdPlaying else { return }
  if isFullScreen {
    startHideControlsTimer()
  }
  currentlySeeking = false
  seekEndTime = Float64(sender.value)

  guard let streamManager else { return }

  if let lastCuepoint = streamManager.previousCuepoint(forStreamTime: seekEndTime) {
    if !lastCuepoint.isPlayed, lastCuepoint.startTime > seekStartTime {
      logMessage(
        "Snapback to \(String(format: "%.2f", lastCuepoint.startTime)) from \(String(format: "%.2f", seekEndTime))"
      )
      snapbackMode = true
      contentPlayer.seek(
        to: CMTime(seconds: Double(sender.value), preferredTimescale: 1000))
    }
  }
}
VideoViewController.swift

恢复原始跳转

强制播放的广告插播时间点结束后，播放器会将用户带到预期的内容点。

如需恢复用户的原始跳转，请执行以下操作：

  1. 在视频流管理器中监听 AD_BREAK_ENDED 事件。

  2. 检查 snapbackMode 标志是否处于活动状态，以确保此跳转发生在强制观看广告之后。

  3. 如果处于活动状态，则将播放器跳转到保存的目标时间，以将用户返回到预期的时间戳。

以下示例监听已结束的广告插播时间点，并将用户返回到原始跳转位置：

Objective-C

case kIMAAdEvent_AD_BREAK_ENDED: {
  [self logMessage:@"Ad break ended"];
  self.adPlaying = NO;
  if (self.snapbackMode) {
    self.snapbackMode = NO;
    if (CMTimeCompare(self.seekEndTime, self.contentPlayer.currentTime)) {
      [self.contentPlayer seekToTime:self.seekEndTime];
    }
  }
  break;
}
VideoViewController.m

Swift

case .AD_BREAK_ENDED:
  logMessage("Ad break ended")
  isAdPlaying = false
  progressBar.isUserInteractionEnabled = true
  if snapbackMode {
    snapbackMode = false
    if contentPlayer.currentTime().seconds < seekEndTime {
      contentPlayer.seek(to: CMTime(seconds: Double(seekEndTime), preferredTimescale: 1000))
    }
  } else if pendingBookmarkSeek, let time = bookmarkStreamTime {
    logMessage(String(format: "AD_BREAK_ENDED: Seeking to bookmark streamTime: %.2f", time))
    imaVideoDisplay.seekStream(toTime: time)
    pendingBookmarkSeek = false
    bookmarkStreamTime = nil
  }
  updatePlayHeadState(isPlaying: self.isContentPlaying)
VideoViewController.swift