Skip to content

onGetLegacyUserIdentity ​

获取APP原用户身份标识 ​

该方法用于新版本游戏包获取原APP用户身份标识。主要用途是:新版本游戏启动时,原APP用户登录成功后,游戏需要获取原APP用户身份标识,用于后续游戏数据同步。


方法声明 ​

java
/**
 * 当 SDK 请求获取旧版用户身份标识(Legacy User Identity)时触发。
 * 通常用于兼容旧版本系统或迁移存量用户数据。
 *
 * @param handle   用于向 SDK 返回处理结果的状态句柄。
 */
void onGetLegacyUserIdentity(SUDOPStateHandle handle);

运行行为 ​

  1. 触发时机:当小游戏加载并尝试恢复用户的历史存档、战绩或道具,但发现当前登录体系与历史数据不匹配时,引擎会发起此请求。
  2. 异步反馈:APP 接收到请求后,通过查询本地数据库或服务端接口找到对应的旧版标识,并利用 handle.success(json) 异步推回。

代码示例 ​

实现旧版 ID 的查找与回传逻辑:

java
@Override
public void onGetLegacyUserIdentity(SUDOPStateHandle handle) {
    String userId = gameViewModel.getUserId();
    JSONObject obj = new JSONObject();
    try {
        obj.put("legacy_user_identity", userId);
    } catch (Exception e) {
        e.printStackTrace();
    }
    handle.success(obj.toString());
}

注意事项 ​

  • 兼容性保障:如果您的 APP 是首次接入 Sud SDK 且没有历史遗留数据,可以在此方法中直接返回 handle.success("{}") 或当前的 userId。
  • 非阻塞调用:由于涉及到身份查询,可能存在网络耗时。必须使用 handle 对象进行异步响应,严禁在回调方法内进行同步耗时操作。
  • 安全性:仅返回协议要求的标识符,不要在此接口中透传任何明文密码或敏感隐私信息。