Express 如何处理 Token 相关错误码？

由于 Token 具有一定的时效性，在应用运行过程中，可能会收到一些与 Token 相关的错误码或事件回调。针对常见的错误码和事件回调，本文提供了触发的原因以及建议的处理方式，方便开发者定位、排查问题。

注意事项

在 Token 过期前 30 秒，SDK 会通过 onRoomTokenWillExpire 回调发出通知。收到该回调后，开发者需要从自己的服务端获取新的有效 Token，并调用 SDK 提供的 renewToken 接口更新 Token。若未处理，不同版本对 Token 过期的处理机制有所不同：

• 若您接入的是 2.8.0 ～ 2.12.0 版本的 ZEGO Express SDK，此时如果未更新 Token，则当权限位过期时：

  • 已登录房间的用户不会被踢出房间。
  • 当前已成功登录房间的用户推拉流不受影响，但是会影响用户的下一次推拉流操作。

• 若您接入的是 2.13.0 及以上版本的 ZEGO Express SDK：

  • 可以联系 ZEGO 技术支持额外配置权限位过期管理机制，此时如果未更新 Token，则当权限位过期时：

    • 已登录房间的用户会被踢出房间，且无法再登录房间。
    • 当前已成功登录房间的用户推流会被停止，也无法进行下一次推流。

  • 若未联系 ZEGO 技术支持额外配置权限位过期管理机制，此时如果未更新 Token：

    • 已登录房间的用户不会被踢出房间。
    • 当前已成功登录房间的用户推拉流不受影响，但是会影响用户的下一次推拉流操作。

Native 平台

Native 平台主要指 Android、iOS、macOS 和 Windows 平台。

错误码

事件回调

onRoomTokenWillExpire：房间 Token 鉴权将要过期的回调通知，会在 Token 过期前 30 秒发出。当收到此回调后，可通过 renewToken 接口来更新 Token。如果没有更新，将会影响用户的下一次登录和推流操作，对当前的操作没有影响。

API 参考：

• iOS：onRoomTokenWillExpire、renewToken
• Android：onRoomTokenWillExpire、renewToken
• macOS：onRoomTokenWillExpire、renewToken
• Windows：onRoomTokenWillExpire、renewToken

Web 平台

错误码