错误处理
如果广告加载或展示失败，您的广告展示委托或回传接口会收到调用。 该调用带有一个错误代码。 本页介绍了这些错误代码。
错误对象
您在回传中收到的错误是一个实现 MaxError 的一等 (first-class) 错误对象。
该对象具有以下方法：
getCode()- 返回错误代码，见下表。
getMessage()- 返回描述该错误的可读信息。
getMediatedNetworkErrorCode()- 返回聚合平台针对该错误的错误代码。 仅适用于广告展示失败回传中返回的错误。
getMediatedNetworkErrorMessage()- 返回聚合平台针对该错误的错误信息。 默认为空字符串。 仅适用于广告展示失败回传中返回的错误。
getWaterfall()- 允许您查看广告当前的瀑布流信息。 平台响应会提供瀑布流中每则广告的广告加载状态、延迟、凭证和被聚合平台信息。 如果瀑布流中的某则广告加载失败，平台响应会提供错误信息。您可以在高级设置: Waterfall Information API 中找到有关此方法的更多信息。
MAX 错误代码
| 代码 | 常量 | 描述 | 加载 / 展示 |
|---|---|---|---|
| 204 | MaxErrorCode.NO_FILL | 当前没有适合设备的广告 (未填充)。对于该应用/设备，MAX 未能从任何聚合平台中返回符合条件的广告。 | L |
| -1 | MaxErrorCode.UNSPECIFIED | 系统处于异常状态。该状态无法归入其他已定义的错误类型。请查看错误对象中的消息字段，了解更多详情。 | L/D |
| -23 | MaxErrorCode.FULLSCREEN_AD_ALREADY_SHOWING | 您试图展示一则全屏广告 (插屏广告或激励广告)，但另一则全屏广告仍在展示中。 | D |
| -24 | MaxErrorCode.FULLSCREEN_AD_NOT_READY | 您试图在广告加载完成之前显示全屏广告。 | D |
| -1000 | MaxErrorCode.NETWORK_ERROR | 由于一般网络错误，广告请求失败。请查看错误对象中的消息字段，了解更多详情。 | L |
| -1001 | MaxErrorCode.NETWORK_TIMEOUT | 由于网速较慢，广告请求超时。 | L |
| -1009 | MaxErrorCode.NO_NETWORK | 设备未连接至互联网，广告请求失败。 | L |
| -5001 | MaxErrorCode.AD_LOAD_FAILED | 无平台可填充广告，因此加载失败。MAX 已返回来自聚合平台的符合条件的广告，但所有广告均加载失败。请查看错误对象中的 adLoadFailureInfo 字段，了解更多详情。 | L |
| -5201 | MaxErrorCode.ERROR_CODE_INVALID_LOAD_STATE | SDK 内部状态无效。该错误可由多种原因引起。 | L |
| -5205 | MaxAdapterError.AD_NOT_READY | 适配器在尝试展示时没有已准备好的广告。 | L |
| -5209 | MaxAdapterError.INTERNAL_ERROR | 未指明的内部错误。 | L |
| -5601 | MaxErrorCode.NO_ACTIVITY | SDK 无法加载广告，因为找不到最顶层的 Activity。 | L |
| -5602 | MaxErrorCode.DONT_KEEP_ACTIVITIES_ENABLED | SDK 未能展示广告，因为用户启用了 “Don’t Keep Activities” 开发者设置。 | D |
| -5603 | MaxErrorCode.INVALID_AD_UNIT_ID | SDK 无法加载广告，因为开发者提供了无效的广告单元标识符。广告单元标识符无效的可能原因有：
| L |
不同平台的错误代码
要进一步了解不同广告平台返回的错误代码，请查看这些平台发布的错误相关文档：