连接状态管理
SDK 端与服务器之间的连接状态会随着初始化/反初始化、登录/登出、进出房间以及网络环境的变化而发生改变,也可能由于网络或鉴权问题导致连接中断。
本文介绍连接相关的各个阶段、状态变化原因及处理方式。
1. 连接状态说明
为了便于理解 SDK 行为,本文将连接相关状态抽象为以下几类逻辑状态:
- 未初始化
- 尚未完成 SDK 初始化。
- 未登录
- 已初始化 SDK,但尚未调用登录接口或登录失败 / 已登出。
- 已登录(房间外业务中)
- 登录成功,收到 loginSuccess 回调。
- SDK 与登录服务器之间保持心跳与长连接,可收发队列、呼叫、邀请等信令。
- 已进入房间
- 成功调用 enterMeeting,收到 enterMeetingRslt 成功回调。
- 与房间服务器建立媒体连接,可进行音视频、屏幕共享等业务。
- 房间内其他人将收到 userEnterMeeting 回调。
- SDK 内部断线重连
- 登录或房间连接由于网络原因中断,SDK 会内部自动周期性尝试重连(总尝试时间为 SDK 的连接超时时间,默认为 60 秒)。重连成功则业务可继续,重连不成功将回调 lineOff。
- SDK 内部断线重连时,对应用层通常无感知;重连成功后 SDK 会有序重传信令数据。
- 重连期间音视频可能短暂卡住,重连成功后自动恢复。
- 断线
- 当网络长时间中断,收到 lineOff 通知时,代表已经断线,SDK 进入“未登录”状态,此后 SDK 内部不再尝试重连。
- 如果断线之前在房间中,此时自动进入离开房间状态,房间内其他人将收到 userLeftMeeting 回调。
2. 掉线与重连处理建议
在复杂网络环境下,断线不可避免。SDK 内部已实现短时间内常见断线的自动重连(如切换 WiFi、网络闪断等);更长时间的断线将回调 lineOff,建议在应用层实现温和重连策略。
掉线(lineOff)
- 当收到 lineOff 回调时,说明当前账号与登录服务器已断开连接。
- 建议处理方式:
- 在 UI 上提示用户「网络异常,连接已断开」。
- 立即或延迟一段时间后再次调用 login / loginByToken 重登,可设置重试次数上限与退避策略。
- 如重试多次失败,可引导用户检查网络。
- 如果之前在房间中,掉线重登之后,可以按需重新调用 enterMeeting。
房间内掉线(meetingDropped)
- 当收到 meetingDropped 回调时,说明本端与房间服务器的连接已断开,但登录状态可能仍保持。
- 建议处理方式:
- 提示用户网络异常。
- 可调用 enterMeeting 尝试重新进入房间。
- 若使用了呼叫队列,掉线后不重新进入房间则须调用 hangupCall 释放本次呼叫。
网络质量检测
在房间内,可以通过以下接口感知网络状况:
- 被动监听:netStateChanged 回调,参数 level 为 0~10 的网络评分(10 为最佳)。
- 更多流质量监测参见 通话中质量监测。
相关 API 请参考: