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 字符串 (可选)游戏目前是否在播放声音。值:
- on
- off(默认)
此调用会指定您的游戏是否可以播放声音,以及声音是否可在调用 adBreak() 之前启用(即已取消静音)。这有助于 Ad Placement API 为您的游戏选择合适的广告类型。
在游戏的声音状态发生变化后立即调用此函数,因为 Ad Placement API 可能需要请求新的广告素材,此操作将为您留出尽可能多的时间。

默认值为静音。因此,大多数游戏需要在开始声明已启用声音时调用 adConfig()
preloadAdBreaks 字符串 (可选)是否应始终在首次调用 adBreak() 之前预加载广告。值:
- on
- auto(默认)

auto 的默认值由 Ad Placement API 决定。只能使用 adConfig() 设置 preloadAdBreaks 一次,之后传递到 preloadAdBreaks 的值没有任何作用。
在首次调用 adBreak() 后设置 preloadAdBreaks 不会产生任何影响。
onReady 字符串 (可选)在 API 完成初始化并预加载广告后调用(如果您使用上面的 preloadAdBreaks 请求预加载)。