SDK 对断网、杀进程的处理

最近更新时间：2022-09-20 05:17:40

断网
V4.0.0 及之后
进程被杀

在断网、进程被杀时，SDK 会自动启用断线重连机制。本文展示 anyRTC SDK 在这两个情况下连接状态的处理逻辑。

断网

V4.0.0 及之后

下图展示从用户 UID 1 加入频道，到连接中断，再到连接完全失败过程中，本地及远端用户 UID 2 的应用层会收到的回调：

其中：

  • T0 = 0 s：SDK 接收到应用层发起的 joinChannel/joinChannelByToken 请求
  • T1 ≈ T0 + 200 ms：通常在调用 joinChannel/joinChannelByToken 200 毫秒后，应用层可以加入频道。加入频道过程中，UID 1 的应用层会收到 onConnectionStateChanged(CONNECTION_STATE_CONNECTING, CONNECTION_CHANGED_CONNECTING)/connectionChangedToState(ArConnectionStateConnecting, ArConnectionChangedConnecting)；加入后收到 onConnectionStateChanged(CONNECTION_STATE_CONNECTED, CONNECTION_CHANGED_JOIN_SUCCESS)/connectionChangedToState(ArConnectionStateConnected, ArConnectionChangedJoinSuccess) 和 onJoinChannelSuccess/didJoinChannel 回调
  • T2 ≈ T1 + 100 ms：因网间传输延迟，UID 2 感知 UID 1 加入频道约有 100 毫秒的延迟，此时 UID 2 的应用层收到 onUserJoined/didJoinedOfUid 回调，
  • T3：某个时间点 UID 1 客户端因断网等原因导致上行网络变差。SDK 会尝试重新加入频道
  • T4 = T3 + 4 s：如果 UID 1 连续 4 秒没有收到服务器发送的任何数据，应用层会收到 onConnectionStateChanged(CONNECTION_STATE_RECONNECTING, CONNECTION_CHANGED_INTERRUPTED)/connectionChangedToState(ArConnectionStateReconnecting, ArConnectionChangedInterrupted) 回调；同时 SDK 继续尝试重新加入频道
  • T5 = T3 + 10 s：如果 UID 1 连续 10 秒没有收到服务器发送的任何数据，应用层会收到 onConnectionLost/rtcEngineConnectionDidLost 回调；同时 SDK 继续尝试重新加入频道
  • T6 = T3 + 20 s：如果 UID 2 连续 20 秒没有收到 UID 1 的任何数据，SDK 判断远端用户掉线，UID 2 的应用层会收到 onUserOffline/didOfflineOfUid 回调
  • T7 = T6 + 20 min：如果 UID 1 连续 20 分钟无法重新加入频道，SDK 不再继续尝试。UID 1 的应用层收到 onConnectionStateChanged(CONNECTION_STATE_FAILED, CONNECTION_CHANGED_JOIN_FAILED)/connectionChangedToState(ArConnectionStateFailed, ArConnectionChangedJoinFailed) 回调；用户需要退出当前频道，然后重新加入频道

如果 UID 2 是 Web 客户端，则 Web 端在 UID 1 加入和重新接入频道时，会收到 client.on('stream-added') 回调；如果 10 秒内未收到 UID 1 的任何数据，会收到 client.on('stream-removed') 回调。

进程被杀

进程被杀包括以下各种情况：

  • 通信模式/直播模式
  • 打开/关闭 voip 模式
  • 前台/后台运行时进程被杀
  • 网页关闭（Web 端）

假设有 UID 1， UID2 两个用户处于同一个频道内进行音视频直播/通话。 当 A 进程被杀：

  • 如果 UID 1 是 iOS 或 mac 平台：UID 1 自动触发 leaveChannel，UID 2 有回调：

    • 如果 UID 2 是 Android， Windows，或 Linux 平台： onUserOffline
    • 如果 UID 2 是 iOS 或 mac 平台： didOfflineOfUid
    • 如果 UID 2 是 Web 平台： client.on('peer-leave')

  • 如果 UID 1 是 Android， Windows，或 Linux 平台，且 UID 2 使用的是 Native SDK：

    • 如果 20 秒内， UID 1 没有重启 app 并加入原频道，UID 2 有回调：
      • 如果 UID 2 是 Android， Windows，或 Linux 平台： onUserOffline
      • 如果 UID 2 是 iOS 或 mac 平台： didOfflineOfUid
    • 如果 20 秒内， UID 1 重启 app 并加入原频道，UID 2 不会收到回调。

  • 如果 UID 1 是 Android， Windows，或 Linux 平台，且 UID 2 使用的是 Web SDK：

    • 如果 10 秒内， UID 1 没有重启 app 并加入原频道，UID 2 有回调：client.on('stream-removed')
    • 如果 10 秒内， UID 1 重启 app 并加入原频道，UID 2 不会收到回调。

  • 如果 UID 1 使用的是 Web SDK，进程被杀与掉线的行为是一样的。

  • 如果 UID 2 是频道内最后一个用户，服务端会在 10s 后销毁频道。