获取聊天室历史消息
开通服务
使用 loadChatRoomMessages
要求开通 聊天室消息云端存储服务。使用前请确认已开通服务。开通后聊天室历史消息保存在云端,默认保存 2 个月。
获取聊天室消息
- 获取聊天室远端历史记录。
- 此功能需要开通聊天室历史消息云存储
- 退出聊天室,会清除本地聊天室历史消息。
方法
int loadChatRoomMessages(
string targetId,
int timestamp,
RCIMTimeOrder order,
int count
)
参数说明
参数 | 类型 | 说明 |
---|---|---|
targetId | string | 聊 天室 ID |
timestamp | int | 起始的消息发送时间戳。 |
order | RCIMTimeOrder | 拉取顺序: RCIMTimeOrder.BEFORE降序, 按照时间戳从大到小; RCIMTimeOrder.AFTER升序, 按照时间戳从小到大 |
count | int | 要获取的消息数量,count 大于0,小于等于50 |
返回值
返回值 | 描述 |
---|---|
int | 当次接口操作状态码,并不代表最终操作结果,状态码详细信息 |
代码示例
int code = engine.loadChatRoomMessages(
targetId,
timestamp,
order,
count
);
回调方法
- onChatRoomMessagesLoaded
delegate void OnChatRoomMessagesLoadedDelegate(int code,
string targetId,
List<RCIMMessage> messages,
long syncTime);
OnChatRoomMessagesLoadedDelegate onChatRoomMessagesLoaded;
参数说明
参数 | 类型 | 说明 |
---|---|---|
code | int | 接口回调的状态码,0 代表成功,非 0 代表出现异常 |
targetId | string | 会话ID |
messages | List<[RCIMMessage]> | 加载到的消息 |
syncTime | string | 下次拉取的时间戳 |
代码示例
engine.onChatRoomMessagesLoaded = delegate(
int code,
string targetId,
List<RCIMMessage> messages,
int syncTime
)
{
}
[RCIMMessage]:https://www.rongcloud.cn/docs/api/unity/imlib_v5/latest/classcn__rongcloud__im__unity_1_1_r_c_i_m_message.html