文档中心

auth ​

用户登录态鉴权 ​

auth 方法用于建立 SDK 与业务用户之间的安全上下文。在进行任何游戏下载或启动操作之前，必须通过此接口将业务服务端生成的 userSignature 同步给 SDK。

方法声明 ​

java
/**
 * 用户登录态鉴权
 *
 * @param userSignature     用户鉴权签名
 * @param listener          鉴权结果监听器
 */
public static void auth(String userSignature, SUDOPAuthListener listener);

参数说明 ​

用于封装鉴权所需的令牌信息：

属性类型描述
userSignatureString必填。由业务服务端生成的加密签名，用于验证用户身份。

SUDOPAuthListener ​

用于接收鉴权状态回调：

  • void onSuccess()：鉴权成功。SDK 已建立合法的用户会话。
  • void onFailure(int retCode, String retMsg)：鉴权失败。可能原因包括签名过期、格式错误或网络异常。

代码示例 ​

java
// 发起鉴权请求
SUDOP.auth("YOUR_SERVER_GENERATED_SIGNATURE", new SUDOPAuthListener() {
    @Override
    public void onSuccess() {
        // 鉴权成功，现在可以调用 startGameByGameId 启动游戏
        Log.i("SUDOP", "User authenticated successfully.");
    }

    @Override
    public void onFailure(int retCode, String retMsg) {
        // 鉴权失败，请检查 userSignature 是否正确生成
        Log.e("SUDOP", "Auth failed: " + retMsg + " (Code: " + retCode + ")");
    }
});

注意事项 ​

  • 时效性：userSignature 通常具有有效期，请确保在签名过期前调用此接口。
  • 调用顺序：必须在 initSDK 成功回调后调用。
  • 状态覆盖：多次调用 auth 会更新当前 SDK 的用户上下文。如果 App 发生切换账号逻辑，需重新调用此接口更新用户信息。