音视频通话

连接状态管理

SDK 端与服务器之间的连接状态会随着初始化/反初始化、登录/登出、进出房间以及网络环境的变化而发生改变,也可能由于网络或鉴权问题导致连接中断。
本文将介绍连接相关的各个阶段、状态变化原因及处理方式。

1. 连接状态说明

为了便于理解 SDK 行为,本文将连接相关状态抽象为以下几类逻辑状态:

  1. 未初始化 — 尚未调用 Init 初始化 SDK。
  2. 未登录 — 已初始化 SDK,但尚未调用 Login 或登录失败 / 已登出。
  3. 已登录(房间外业务中) — Login 成功,收到 LoginSuccess 回调。SDK 与登录服务器之间保持心跳与长连接。
  4. 已进入房间 — 成功调用 EnterMeeting3,收到 EnterMeetingRslt 成功回调。
  5. SDK内部断线重连 — 登录或房间连接由于网络原因中断,SDK会内部自动周期性尝试重连。
  6. 断线 — 收到 LineOff 通知时,代表已经断线。

2. 掉线与重连处理建议

  • 当收到 LineOff 回调时,说明当前账号与登录服务器已断开连接。
  • 建议在 UI 上提示用户「网络异常,连接已断开」。
  • 立即或延迟一段时间再次调用 Login 重登。
  • 如果之前在房间中,掉线重登之后,可以按需重新调用 EnterMeeting3。