adConfig() 呼叫會將遊戲的目前設定傳達給 Ad Placement API。Ad Placement API 可藉此調整預先載入廣告的方式,並篩選所要求的廣告類型,確保廣告適合放送 (例如需要音效的影片廣告)。
函式簽章:
adConfig({
preloadAdBreaks: 'on|auto', // Ad preloading strategy
sound: 'on|off' // This game has sound
onReady: () => {}, // Called when API has initialised and adBreak() is ready
});
adConfig 參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sound |
字串 | (選用) 遊戲目前是否正在播放音效。值: - on (預設) - off 這項呼叫會指定遊戲是否支援音效,以及在呼叫 adBreak() 前是否已啟用音效 (即取消靜音)。這有助於 Ad Placement API 為遊戲選取合適的廣告類型。遊戲的音效狀態變更時,請立即呼叫這個函式,因為 Ad Placement API 可能必須要求新的廣告素材,這樣才能有充足的時間完成這項作業。 預設值為開啟音效。因此,大多數遊戲在開始宣告已啟用音效時,都需要呼叫 adConfig()。 |
preloadAdBreaks |
字串 | (選用) 廣告是否應一律在首次呼叫 adBreak() 前預先載入。值:- on- auto (預設)預設值 auto 會將決策權交給 Ad Placement API。preloadAdBreaks 只能透過 adConfig() 設定一次,之後傳遞至 preloadAdBreaks 的值不會生效。在首次呼叫 adBreak() 後設定 preloadAdBreaks 不會生效。 |
onReady |
字串 | (選用):API 初始化並完成預先載入廣告後 (如果您使用上述 preloadAdBreaks 要求預先載入),系統就會呼叫這個方法。 |