跳转至

链接接口

连接

注意事项

  1. 连接方法必须在执行 初始化 之后调用
  2. 除初始化、监听以外, 所有方法都必须在 connect 成功之后 再调用
  3. 默认一个用户只支持一个页面连接, 开通 "多设备消息同步" 即可支持多页面连接

参数说明:

参数 类型 必填 说明 最低版本
token String 用户的唯一标识 3.0.0

代码示例:

var user = {
  token: 'mKmyKqTSf7aNDinwAFMnz7NXKI3dV3X0+Cd1BOxmtO2pmvsjW2HViWrePIfq0GuTu9jELQqsckv4AhfjCAKgQ=='
};
var im = RongIMLib.init({ appkey: 'kj29cjn0l1myd' }); // 初始化 IM 实例(单个页面仅需初始化一次)
im.connect(user).then(function(user) {
  console.log('链接成功, 链接用户 id 为: ', user.id);
}).catch(function(error) {
  console.log('链接失败: ', error.code, error.msg);
});

断开链接

断开当前用户的连接. 调用后将不再接收消息, 不可发送消息, 不可获取历史消息, 不可获取会话列表

代码示例:

im.disconnect().then(function() {
  console.log('断开链接成功');
});

重新链接

注意事项

  1. 当网络不可用时, SDK 内部会进行自动重连, 不需要主动调用此方法
  2. 一般此方法为主动断开链接后, 再次链接时调用

代码示例:

im.reconnect().then(function(user) {
  console.log('重新链接成功, 链接用户 id 为: ', user.id);
}).catch(function(error) {
  console.log('链接失败: ', error.code, error.msg);
});

切换用户

参数说明:

参数 类型 必填 说明 最低版本
token String 用户的唯一标识 3.0.0

代码示例:

var user = {
  token: 'mKmyKqTSf7aNDinwAFMnz7NXKI3dV3X0+Cd1BOxmtO2pmvsjW2HViWrePIfq0GuTu9jELQqsckv4AhfjCAKgQ=='
};
im.changeUser(user).then(function(user) {
  console.log('切换用户成功, 当前用户 id 为: ', user.id);
}).catch(function(error) {
  console.log('切换用户失败: ', error.code, error.msg);
});