在实时音视频场景下,app 端与声网 SD-RTN™ 之间的连接状态会随着客户端加入或离开频道而发生变化,也可能由于网络或鉴权问题而导致连接中断。
本文介绍各种频道连接状态,状态改变原因和处理方式,帮助你更好地管理用户和排除网络故障。
当连接状态发生变化时,声网会发送 OnConnectionStateChanged
回调。 下图展示各种连接状态,以及用户从加入到离开频道的过程中连接状态如何改变:
通信过程中,如果因网络问题导致连接断开,SDK 会自动开启断线重连机制。下图展示本地用户(UID1)和远程用户(UID2)在以下过程中收到的回调:本地用户加入频道、发生网络异常、连接中断、重新加入频道。
图解如下:
JoinChannel
请求。JoinChannel
200 ms 后,UID1 加入频道。 同时,UID1 收到 OnConnectionStateChanged(CONNECTION_STATE_CONNECTING, CONNECTION_CHANGED_CONNECTING)
回调。 成功加入频道后,UID1 收到 OnConnectionStateChanged(CONNECTION_STATE_CONNECTED, CONNECTION_CHANGED_JOIN_SUCCESS)
和 OnJoinChannelSuccess
回调。OnUserJoined
回调。OnConnectionStateChanged(CONNECTION_STATE_RECONNECTING, CONNECTION_CHANGED_INTERRUPTED)
回调;同时 SDK 继续尝试重新加入频道。OnConnectionStateChanged(CONNECTION_STATE_RECONNCTING,CONNECTION_CHANGED_INTERRUPTED)
后连续 10 秒没有收到服务器发送的任何数据,UID 1 会收到 OnConnectionLost
回调;同时 SDK 继续尝试重新加入频道。onUserOffline
回调。OnConnectionStateChanged(CONNECTION_STATE_RECONNCTING, CONNECTION_CHANGED_INTERRUPTED)
后连续 20 分钟无法重新加入频道,SDK 不再继续尝试。UID 1 收到 OnConnectionStateChanged(CONNECTION_STATE_FAILED, CONNECTION_CHANGED_JOIN_FAILED)
回调;用户需要退出当前频道,然后重新加入频道。在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见开始视频通话。
本节介绍如何使用 OnConnectionStateChanged
回调来监控频道连接状态的变化。
在你的项目中,打开管理 IRtcEngineEventHandler
的文件,在 IRtcEngineEventHandler
初始化进程中加入 OnConnectionStateChanged
。
你可以从日志中读取当前连接状态,以及状态更改的触发原因。
另外,OnConnectionStateChanged
中的 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 |
|