跳到主要内容

版本: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.onTokenIncorrectFunction是token 无效回调,建议排查 控制台 是否设置了 Token 有效期,或重新获取 Token 再建立连接2.0.0

代码示例​

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