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 |
string | (選用) 遊戲目前正在播放音效。值: - on (預設) - off 此呼叫會指定遊戲能否發出音效,以及系統在呼叫 adBreak() 之前是否已啟用音效 (也就是取消靜音)。這有助於 Ad Placement API 選擇最適合您遊戲的廣告類型。請在遊戲的音效狀態變更時,立即呼叫此函式,因為 Ad Placement API 可能必須要求新的廣告素材,且時間上限可以設為啟用。 預設值為音效。因此,大多數遊戲在開始宣告時已啟用音效,必須呼叫 adConfig() 。 |
preloadAdBreaks |
string | (選用) 一律在首次呼叫 adBreak() 之前預先載入廣告。值:- on - auto (預設)預設值 auto 會決定 Ad Placement API 的決定。preloadAdBreaks 只能透過 adConfig() 設定一次,而其他傳遞至 preloadAdBreaks 的值則無效。在首次呼叫 adBreak() 之後設定 preloadAdBreaks 不會有任何作用。 |
onReady |
string | (選用) 當 API 初始化且預先載入完成 (如果使用上述 preloadAdBreaks 要求預先載入) 時呼叫。 |