跳到主要内容

获取聊天室历史消息

开通服务

使用 loadChatRoomMessages 要求开通 聊天室消息云端存储服务。使用前请确认已开通服务。开通后聊天室历史消息保存在云端,默认保存 2 个月。

获取聊天室消息

  • 获取聊天室远端历史记录。
  • 此功能需要开通聊天室历史消息云存储
  • 退出聊天室,会清除本地聊天室历史消息。

方法

int loadChatRoomMessages(
string targetId,
int timestamp,
RCIMTimeOrder order,
int count
)

参数说明

参数类型说明
targetIdstring聊天室 ID
timestampint起始的消息发送时间戳。
orderRCIMTimeOrder拉取顺序:
RCIMTimeOrder.BEFORE降序, 按照时间戳从大到小;
RCIMTimeOrder.AFTER升序, 按照时间戳从小到大
countint要获取的消息数量,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;

参数说明

参数类型说明
codeint接口回调的状态码,0 代表成功,非 0 代表出现异常
targetIdstring会话ID
messagesList<[RCIMMessage]>加载到的消息
syncTimestring下次拉取的时间戳

代码示例

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