连接
大约 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。