為直播載入片頭廣告
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
IMA SDK 可用來透過直播和隨選影片營利。
如果是直播,您必須針對每個廣告插播發出新的廣告請求。
分散這些要求,確保所有觀眾都沒有提出要求
同時關閉廣告伺服器。
為解決這個問題,IMA SDK 採用 AdsRequest.liveStreamPrefetchSeconds
資源。這個屬性會指定 SDK 的秒數上限
請於呼叫後與廣告伺服器連線
AdsLoader.requestAds()
。實際要求時間會隨機增加。適用對象
舉例來說,如果將 AdsRequest.liveStreamPrefetchSeconds
設為 30,SDK
您呼叫 AdsLoader.requestAds()
後會等待 0 到 30 秒
向伺服器發出要求
直播預先擷取
建議您在廣告時段完成後,立即預先擷取下一個廣告插播。
這麼做可確保預先擷取視窗能夠使用的時間長度上限。
假設您有 5 分鐘的廣告插播時間。廣告時段播放完畢後
可以利用 290 秒的預先擷取視窗來請求下一個廣告插播
(5 分鐘減 10 秒,以確保在最後傳送要求)
預先擷取視窗有足夠的時間可以解析):
下列程式碼片段顯示如何將直播預先擷取功能新增至
進階範例
,但這個方法也適用於其他 IMA 導入。
VideoPlayerController.java
/** Ads logic for handling the IMA SDK integration code and events. */
public class VideoPlayerController {
// 5 minutes == 300 seconds. Include a 10 second buffer
private float AD_INTERVAL = 290;
private double AD_TIMEOUT = 300;
...
adsManager.addAdEventListener(
new AdEvent.AdEventListener() {
/** Responds to AdEvents. */
@Override
public void onAdEvent(AdEvent adEvent) {
...
case ALL_ADS_COMPLETED:
if (adsManager != null) {
adsManager.destroy();
adsManager = null;
}
// When pre-fetching for live streams, be sure to destroy the current AdsManager,
// in case the tag you requested previously contains post-rolls
// (you don't want to play those now).
// Pre-fetch the next ad break.
// Play those ads in ~5 minutes. In a real-world implementation,
// this will likely be done as the result of a message from your
// streaming server, not a via the playAdsAfterThisTime parameter
// of requestAndPlayAds().
requestAndPlayAds(AD_TIMEOUT);
break;
default:
break;
}
}
...
public void requestAndPlayAds(double playAdsAfterThisTime) {
if (currentAdTagUrl == null || currentAdTagUrl == "") {
log("No VAST ad tag URL specified");
resumeContent();
return;
}
// Since you're switching to a new video, tell the SDK the previous video is finished.
if (adsManager != null) {
adsManager.destroy();
}
playButton.setVisibility(View.GONE);
// Create the ads request.
AdsRequest request = sdkFactory.createAdsRequest();
request.setAdTagUrl(currentAdTagUrl);
request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());
request.setLiveStreamPrefetchSeconds(AD_INTERVAL);
playAdsAfterTime = playAdsAfterThisTime;
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
adsLoader.requestAds(request);
}
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-01 (世界標準時間)。
[null,null,["上次更新時間:2025-08-01 (世界標準時間)。"],[[["\u003cp\u003eThe IMA SDK supports monetizing live streams and video-on-demand content through ad integration.\u003c/p\u003e\n"],["\u003cp\u003eFor live streams, stagger ad requests to avoid overloading ad servers by utilizing the \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e property for pre-fetching.\u003c/p\u003e\n"],["\u003cp\u003eIt's recommended to pre-fetch the next ad break immediately after the current one finishes, maximizing the pre-fetch window for smoother ad transitions.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code snippets demonstrate how to implement live stream pre-fetching within the Advanced Example, showcasing the integration with the IMA SDK.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e property randomizes the actual request time within the specified maximum duration to further optimize ad delivery.\u003c/p\u003e\n"]]],[],null,["# Load pre-roll ads for livestream\n\nThe IMA SDK can be used to monetize live streams as well as video-on-demand.\nFor live streams, you need to make a new ad request for each ad break.\nStagger these requests to ensure that all of your viewers aren't requesting\nads at the same time and bogging down the ad server(s).\n\nTo help with this, the IMA SDK has the `AdsRequest.liveStreamPrefetchSeconds`\nproperty. This property specifies the maximum number of seconds the SDK\nshould wait before reaching out to the ad server after you call\n`AdsLoader.requestAds()`. The actual request time will be randomized. For\nexample, if you set `AdsRequest.liveStreamPrefetchSeconds` to 30, the SDK\nwaits 0 to 30 seconds after you call `AdsLoader.requestAds()` to actually\nmake the request to the server.\n\nLive stream pre-fetch in practice\n---------------------------------\n\nWe recommend pre-fetching your next ad break as soon as an ad break completes.\nThis ensures the maximum length of time is available for your pre-fetch window.\nSuppose you have 5 minutes between ad breaks. When an ad break completes,\nyou can request your next ad break with a pre-fetch window of 290 seconds\n(5 minutes minus 10 seconds, to make sure the requests sent at the end of\nthe pre-fetch window have enough time to resolve):\n| **Key Point:** The [Getting started guide](/interactive-media-ads/docs/sdks/android/client-side) and the [Basic Example](//github.com/googleads/googleads-ima-android/tree/main/basicexample) both implement the [Exoplayer-IMA extension](//github.com/google/ExoPlayer/tree/release-v2/extensions/ima) which handles the setup of the AdsManager. Because of this, these resources are not able to be used as a starting point for this guide. We recommend using the [Advanced Example](//github.com/googleads/googleads-ima-android/tree/main/AdvancedExample) as a starting point for live stream pre-fetch.\n\nThese code snippets show how to add live stream pre-fetch to the\n[Advanced Example](//github.com/googleads/googleads-ima-android/tree/main/AdvancedExample)\n, but the approach can applied to other IMA implementations.\n\n**VideoPlayerController.java** \n\n```gdscript\n/** Ads logic for handling the IMA SDK integration code and events. */\npublic class VideoPlayerController {\n\n // 5 minutes == 300 seconds. Include a 10 second buffer\n private float AD_INTERVAL = 290;\n private double AD_TIMEOUT = 300;\n\n...\n\n adsManager.addAdEventListener(\n new AdEvent.AdEventListener() {\n /** Responds to AdEvents. */\n @Override\n public void onAdEvent(AdEvent adEvent) {\n\n ...\n\n case ALL_ADS_COMPLETED:\n if (adsManager != null) {\n adsManager.destroy();\n adsManager = null;\n }\n\n // When pre-fetching for live streams, be sure to destroy the current AdsManager,\n // in case the tag you requested previously contains post-rolls\n // (you don't want to play those now).\n\n // Pre-fetch the next ad break.\n // Play those ads in ~5 minutes. In a real-world implementation,\n // this will likely be done as the result of a message from your\n // streaming server, not a via the playAdsAfterThisTime parameter\n // of requestAndPlayAds().\n requestAndPlayAds(AD_TIMEOUT);\n break;\n default:\n break;\n }\n }\n\n...\n\npublic void requestAndPlayAds(double playAdsAfterThisTime) {\n if (currentAdTagUrl == null || currentAdTagUrl == \"\") {\n log(\"No VAST ad tag URL specified\");\n resumeContent();\n return;\n }\n\n // Since you're switching to a new video, tell the SDK the previous video is finished.\n if (adsManager != null) {\n adsManager.destroy();\n }\n\n playButton.setVisibility(View.GONE);\n\n // Create the ads request.\n AdsRequest request = sdkFactory.createAdsRequest();\n request.setAdTagUrl(currentAdTagUrl);\n request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());\n request.setLiveStreamPrefetchSeconds(AD_INTERVAL);\n\n playAdsAfterTime = playAdsAfterThisTime;\n\n // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.\n adsLoader.requestAds(request);\n}\n```"]]