错误处理
Combo SDK 的异步 API 调用失败时,返回的 Result 中会包含 Error,其中包含了统一的数据结构。游戏侧可根据业务场景对 Error 进行进一步处理。
最佳实践:
- 根据
Code
区分不同类型错误,以作相应特殊处理。 - 在游戏自行设计的弹窗 UI 中显示
Message
提示信息。 - 在日志中输出
DetailMessage
错误详情,以便排查、定位问题。
Error
Property | Type | Description |
---|---|---|
Code | string | Combo SDK 定义的业务错误码 示例: - NETWORK_ERROR - USER_CANCELLED |
Message | string | 可阅读的提示信息,常用于弹窗显示 示例: - 未连接到互联网,请检查网络后重试 - 用户取消 |
DetailMessage | string | 错误详情,可用于日志输出 示例: - 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")
{
// 玩家主动取消登录操作后游戏处理流程
}
}
});