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;参数说明
| 参数名 | 类型 | 必传 | 描述 |
|---|---|---|---|
| userSignature | NSString * | 是 | 服务端生成的加密签名字符串,用于校验用户合法性。 |
| completion | SUDOPCompletionBlock | 否 | 认证完成后的回调。如果签名过期或格式错误,error 将携带具体错误信息。 |
运行行为
- 权限激活:认证成功后,SDK 内部的状态机将转为
Authenticated,允许调用启动游戏等核心接口。 - 令牌管理:认证成功后保存用户 Token 并启动用户 ping。认证失效由 setAuthInvalidatedListener: 通知宿主获取新签名并重新授权;SDK 不代替宿主获取签名或重试。
- 前置依赖:必须在
initializeWithConfiguration:completion:成功回调后调用。 - 失败语义:主动授权失败保留已有认证,仅通过本次 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 秒重试、后台暂停等宿主规则见认证失效监听。
