连接

大约 1 分钟

连接

应用客户端成功连接到环信服务器后,才能使用环信即时通讯 SDK 的收发消息等功能。

你调用 open 方法登录后,客户端 SDK 会自动连接环信服务器。关于登录详情,请参见登录文档

监听连接状态

conn.addEventHandler("connectionListener", {
  onConnected: () => {
    console.log("连接成功");
  },
  // 自 4.8.0 版本,`onDisconnected` 事件新增断开原因回调参数, 告知用户触发 `onDisconnected` 的原因。
  onDisconnected: () => {
    console.log("连接断开");
  },
  onReconnecting: () => {
    console.log("重连中");
  };
});

自动重连

登录后,SDK 在以下情况下会尝试自动重连:

  • 网络断开

  • 网络切换

  • 非主动调用登出

不过,SDK 在以下情况下会停止自动重连。你需要调用 open 方法登录。

  • 用户调用了 SDK 的登出方法 close 主动退出登录。
  • 登录时鉴权错误,例如, token 无效(错误码 104)或已过期(错误码 108)。
  • 用户在其他的设备上更改了密码,导致此设备上自动登录失败,提示错误码 216。
  • 用户的账号被从服务器端删除,提示错误码 207。
  • 用户在另一设备登录,将当前设备上登录的用户踢出,提示错误码 206。
  • 用户登录设备数量超过限制,提示错误码 214。
  • 应用程序的日活跃用户数量(DAU)或月活跃用户数量(MAU)达到上限,提示错误码 8。