Skip to content

onGetUserProfile ​

获取用户敏感信息 ​

该方法用于获取原APP用户敏感信息。主要用途是:为游戏提供APP敏感用户信息。


方法声明 ​

java
/**
 * 当 SDK 请求获取用户详细资料(User Profile)时触发。
 * 通常涉及比基本信息更详细的字段,如性别、地区、实名状态等。
 *
 * @param handle   用于向 SDK 返回处理结果的状态句柄。
 * @param dataJson 包含请求详细属性列表的 JSON 字符串。
 */
void onGetUserProfile(SUDOPStateHandle handle, SUDOPOnGetUserProfileParams params);

运行行为 ​

  • 按需触发:当玩家在游戏内点击查看详细个人名片、或者游戏需要根据性别分配初始角色/皮肤时,引擎会发起此请求。
  • 异步闭环:由于详细资料可能存储在不同的业务服务器,APP 可以在获取所有字段后,通过 handle.success(resultJson) 统一回传。

代码示例 ​

实现详细资料的按需组装与回传:

java
@Override
public void onGetUserProfile(SUDOPStateHandle handle, SUDOPOnGetUserProfileParams params) {
    // 通过后端请求拿到加密后的用户信息,请查看demo代码
    String user_profile_data = requestServer();
    handle.success(user_profile_data);
}

注意事项 ​

  • 数据一致性:确保返回的 userId 与请求中的 ID 一致,避免数据串位。
  • 字段规范:除了 SUDOP 预定义的常量字段外,若游戏有自定义扩展字段需求,需与游戏开发者约定好 JSON 的 Key 名。
  • 非强制性:并非所有游戏都会调用此接口,如果游戏仅需要头像和昵称,通常只会触发 onGetUserInfo。