连接状态管理
SDK 端与服务器之间的连接状态会随着创建/销毁 SDK 对象、登录/登出、进出房间以及网络环境的变化而发生改变,也可能由于网络或鉴权问题导致连接中断。
本文将介绍连接相关的各个阶段、状态变化原因及处理方式。
1. 连接状态说明
为了便于理解 SDK 行为,本文将连接相关状态抽象为以下几类逻辑状态:
- 未初始化
- 尚未调用 create 创建 CRVSDKMain 对象。
- 未登录
- 已创建 SDK 对象,但尚未调用 login 或登录失败 / 已登出。
- 已登录(房间外)
- 已进入房间
- 成功调用 enterMeeting,收到 enterMeetingRslt 成功回调。
- 与房间服务器建立媒体连接,可进行音视频、影音共享、屏幕共享等业务。
- 房间内其他人将收到 notifyUserEnterMeeting 回调。
- SDK 内部断线重连
- 登录或房间连接由于网络原因中断,SDK 会内部自动周期性尝试重连(默认总尝试时间 60 秒)。
- 重连成功后 SDK 会有序重传信令数据;音视频在重连期间会卡住,恢复后自动正常。
- 断线
- 收到 notifyLineOff 时,代表已经断线,SDK 进入"未登录"状态,不再自动重连。
- 若断线之前在房间中,自动进入离开房间状态,其他人收到 notifyUserLeftMeeting 回调。
下图为 SDK 连接状态切换描述图:

2. 掉线与重连处理建议
在复杂网络环境下,断线不可避免。SDK 内部已实现短时间内常见断线的自动重连;更长时间的断线将回调 notifyLineOff,建议应用实现温和重连策略。
掉线(notifyLineOff)
- 当收到 notifyLineOff 回调时,说明当前账号与登录服务器已断开连接。
- 建议处理方式:
- 在 UI 上提示用户「网络异常,连接已断开」
- 立即或延迟再次调用 login 重登,可设置重试次数上限与退避策略
- 如重试多次失败,引导用户检查网络
- 若之前在房间中,重登后可按需重新调用 enterMeeting
回调注册
在初始化阶段注册登录、掉线、入会等回调,写法参考 实现音视频通话 中的 initCallbacks。
相关 API 请参考:
3. 网络质量监测
房间内网络质量可通过 notifyNetStateChanged 被动感知,详见 通话中质量监测。