setAuthInvalidatedListener
注册认证失效监听
注册账号级认证失效监听对象。当当前用户的认证失效时,SDK 先清理认证状态,再在主线程通知宿主。宿主收到通知后获取新签名并重新授权,无需判断错误码或错误文案。
该接口及协议声明位于 SUDOP.h,可通过 #import <SUDGI/SUDOP.h> 引入。
方法与协议声明
objectivec
@protocol SUDOPAuthInvalidatedListener <NSObject>
- (void)onAuthInvalidated;
@end
+ (void)setAuthInvalidatedListener:
(nullable id<SUDOPAuthInvalidatedListener>)listener;参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
listener | id<SUDOPAuthInvalidatedListener> | SDK 弱引用该对象,宿主必须自行持有。传 nil 解除监听。 |
onAuthInvalidated 无参数,仅表示当前认证已失效。失效原因由 SDK 内部记录诊断日志;重新授权失败仍通过该次 auth completion 返回。
通知行为
- 当前用户 ping 返回
42021(invalid user token)时,SDK 先核对认证会话,再清理用户 Token、用户身份和签名记录,停止该会话的用户 ping,最后在主线程通知宿主。 - 每次成功认证后最多投递一次失效通知。旧请求不能清理新认证、向新会话发送旧失效通知或取消正在进行的新授权。
- 主动
authWithUserSignature:completion:失败只调用本次 completion,保留已有认证,不触发onAuthInvalidated。 - 解除监听或调用 uninitialize 后不再投递旧通知。反初始化不会触发失效通知;重新接入时需要重新注册。
- SDK 不持锁调用宿主。建议使用账号级统一接入层接收通知,避免把恢复流程绑定到单个游戏页面。
接入示例
objectivec
// 宿主必须强持有账号级协调对象,例如:
@property(nonatomic, strong) id<SUDOPAuthInvalidatedListener> authCoordinator;
// 初始化并准备好账号会话后,在首次 auth 前注册。
[SUDOP setAuthInvalidatedListener:self.authCoordinator];
// 在 authCoordinator 中实现协议方法。
- (void)onAuthInvalidated {
// 触发宿主已有的串行恢复入口:获取当前账号的新签名,再调用 auth。
// 恢复成功保留现有游戏,不重复加载游戏或重放业务操作。
}
// 不再使用监听时解除注册;SDK 反初始化也会解除注册。
[SUDOP setAuthInvalidatedListener:nil];宿主与 Demo 的恢复规则
SDK 只负责失效通知,不负责获取宿主服务端签名、重试或界面提示。首次主动授权失败和后续认证失效应由宿主统一处理;本仓库 Demo 的 SUDOPGameManager 按以下规则实现恢复:
| 时机 | 下一次尝试 |
|---|---|
| 首次认证失效通知 | 立即尝试;若刚认证成功,确保两次尝试之间至少间隔 3 秒。 |
| 连续第 1~3 次尝试失败 | 从失败回调起各等待 3 秒。 |
| 连续第 4 次及以后失败 | 从失败回调起各等待 5 秒,直到成功。 |
- 每次尝试都获取当前账号的新
userSignature,再调用 auth;不要反复使用失效签名。同一账号会话最多一个恢复流程,重复触发合并,请求未返回时不启动下一次尝试。 - 成功后停止重试并清零失败次数,继续监听失效。不额外设置业务超时,沿用底层 HTTP 超时;签名提供方必须在失败或超时时最终回调。
- 不以系统网络状态作为重试开关。已提供签名获取能力时,获取失败、空签名及 auth 失败均按上述间隔重试,不根据错误类型另设暂停条件。
- App 进入后台时暂停主动重试;回到前台后,在满足间隔且没有请求进行中时继续,不补发积压任务。
- 退出账号、切换账号或环境、反初始化时停止旧流程并丢弃迟到结果。不要仅因认证失效就清除 App 登录态。
- 未提供获取新签名的能力时,不启动自动重试。Demo 优先使用
userSignatureProvider;仅配置固定userSignature的宿主需要补齐签名更新能力后主动授权。 - 首次进入游戏须等待认证成功,页面返回时撤销该页面的等待,账号恢复流程独立管理。运行中静默恢复,失败只首次轻提示,不新增失败页面;恢复成功不重新加载游戏,也不自动重放支付、下单等业务操作。
