adConfig

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 要求預先載入) 時呼叫。