跳到主要内容

错误处理

Combo SDK 的异步 API 调用失败时,返回的 Result 中会包含 Error,其中包含了统一的数据结构。游戏侧可根据业务场景对 Error 进行进一步处理。

最佳实践:

  • 根据 Code 区分不同类型错误,以作相应特殊处理。
  • 在游戏自行设计的弹窗 UI 中显示 Message 提示信息。
  • 在日志中输出 DetailMessage 错误详情,以便排查、定位问题。

Error

PropertyTypeDescription
CodestringCombo SDK 定义的业务错误码
示例:
- NETWORK_ERROR
- USER_CANCELLED
Messagestring可阅读的提示信息,常用于弹窗显示
示例:
- 未连接到互联网,请检查网络后重试
- 用户取消
DetailMessagestring错误详情,可用于日志输出
示例:
- errorMsg = 用户取消,cause = "UserCancelled()"
注意:请勿在 UI 上展示
提示

可在相应功能开发指南 API 详情中查看 Error Code 具体值。

代码示例

Show Code
ComboSDK.Login(r =>
{
if (r.IsSuccess)
{
//登录成功后游戏逻辑
}
else
{
var error = r.Error;
// 请游戏自行完成弹窗 UI 代码设计
Toast.Show(error.Message);
Debug.LogError("登录失败:" + error.DetailMessage);
if (error.Code == "USER_CANCELLED")
{
// 玩家主动取消登录操作后游戏处理流程
}
}
});