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

请选择平台： HTML5 Android iOS tvOS Roku

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

例如，请参见下图。观看者正在观看视频，并决定从 5 分钟标记处快进到 15 分钟标记处。 不过，您希望观看者在观看 10 分钟后的内容之前先观看 10 分钟处的广告插播时间点：

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

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

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

以下示例展示了如何在 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;
}