可能会出现的控制台错误
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
输出到控制台的所有消息都有前缀 [Ad Placement API]：
您只能设置 preloadAdBreaks 一次：
- 已调用
adConfig() 以设置值为 <VALUE> 的 preloadAdBreaks
已尝试调用 adBreak()，但系统仍在处理针对 adBreak() 的另一项调用（确保您没有通过其他工作器触发广告，并且没有在回调函数中调用 adBreak()）：
Cannot show ad while another ad is already visible.
执行您提供的任意回调时失败：
<CALLBACK NAME> callback threw an error: <ERROR>
代码参数存在错误：
Invalid data-ad-frequency-hint value: '<VALUE>'. It must be in format 'Xs'
where X is a number.Unsupported data-adbreak-test value '<VALUE>'. Supported values: 'on'.
adConfig() 参数验证错误：
Invalid ad config: <ERROR>.。其中 <ERROR> 可以是：
preloadAdBreaks must be one of ['auto', 'on']sound must be one of ['on', 'off']onReady 必须是函数
adBreak() 参数验证错误：
Invalid placement config: <ERROR>。其中 <ERROR> 可以是：
missing required properties <LIST OF PROPERTIES><CALLBACK NAME> must be a function<PROPERTY NAME> must be one of <LIST OF VALID VALUES>the following properties are not used for the given ad type:
<LIST OF PROPERTIES>
adBreak() 中重命名的回调（beforeBreak、afterBreak 和 adComplete）已分别重命名为 beforeAd、afterAd 和 adViewed。重命名后的运作方式没有变化）：
Placement config: <OLD> has been renamed to <NEW>. Please update your code.Invalid placement config: <OLD> has been renamed to <NEW>. Cannot pass both
fields. Please use <NEW> only.
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eThe Ad Placement API uses the prefix \u003ccode\u003e[Ad Placement API]\u003c/code\u003e for all console messages and allows preloading ad breaks only once using \u003ccode\u003eadConfig()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should avoid calling \u003ccode\u003eadBreak()\u003c/code\u003e while another ad is displaying and ensure proper tagging parameters like \u003ccode\u003edata-ad-frequency-hint\u003c/code\u003e and \u003ccode\u003edata-adbreak-test\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eadConfig()\u003c/code\u003e and \u003ccode\u003eadBreak()\u003c/code\u003e require specific arguments, including callbacks, and will generate errors if invalid values are provided.\u003c/p\u003e\n"],["\u003cp\u003eCallbacks in \u003ccode\u003eadBreak()\u003c/code\u003e have been renamed (\u003ccode\u003ebeforeBreak\u003c/code\u003e to \u003ccode\u003ebeforeAd\u003c/code\u003e, \u003ccode\u003eafterBreak\u003c/code\u003e to \u003ccode\u003eafterAd\u003c/code\u003e, and \u003ccode\u003eadComplete\u003c/code\u003e to \u003ccode\u003eadViewed\u003c/code\u003e) and using the old names will result in errors.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides detailed error messages for troubleshooting, including specific reasons for failures and invalid configurations.\u003c/p\u003e\n"]]],[],null,["# Possible console errors\n\nAll messages printed to the console will have the prefix `[Ad Placement API]`:\n\nYou can only set preloadAdBreaks once:\n\n- `adConfig()` was already called to set `preloadAdBreaks` with value `\u003cVALUE\u003e`\n\nTried to call `adBreak()` while another call to `adBreak()` was still in process\n(ensure that you are not triggering ads from other workers, and that you are not\ncalling `adBreak()` from within a callback function):\n\n- `Cannot show ad while another ad is already visible.`\n\nFailures when executing any callback you have provided:\n\n- `\u003cCALLBACK NAME\u003e callback threw an error: \u003cERROR\u003e`\n\nErrors in tagging parameters:\n\n- `Invalid data-ad-frequency-hint value: '\u003cVALUE\u003e'. It must be in format 'Xs'\n where X is a number.`\n- `Unsupported data-adbreak-test value '\u003cVALUE\u003e'. Supported values: 'on'.`\n\n`adConfig()` argument validation errors:\n\n- `Invalid ad config: \u003cERROR\u003e.` Where `\u003cERROR\u003e` can be:\n - `preloadAdBreaks must be one of ['auto', 'on']`\n - `sound must be one of ['on', 'off']`\n - `onReady` must be a function\n\n`adBreak()` argument validation errors:\n\n- `Invalid placement config: \u003cERROR\u003e`. Where `\u003cERROR\u003e` can be:\n - `missing required properties \u003cLIST OF PROPERTIES\u003e`\n - `\u003cCALLBACK NAME\u003e must be a function`\n - `\u003cPROPERTY NAME\u003e must be one of \u003cLIST OF VALID VALUES\u003e`\n - `the following properties are not used for the given ad type:\n \u003cLIST OF PROPERTIES\u003e`\n\nRenamed callbacks in `adBreak()` (`beforeBreak`, `afterBreak`, and `adComplete`\nhave been renamed to `beforeAd`, `afterAd` and `adViewed` respectively. They\nstill function in exactly the same way):\n\n- `Placement config: \u003cOLD\u003e has been renamed to \u003cNEW\u003e. Please update your code.`\n- `Invalid placement config: \u003cOLD\u003e has been renamed to \u003cNEW\u003e. Cannot pass both\n fields. Please use \u003cNEW\u003e only.`"]]