跳到主要内容

加入聊天室

默认同一用户不能同时加入多个聊天室,加入新的聊天室后,会自动退出之前的聊天室。

如需支持单个用户加入多个聊天室,请在控制台打开该配置,详见聊天室服务配置

加入聊天室

方法

TypeScript

joinChatRoom(
targetId: string,
messageCount: number,
autoCreate: boolean,
callback: IRCIMIWJoinChatRoomCallback
): Promise<number>;

参数说明

参数名参数类型描述
targetIdstring聊天室会话 ID
messageCountnumber进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50
autoCreateboolean是否创建聊天室,TRUE 如果聊天室不存在,sdk 会创建聊天室并加入,如果已存在,则直接加入
callbackIRCIMIWJoinChatRoomCallback接口调用结果回调。

返回值

返回值描述
number当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

代码示例

TypeScript

const callback = {
onChatRoomJoined: (code: number, targetId: string) => {
//...
},
};
let code = await engine.joinChatRoom(targetId, messageCount, autoCreate, callback);

  • SDK 提供聊天室重连机制,待链接状态恢复后,如果曾经加入过聊天室,没有退出,则重新加入聊天室。