聊天室

提示

聊天室消息不会保存到本地数据库,服务端最多保存聊天室最近的50条消息。在调用加入聊天室接口时可以设置进入聊天室时的拉取消息数量。

加入聊天室

参数说明:

参数 类型 必填 说明
chatRoomId String 聊天室 Id
defMessageCount int 进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50 条
callback OperationCallback 状态回调

代码示例:

public void joinChatRoom(final String chatRoomId, final int defMessageCount, final OperationCallback callback)
加入已经存在的聊天室

参数说明:

参数 类型 必填 说明
chatRoomId String 聊天室 Id
defMessageCount int 进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50 条
callback OperationCallback 状态回调

代码示例:

public void joinExistChatRoom(final String chatRoomId, final int defMessageCount, final OperationCallback callback)

提示

  1. joinChatRoom 方法加入聊天室。聊天室不存在,sdk 会创建聊天室并加入,已存在,则直接加入。
  2. joinExistChatRoom 方法加入已存在的聊天室。聊天室不存在,则加入失败。

退出聊天室

参数说明:

参数 类型 必填 说明
chatRoomId String 聊天室 Id
callback OperationCallback 状态回调

代码示例:

public void quitChatRoom(final String chatRoomId, final OperationCallback callback)
查询聊天室信息

参数说明:

参数 类型 必填 说明
chatRoomId String 聊天室 Id
defMessageCount int 进入聊天室拉成员数目,最多 20 条
order ChatRoomInfo.ChatRoomMemberOrder 聊天室成员信息顺序。升序, 返回最早加入的用户列表; 降序, 返回最晚加入的用户列表
callback OperationCallback 状态回调

代码示例:

public void getChatRoomInfo(final String chatRoomId, final int defMemberCount, final ChatRoomInfo.ChatRoomMemberOrder order, final ResultCallback<ChatRoomInfo> callback)
获取服务器聊天室历史消息

提示

此方法从服务器端获取聊天室之前的历史消息,但是必须先开通聊天室消息云存储功能。

参数说明:

参数 类型 必填 说明
targetId String 目标 Id。根据不同的 conversationType,可能是用户 Id、群组 Id
recordTime long 起始的消息发送时间戳,单位: 毫秒
count int 返回聊天室成员信息顺序。升序, 最早加入的用户列表; 降序, 返回最晚加入的用户列表
order TimestampOrder 拉取顺序: 降序, 时间戳从大到小排序; 升序, 按照时间戳从小到大排序
callback OperationCallback 状态回调

代码示例:

public void getChatroomHistoryMessages(final String targetId, final long recordTime, final int count, final TimestampOrder order, final IRongCallback.IChatRoomHistoryMessageCallback callback)