Skip to content

setAuthInvalidatedListener ​

注册认证失效监听 ​

注册账号级认证失效监听对象。当当前用户的认证失效时,SDK 先清理认证状态,再在主线程通知宿主。宿主收到通知后获取新签名并重新授权,无需判断错误码或错误文案。

该接口及协议声明位于 SUDOP.h,可通过 #import <SUDGI/SUDOP.h> 引入。

方法与协议声明 ​

objectivec
@protocol SUDOPAuthInvalidatedListener <NSObject>
- (void)onAuthInvalidated;
@end

+ (void)setAuthInvalidatedListener:
    (nullable id<SUDOPAuthInvalidatedListener>)listener;

参数说明 ​

参数类型说明
listenerid<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 的宿主需要补齐签名更新能力后主动授权。
  • 首次进入游戏须等待认证成功,页面返回时撤销该页面的等待,账号恢复流程独立管理。运行中静默恢复,失败只首次轻提示,不新增失败页面;恢复成功不重新加载游戏,也不自动重放支付、下单等业务操作。