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

请选择平台： HTML5 Android iOS tvOS Roku

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

例如，请参见下图。观看者正在观看视频，并决定从 5 分钟标记处快进到 15 分钟标记处。 不过，您希望观看者在观看 10 分钟后的内容之前先观看 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