本指南介绍了在为视频点播 (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);
}
示例应用
下载示例应用,查看书签实现。