在实时音视频场景下,app 端与声网 SD-RTN™ 之间的连接状态会随着客户端加入或离开频道而发生变化,也可能由于网络或鉴权问题而导致连接中断。
本文介绍各种频道连接状态,状态改变原因和处理方式,帮助你更好地管理用户和排除网络故障。
当连接状态发生变化时,声网会发送 onConnectionStateChanged
回调。 下图展示各种连接状态,以及用户从加入到离开频道的过程中连接状态如何改变:
通信过程中,如果因网络问题导致连接断开,SDK 会自动开启断线重连机制。下图展示本地用户(UID1)和远程用户(UID2)在以下过程中收到的回调:本地用户加入频道、发生网络异常、连接中断、重新加入频道。
图解如下:
joinChannel
请求。joinChannel
200 ms 后,UID1 加入频道。 同时,UID1 收到 onConnectionStateChanged(CONNECTING, CONNECTING)
回调。 成功加入频道后,UID1 收到 onConnectionStateChanged(CONNECTED, JOIN_SUCCESS)
和 onJoinChannelSuccess
回调。onUserJoined
回调。onConnectionStateChanged(RECONNECTING, INTERRUPTED)
回调;同时 SDK 继续尝试重新加入频道。onConnectionStateChanged(RECONNECTING, INTERRUPTED)
后连续 10 秒没有收到服务器发送的任何数据,UID 1 会收到 onConnectionLost
回调;同时 SDK 继续尝试重新加入频道。onUserOffline
回调。onConnectionStateChanged(RECONNECTING, INTERRUPTED)
后连续 20 分钟无法重新加入频道,SDK 不再继续尝试。UID 1 收到 onConnectionStateChanged(FAILED, JOIN_FAILED)
回调;用户需要退出当前频道,然后重新加入频道。在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见开始视频通话。
本节介绍如何使用 onConnectionStateChanged
回调来监控频道连接状态的变化。
在你的项目中,打开管理 IRtcEngineEventHandler
的文件,在 IRtcEngineEventHandler
初始化进程中加入 onConnectionStateChanged
。
你可以从日志中读取当前连接状态,以及状态更改的触发原因。
另外,connectionChangedToState
中的 reason
参数也解释了连接状态改变的原因,可帮助你进行网络故障排除。 有关频道连接状态变化的原因以及排障方式,详见状态说明及排障指导。
介绍更多相关信息和参考页面的链接。
如前文图中所示,app 在加入和离开频道前后可能出现以下 5 种连接状态:
连接状态 | 描述 |
---|---|
Disconnected | 初始连接状态。 它通常发生在:
|
Connecting | 调用 joinChannel 方法后的瞬时状态。 |
Connected | 发生在 app 成功加入频道后。 SDK还会触发 onJoinChannelSuccess 回调,上报本地客户端已经加入频道。 此时用户可以发布或订阅频道中的音频和视频。 |
Reconnecting | 发生在连接中断时。 SDK 会在中断后自动尝试重新连接。
|
Failed | 连接失败。 发生在 SDK 在 20 分钟内无法加入频道、并且 SDK 停止重新连接频道时。 此时需调用 leaveChannel 离开当前频道,再调用 joinChannel 再次加入频道。 |
onConnectionStateChanged
中的 reason
参数描述了连接状态更改原因。
下表列出了不同连接状态和状态变化原因之间的映射关系,以及发生网络中断时故障时的处理方法。
连接状态 | 状态说明和排障指导 |
---|---|
Disconnected |
|
Connecting |
|
Connected |
|
Reconnecting |
|
Failed |
|