onGetUserInfo
获取用户基本信息
该方法用于获取原APP用户信息。主要用途是:为游戏提供APP非敏感用户信息。
方法声明
java
/**
* 当 SDK 请求获取用户基本信息(User Info)时触发。
* APP 应根据此请求通过 handle 返回用户的昵称、头像等基础信息。
*
* @param handle 用于向 SDK 返回处理结果的状态句柄。
* @param dataJson 包含请求参数(如用户 ID 列表)的 JSON 字符串。
*/
void onGetUserInfo(SUDOPStateHandle handle);运行行为
- 触发时机:通常发生在游戏初始化、玩家加入房间、或点击查看他人简要信息时。
- 标准格式:APP 必须按照 SUDOP 协议约定的 Key(如
nickname,avatar)构造 JSON 结果。 - 异步反馈:支持在网络请求完成后,通过
handle.success(resultJson)异步将数据同步给游戏。
代码示例
实现基础信息的查询与异步回传:
java
@Override
public void onGetUserInfo(SUDOPStateHandle handle) {
String userId = gameViewModel.getUserId();
JSONObject obj = new JSONObject();
try {
obj.put("nickname", "this is nickname");
obj.put("avatar", "this is avatar");
} catch (Exception e) {
e.printStackTrace();
}
handle.success(obj.toString());
}注意事项
- 头像规格:建议提供高清晰度且比例为 1:1 的头像 URL,以便游戏在不同 UI 尺寸下保持良好的视觉效果。
- 缓存策略:对于频繁请求的用户信息,建议 APP 侧做好缓存,避免每次都发起网络请求导致游戏画面出现卡顿或加载转圈。
- 字段对齐:务必使用
SUDOP常量类中定义的 Key 名,避免因拼写错误导致游戏无法解析数据。
