IMA SDK 可用于通过直播和视频点播创收。 对于直播,您需要为每个广告插播时间点发送新的广告请求。 错开这些请求,确保不会有观看者在请求 导致广告服务器出现卡顿。
为帮助解决这个问题,IMA SDK 提供了 AdsRequest.liveStreamPrefetchSeconds
属性。此属性用于指定 SDK 的秒数上限
在您调用
AdsLoader.requestAds()
。实际请求时间将随机分配。对于
例如,如果您将 AdsRequest.liveStreamPrefetchSeconds
设置为 30,则 SDK
在您调用 AdsLoader.requestAds()
后,系统将等待 0 到 30 秒,
向服务器发出请求。
直播预提取功能的实际运用
我们建议您在广告插播结束后立即预提取下一个广告插播时间点。 这样可以确保预提取期限的最长时间。 假设广告插播时间点有 5 分钟。广告插播结束后 您可以请求下一个广告插播时间点,预提取时间范围为 290 秒 (5 分钟减去 10 秒,以确保在末尾 预提取窗口有足够的时间解决):
// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;
function onAdEvent(adEvent) {
var ad = adEvent.getAd();
switch(adEvent.type) {
case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
// Pre-fetch our next ad break.
requestAds();
// Play those ads in 5 minutes. In a real-world implementation,
// this is likely done as the result of a message from your
// streaming server, not a timeout.
setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
}
}
function requestAds() {
// Destroy the current AdsManager, in case the tag you requested previously
// contains post-rolls (don't play those now).
if (adsManager) {
adsManager.destroy();
}
// Your AdsLoader will be set up on page-load. You should re-use the same
// AdsLoader for every request. For more info on setting up the AdsLoader,
// see the "Get Started" guide in the prerequisites above.
if (adsLoader) {
// Reset the IMA SDK.
adsLoader.contentComplete();
}
var adsRequest = new google.ima.AdsRequest();
adsRequest.adTagUrl = '...';
adsRequest.linearAdSlotWidth = <linear_width>;
adsRequest.linearAdSlotHeight = <linear_height>;
adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
adsLoader.requestAds(adsRequest);
}
function playAds() {
adsManager.init(
<linear_width>, <linear_height>, google.ima.ViewMode.NORMAL);
adsManager.start();
}