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 请求预加载)。 |