如果您的应用发出 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 报告)。 | 否 |