如果您的应用发出 Play Age Signals API 请求,则在调用失败时,您的应用会收到一个错误代码。这些错误可能是由各种原因造成的,例如 Play 商店应用已过时。
重试策略:当用户正在会话中时,我们建议实现一个重试策略,将尝试次数上限作为退出条件,以便尽可能避免错误干扰用户体验。
下表列出了 Play Age Signals API 的错误代码。
| 代码 | 常量 | 说明 | 可重试 |
|---|---|---|---|
| -1 | API_NOT_AVAILABLE | Play Age Signals API 不可用。设备上安装的 Play 商店应用版本可能太低。让用户更新 Play 商店。 | 是 |
| -2 | PLAY_STORE_NOT_FOUND | 在设备上未找到 Play 商店应用。 让用户安装或启用 Play 商店。 | 是 |
| -3 | NETWORK_ERROR | 未找到可用网络。 让用户检查网络连接。 | 是 |
| -4 | PLAY_SERVICES_NOT_FOUND | Play 服务不可用或版本太低。 让用户安装、更新或启用 Play 服务。 | 是 |
| -5 | CANNOT_BIND_TO_SERVICE | 绑定到 Play 商店中的服务时失败。这可能是因为设备上安装的 Play 商店版本太低,或者设备内存过载。 让用户更新 Play 商店应用。 使用指数退避算法重试。 | 是 |
| -6 | PLAY_STORE_VERSION_OUTDATED | Play 商店应用需要更新。 让用户更新 Play 商店应用。 | 是 |
| -7 | PLAY_SERVICES_VERSION_OUTDATED | Play 服务需要更新。 让用户更新 Play 服务。 | 是 |
| -8 | CLIENT_TRANSIENT_ERROR | 客户端设备出现暂时性错误。 实施重试策略,将尝试次数上限作为退出条件。如果问题仍未解决,请让用户稍后再试。 | 是 |
| -9 | APP_NOT_OWNED | 该应用并非由 Google Play 安装。 让用户从 Google Play 获取您的应用。 | 否 |
| -10 | SDK_VERSION_OUTDATED | Play Age Signals SDK 版本已不再受支持。 请用户将您的应用更新到使用最新版 Play Age Signals SDK 的更高版本。 | 否 |
| -100 | INTERNAL_ERROR | 未知内部错误。 实施重试策略,将尝试次数上限作为退出条件。如果问题仍未解决,请让用户稍后再试。 如果持续失败,请与 Google Play 开发者支持团队联系,在主题中注明“Play Age Signals API”,并提供尽可能多的技术细节(例如 bug 报告)。 | 否 |