连接服务
功能描述
连接融云服务器之前,需要 App Server 通过融云 Server API 获取 Token,客户端获取到这个 Token 即可连接融云服务器。
危险
- 连接方法必须在执行初始化之后调用。详见初始化文档。
- 连接方法必须在设置状态监听器和消息监听器之后调用。详见设置监听文档。
- 除初始化、监听以外, 所有方法都必须在connect 成功之后再调用
- 默认一个用户只支持一个页面连接, 开通 多设备消息同步 即可支持多页面连接
参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
token | String | 是 | 用户的唯一标识 | 2.0.0 |
callback | Object | 是 | 重连回调对象 | 2.0.0 |
callBack.onSuccess | Function | 是 | 连接成功回调,会返回 token 对应的 userId | 2.0.0 |
callBack.onError | Function | 是 | 连接失败回调,请您检查客户端初始化使用的 AppKey 和获取 token 用的 AppKey 是否一致 | 2.0.0 |
callBack.onTokenIncorrect | Function | 是 | token 无效回调,建议排查 控制台 是否设置了 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);
}
});