书签

本指南介绍了如何在为视频点播 (VOD) 视频流使用动态广告插播 (DAI) 时使用 IMA DAI SDK 实现书签。此操作假设 IMA DAI 实现有效，如使用入门中提供的实现。

什么是书签？

书签功能可用于保存内容流中的某个特定点，然后返回该位置。假设用户观看了 5 分钟的内容后离开视频流，然后又返回。书签功能可以保存用户在直播中的位置，让直播能够从上次停下的地方继续观看，为观看者提供顺畅的体验。

深入了解 DAI 书签

为 DAI 视频流添加书签时，您必须记录视频流 ID 和用户离开视频的时间。当用户返回时，重新请求该数据流并跳转到保存的时间。由于所请求视频流的每个实例都有时长不同的广告插播时间点，因此节省视频流时间是不可行的。您真正希望从相同的内容时间继续。

备用的转换方法

IMA DAI SDK 提供了一对方法来请求指定流式传输时间的内容时间和指定内容时间的流式传输时间。使用这些转换方法，您可以存储已添加书签的内容时间，然后在数据流的新实例中找到相应的流式传输时间。下面是此方法，其中包括一个示例应用的链接，该应用展示了有效的书签实现。

正在保存书签

在内容播放器暂停时保存书签。

onPause() {
   var bookmarkTime = Math.floor(
   streamManager.contentTimeForStreamTime(videoElement.currentTime));
}

正在加载书签

重新请求直播时加载书签。

function loadUrl(url) {
  hls.on(Hls.Events.MANIFEST_PARSED, () => {
    var startTime = 0;
    if (bookmarkTime) {
      var startTime = streamManager.streamTimeForContentTime(bookmarkTime);
      // Seeking on load triggers the onSeekEnd event, so treat this seek as
      // if it's snapback. Without this, resuming at a bookmark kicks you
      // back to the ad before the bookmark.
      isSnapback = true;
    }
    hls.startLoad(startTime);
    videoElement.addEventListener('loadedmetadata', () => { videoElement.play(); });
  });
  hls.loadSource(url);
  hls.attachMedia(videoElement);
}

示例应用

下载示例应用，查看书签实现。