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 请求预加载)。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-07-26。"],[],["The `adConfig()` function communicates the game's settings to the Ad Placement API. It accepts parameters to configure ad behavior: `sound` (specifying if sound is 'on' or 'off'), `preloadAdBreaks` ('on' or 'auto' for preloading ads), and `onReady` (a callback after initialization). `sound` informs the API of the game's sound capability and status, influencing ad selection. `preloadAdBreaks` dictates ad preloading strategy, set only once.\n"]]