返回到跳过的广告插播时间点
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
作为视频发布商,您可能希望阻止观看者
可让您跳过中贴片广告如果用户跳过广告插播时间点,
则可以返回广告插播时间点的开头,然后返回
在广告插播结束后,将用户跳转到其跳转位置。本次
这个功能叫做“snapback”。
有关示例,请参见下图。你的观看者正在观看视频
并决定从 5 分钟标记跳到 15 分钟标记之间。
不过,在视频的 10 分钟处有一个广告插播时间点
让他们先看完视频,然后再观看后面的内容:

要展示此广告插播时间点,请按以下步骤操作:
- 检查用户运行的搜索是否跳过了未观看的广告插播时间点;
如果是,则将他们返回到广告插播时间点。
- 广告插播结束后,将其返回其原始跳转模式。
以图表形式显示的数据如下所示:

以下是使用 IMA DAI SDK 实现跳回的方法,如
高级示例。
防止跳转时不观看广告插播时间点
检查用户运行的搜索是否跳过了未观看的广告插播时间点,
如果是,则将他们返回到广告插播时间点。
在 HTML5 SDK 中,针对内容播放器的 seeked
事件设置事件监听器
可触发 onSeekEnd()
。该方法(如下所示)会检查广告插入点
播放到指定时间之前如果该项未播放,跳转至该部分的开头
而不是初始所需的定位点,然后将这个
snapForwardTime
中的定位点。
function onSeekEnd() {
if (isLiveStream) { return; }
if (isSnapback) {
isSnapback = false;
return;
}
var currentTime = videoElement.currentTime;
var previousCuePoint =
streamManager.previousCuePointForStreamTime(currentTime);
if (previousCuePoint && !previousCuePoint.played) {
isSnapback = true;
snapForwardTime = currentTime;
videoElement.currentTime = previousCuePoint.start;
}
让用户回到其原始跳转
现在,当您收到 AD_BREAK_ENDED
事件时,请检查 snapForwardTime
。如果是这样,请将用户转到视频流中的相应位置,因为广告
是因为“快拍”产生的结果:
function onAdBreakEnded(e) {
videoElement.controls = true;
clickElement.style.display = 'none';
adUiDiv.style.display = 'none';
if (snapForwardTime && snapForwardTime > videoElement.currentTime) {
videoElement.currentTime = snapForwardTime;
snapForwardTime = null;
}
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003eSnapback prevents viewers from skipping mid-roll ads by returning them to the start of the ad break if they seek past it.\u003c/p\u003e\n"],["\u003cp\u003eWhen a viewer seeks past an unwatched ad, snapback takes them back to the ad and then returns them to their intended location after the ad completes.\u003c/p\u003e\n"],["\u003cp\u003eImplementing snapback involves checking for seeks past unwatched ad breaks and redirecting the viewer accordingly using the IMA DAI SDK.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the \u003ccode\u003eseeked\u003c/code\u003e event and \u003ccode\u003epreviousCuePointForStreamTime\u003c/code\u003e function to detect and manage snapback scenarios within their video players.\u003c/p\u003e\n"],["\u003cp\u003eAfter an ad break initiated by snapback, the \u003ccode\u003eAD_BREAK_ENDED\u003c/code\u003e event and \u003ccode\u003esnapForwardTime\u003c/code\u003e variable are used to return the viewer to their original seek position.\u003c/p\u003e\n"]]],[],null,["# Return to a skipped ad break\n\nAs a video publisher, you may want to prevent your viewers from\nseeking past your mid-roll ads. When a user seeks past an ad break,\nyou can take them back to the start of that ad break, and then return\nthem to their seek location after that ad break has completed. This\nfeature is called \"snapback.\"\n\nAs an example, see the diagram below. Your viewer is watching a video,\nand decides to seek from the 5-minute mark to the 15-minute mark.\nThere is, however, an ad break at the 10-minute mark that you want\nthem to watch before they can watch the content after it:\n\nIn order to show this ad break, take the following steps:\n\n1. Check if the user ran a seek that jumped past an unwatched ad break, and if so, take them back to the ad break.\n2. After the ad break completes, return them to their original seek.\n\nIn diagram form, that looks like this:\n\nHere's how to implement snapback using the IMA DAI SDK, as demonstrated in\n[Advanced Example](https://github.com/googleads/googleads-ima-html5-dai/tree/master/hls_js/advanced).\n\nPrevent a seek from leaving an ad break unwatched\n-------------------------------------------------\n\nCheck if the user has run a seek that went past an unwatched ad break,\nand if so, take them back to the ad break.\nIn the HTML5 SDK, set an event listener on the content player's `seeked` event\nto trigger `onSeekEnd()`. That method (presented below) checks the cue point\nprior to the user's seek time. If it is unplayed, seek to the beginning of that\nad break instead of their initial desired seek point, and save that desired\nseek point in `snapForwardTime`. \n\n function onSeekEnd() {\n if (isLiveStream) { return; }\n if (isSnapback) {\n isSnapback = false;\n return;\n }\n var currentTime = videoElement.currentTime;\n var previousCuePoint =\n streamManager.previousCuePointForStreamTime(currentTime);\n if (previousCuePoint && !previousCuePoint.played) {\n isSnapback = true;\n snapForwardTime = currentTime;\n videoElement.currentTime = previousCuePoint.start;\n }\n\nPut the user back to their original seek\n----------------------------------------\n\nNow when you get an `AD_BREAK_ENDED` event, check to see if `snapForwardTime`\nis set. If so, take the user to that point in the stream, because the ad\nbreak they just watched was the result of snapback: \n\n function onAdBreakEnded(e) {\n videoElement.controls = true;\n clickElement.style.display = 'none';\n adUiDiv.style.display = 'none';\n if (snapForwardTime && snapForwardTime \u003e videoElement.currentTime) {\n videoElement.currentTime = snapForwardTime;\n snapForwardTime = null;\n }\n }"]]