跳到主要内容

版本:2.X

连接服务

功能描述

连接融云服务器之前,需要 App Server 通过融云 Server API 获取 Token,客户端获取到这个 Token 即可连接融云服务器。

危险
  1. 连接方法必须在执行初始化之后调用。详见初始化文档。
  2. 连接方法必须在设置状态监听器和消息监听器之后调用。详见设置监听文档。
  3. 除初始化、监听以外, 所有方法都必须在connect 成功之后再调用.
  4. 默认一个用户只支持一个页面连接, 开通 多设备消息同步 即可支持多页面连接.

参数说明

参数类型必填说明最低版本
tokenString用户的唯一标识2.0.0
callbackObject重连回调对象2.0.0
callBack.onSuccessFunction连接成功回调,会返回 token 对应的 userId2.0.0
callBack.onErrorFunction连接失败回调,请您检查客户端初始化使用的 AppKey 和获取 token 用的 AppKey 是否一致2.0.0
callBack.onTokenIncorrectFunctiontoken 无效回调,建议排查 控制台 是否设置了 Token 有效期,或重新获取 Token 再建立连接2.0.0

代码示例

RongIMClient.connect('<Your-Token>', {
onSuccess: function(userId) {
console.log('连接成功, 用户 ID 为', userId);
// 连接已成功, 此时可通过 getConversationList 获取会话列表并展示
},
onTokenIncorrect: function() {
console.log('连接失败, 失败原因: token 无效');
},
onError: function(errorCode) {
console.log('连接失败, 失败原因: ', errorCode);
}
});