IMA SDK 支持预加载视频广告素材资源。 您可以在 SDK 集成中启用此功能,以便在广告和内容之间实现更顺畅的转换。本指南介绍了使用 IMA SDK 实现媒体预加载的技术细节。
启用预加载
如需启用预加载,请将AdsRenderingSettings.enablePreloading
设置为 true。此操作必须通过 ADS_MANAGER_LOADED
事件完成:
function onAdsManagerLoaded(adsManagerLoadedEvent) {
var adsRenderingSettings = new google.ima.AdsRenderingSettings();
adsRenderingSettings.enablePreloading = true;
...
var adsManager = adsManagerLoadedEvent.getAdsManager(
videoContent, adsRenderingSettings);
}
计时
下表总结了启用预加载后广告加载时间的变化:
事件 | 带预加载 | 不预加载 |
---|---|---|
请求的广告 VAST | AdsLoader.requestAds() |
AdsLoader.requestAds() |
前贴片广告已加载(单个广告) | AdsManager.init() |
AdsManager.start() |
前贴片广告加载(VMAP/广告规则) | AdsManager.init() |
AdsManager.init() |
加载了中贴片广告或后贴片广告 | 对于广告插播时段中的第一个广告,应在广告开始播放前 8 秒。 对于连续广告,是在前一广告开始播放时。 | 在广告开始播放时。 |
限制
预加载受限于以下限制:
- 在 iOS 设备上的移动网络上或在联网智能电视上使用 HTML5 IMA SDK 时,无法预加载媒体。
- VPAID 会预加载,但在广告执行之前,系统不会加载广告的任何依赖项(包括该广告播放的媒体)。
- 必须启用自动播放功能,才能预加载 VMAP 广告。确保将
settings.isAutoPlayAdBreaks()
设置为true
(默认值)。 - 后贴片广告会在最后一个中贴片广告之后预加载,如果使用
AdsRequest.contentDuration
设置时长,则会在内容结束前 8 秒预加载。
常见问题解答
- 媒体预加载是否会加载完整广告素材?
- 不可以,广告开始播放时,广告素材通常尚未完全加载。预加载的宗旨是尽可能缩短广告的加载时间,从而改善用户体验。它不支持离线广告投放。 IMA SDK 会尽可能加载浏览器允许的媒体内容,但受用户的互联网连接和广告素材的大小所限。
- 是否需要为广告的 VAST 和媒体启用媒体预加载?
- 否,无论此预加载设置如何,SDK 始终会预加载广告的 VAST。