处理 Android SDK 中的错误

SDK 返回的每个错误均为 AdaptyError。

如果这些解决方案无法解决您的问题，请在联系支持之前参阅其他问题中的步骤，以便我们更高效地为您提供帮助。

错误解决方案
UNKNOWN此错误表示发生了未知或意外的错误。
ITEM_UNAVAILABLE此错误大多发生在测试阶段。可能表示产品未在生产环境中提供，或者用户不属于 Google Play 中的测试人员组。
ADAPTY_NOT_INITIALIZEDAdapty SDK 未激活。您需要使用 Adapty.activate 方法正确配置 Adapty SDK。
PRODUCT_NOT_FOUND此错误表示请求购买的产品在商店中不可用。
INVALID_JSON

本地备用付费墙的 JSON 无效。

请修复您的默认英文付费墙，然后替换无效的本地付费墙。有关如何修复付费墙的详细信息，请参阅使用远程配置自定义付费墙主题；有关如何替换本地付费墙的详细信息，请参阅定义本地备用付费墙。

CURRENT_SUBSCRIPTION_TO_UPDATE

_NOT_FOUND_IN_HISTORY

需要替换的原始订阅未在活跃订阅中找到。
BILLING_SERVICE_TIMEOUT此错误表示请求在 Google Play 响应之前已达到最大超时时间。例如，这可能是由于 Play Billing Library 调用所请求的操作执行延迟所致。
FEATURE_NOT_SUPPORTED当前设备上的 Play Store 不支持所请求的功能。
BILLING_SERVICE_DISCONNECTED此错误表示客户端应用通过 BillingClient 与 Google Play Store 服务的连接已中断。
BILLING_SERVICE_UNAVAILABLE此错误表示 Google Play 计费服务当前不可用。在大多数情况下，这意味着客户端设备与 Google Play 计费服务之间的某处存在网络连接问题。
BILLING_UNAVAILABLE

此错误表示购买过程中发生了计费问题。可能的原因包括：

1. 用户设备上的 Play Store 应用缺失或已过时。

2. 用户所在国家/地区不受支持。

3. 用户属于企业账户，管理员已禁用购买功能。

4. Google Play 无法向用户的付款方式收费（例如信用卡已过期）。

5. 用户未登录 Play Store 应用。

DEVELOPER_ERROR此错误表示您正在错误地使用某个 API。
BILLING_ERROR此错误表示 Google Play 本身存在内部问题。
ITEM_ALREADY_OWNED该产品已被购买。
ITEM_NOT_OWNED此错误表示由于用户不拥有该商品，对该商品执行的请求操作失败。
BILLING_NETWORK_ERROR此错误表示设备与 Play 系统之间的网络连接存在问题。
NO_PRODUCT_IDS_FOUND

此错误表示付费墙中的所有产品均在商店中不可用。

如果您遇到此错误，请按照以下步骤解决：

  1. 检查所有产品是否已添加到 Adapty 看板。
  2. 确保您的应用的包名与 Google Play Console 中的包名一致。
  3. 验证应用商店中的产品标识符与您在看板中添加的标识符是否匹配。请注意，标识符不应包含 Bundle ID，除非商店中已包含该 ID。
  4. 确认您的 Google 税务设置中应用的付费状态为活跃。确保您的税务信息是最新的，且证书有效。
  5. 检查是否已为应用绑定银行账户，以便其符合变现资格。
  6. 检查产品是否在您所在的地区可用。
  7. 确保您的应用位于某个测试轨道中。内部测试轨道是最简单的选项，因为它不需要审核且对用户不可见。
NO_PURCHASES_TO_RESTORE此错误表示 Google Play 未找到可恢复的购买记录。
AUTHENTICATION_ERROR您需要使用 Adapty.activate 方法正确配置 Adapty SDK。
BAD_REQUEST请求无效。
请确保您已完成与 Google Play 集成所需的所有步骤。
SERVER_ERROR服务器错误。
REQUEST_FAILED此错误表示无法明确定义的网络问题。
DECODING_FAILED我们无法解码响应。
请检查您的代码，确保您发送的参数有效。例如，此错误可能表示您使用了无效的 API 密钥。
ANALYTICS_DISABLED由于您已选择退出，我们无法处理分析事件。
WRONG_PARAMETER此错误表示您的某些参数不正确：不能为空时为空，或类型错误等。

其他问题

如果您尚未找到解决方案，可以采取以下后续步骤：

  • 将 SDK 升级到最新版本：我们始终建议升级到最新的 SDK 版本，因为它们更稳定并包含已知问题的修复。
  • 联系支持团队或在支持论坛中获得其他开发者的帮助。
  • 通过 [email protected] 或在线聊天联系支持团队：如果您还不打算升级 SDK 或升级后问题仍未解决，请联系我们的支持团队。请注意，如果您启用详细日志记录并与团队共享日志，您的问题将得到更快解决。您也可以附上相关代码片段。