文档导航
Flutter
SDK 版本:  5.X

加入聊天室

更新时间:2024-02-23 PDF

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

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

加入聊天室

方法

Future<int> joinChatRoom(String targetId, int messageCount, bool autoCreate, {IRCIMIWJoinChatRoomCallback? callback});
              
已复制
1

参数说明

参数名 参数类型 描述
targetId String 聊天室会话 ID
messageCount int 进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50
autoCreate bool 是否创建聊天室,TRUE 如果聊天室不存在,sdk 会创建聊天室并加入,如果已存在,则直接加入
callback IRCIMIWJoinChatRoomCallback 事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

返回值

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

代码示例

IRCIMIWJoinChatRoomCallback? callback = IRCIMIWJoinChatRoomCallback(onChatRoomJoined: (int? code, String? targetId) {
//...
});

int? ret = await engine?.joinChatRoom(targetId, messageCount, autoCreate, callback:callback);
              
已复制
1
2
3
4
5

回调方法

  • onChatRoomJoined
Function(int? code, String? targetId)? onChatRoomJoined;
              
已复制
1

参数说明

参数名 参数类型 描述
code int 接口回调的状态码,0 代表成功,非 0 代表出现异常
targetId String 会话 ID

代码示例

engine?.onChatRoomJoined = (int? code, String? targetId) {
//...
};
              
已复制
1
2
3

  • onChatRoomJoining

正在加入聊天室的回调

Function(String? targetId)? onChatRoomJoining;
              
已复制
1

参数说明

参数名 参数类型 描述
targetId String 聊天室 ID

代码示例

engine?.onChatRoomJoining = (String? targetId) {
//...
};
              
已复制
1
2
3

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

您的改进建议

意见反馈

问题类型

联系我们

提交工单

技术支持|集成使用|产品方案


商务咨询

7 x 24 小时

为您解答方案与报价问题

131 6185 6839

文档反馈