Skip to content

authWithUserSignature:completion: ​

用户身份认证 ​

该方法使用从开发者服务端获取的用户签名(User Signature)对 SDK 进行授权。只有在认证成功后,SDK 才能安全地访问游戏资源、同步用户数据及执行与用户身份相关的敏感操作。


方法声明 ​

objectivec
/**
 Authenticate the SDK with a user signature.
 @param userSignature The signature used to authenticate the user.
 @param completion Called when authentication finishes.
 */
+ (void)authWithUserSignature:(NSString *)userSignature
                   completion:(nullable SUDOPCompletionBlock)completion;

参数说明 ​

参数名类型必传描述
userSignatureNSString *是服务端生成的加密签名字符串,用于校验用户合法性。
completionSUDOPCompletionBlock否认证完成后的回调。如果签名过期或格式错误,error 将携带具体错误信息。

运行行为 ​

  1. 权限激活:认证成功后,SDK 内部的状态机将转为 Authenticated,允许调用启动游戏等核心接口。
  2. 令牌管理:认证成功后保存用户 Token 并启动用户 ping。认证失效由 setAuthInvalidatedListener: 通知宿主获取新签名并重新授权;SDK 不代替宿主获取签名或重试。
  3. 前置依赖:必须在 initializeWithConfiguration:completion: 成功回调后调用。
  4. 失败语义:主动授权失败保留已有认证,仅通过本次 completion 返回错误,不触发认证失效通知。每次调用最多返回一次终态,旧请求结果不能覆盖或清理新认证。

代码示例 ​

objectivec
// 1. 从您的业务服务器获取 userSignature
NSString *myUserSignature = @"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";

// 2. 调用 SDK 认证
[SUDOP authWithUserSignature:myUserSignature completion:^(NSError * _Nullable error) {
    if (error) {
        NSLog(@"用户认证失败: %@", error.localizedDescription);
    } else {
        NSLog(@"用户认证成功,现在可以启动游戏了");
    }
}];

注意事项 ​

  • 签名获取:userSignature 必须由开发者的服务器生成,严禁在客户端直接计算签名以防密钥(AppKey)泄露。
  • 时效性:签名通常具有时效性。如果 SDK 返回签名过期的错误,请重新向服务器请求新签名并再次调用此接口。
  • 账号切换:先停止旧账号的恢复流程并调用 uninitialize,结束旧 SDK 会话,再重新初始化、注册失效监听并使用新账号签名授权。不能把旧账号的认证视为新账号授权成功。
  • 并发调用:宿主应合并同一账号的主动授权和恢复触发,串行执行“获取新签名 → auth”。被后续授权取代的旧请求不会写回认证状态,其 completion 可以返回失败。
  • 恢复边界:首次进入游戏等待授权成功;运行中重新授权成功后保留现有游戏,不重复加载或自动重放支付等操作。3 秒/5 秒重试、后台暂停等宿主规则见认证失效监听。