跳到主要内容

获取会话

客户端 SDK 会根据收发的消息在本地数据库中生成对应会话。您可以从本地数据库获取 SDK 生成的会话列表。

获取会话列表

通过以下接口分页获取 SDK 在本地数据库生成的会话列表。获取到的会话列表按照时间倒序排列,置顶会话会排在最前。

方法

getConversations(
conversationTypes: Array<RCIMIWConversationType>,
channelId: string,
startTime: number,
count: number,
callback: IRCIMIWGetConversationsCallback
): Promise<number>;

参数说明

参数名参数类型描述
conversationTypesArray<RCIMIWConversationType>会话类型
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可
startTimenumber时间戳(毫秒),获取小于此时间戳的会话,传 0 为查询最新数据。在分页获取会话时,传入回调结果中最后一条会话数据的 operationTime,来获取下一页数据。
countnumber查询的数量, 0 < count ≤ 50
callbackIRCIMIWGetConversationsCallback获取会话列表事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

返回值

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

代码示例

let callback = {
onSuccess:(res) => {
//...
},
onError:(res) => {
//...
}};
let code = await engine.getConversations(conversationTypes, channelId, startTime, count, callback);

回调方法

  • setOnConversationsLoadedListener

获取会话列表的结果回调

setOnConversationsLoadedListener(listener?: ({code, conversationTypes, channelId, startTime, count, conversations}) => void): void;

参数说明

参数名参数类型描述
codenumber接口回调的状态码,0 代表成功,非 0 代表出现异常
conversationTypesArray<RCIMIWConversationType>会话类型集合
channelIdstring频道 ID,仅支持超级群使用,
startTimenumber时间戳(毫秒)
countnumber查询的数量
conversationsArray<RCIMIWConversation>查询到的会话集合

代码示例

engine.setOnConversationsLoadedListener((res) => {
//...
});

获取指定会话

获取某个会话的详细信息。

方法

getConversation(
type: RCIMIWConversationType,
targetId: string,
channelId: string,
callback: IRCIMIWGetConversationCallback
): Promise<number>;

参数说明

参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可
callbackIRCIMIWGetConversationCallback获取会话事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

返回值

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

代码示例

let callback = {
onSuccess:(res) => {
//...
},
onError:(res) => {
//...
}};
let code = await engine.getConversation(type, targetId, channelId, callback);

回调方法

  • setOnConversationLoadedListener
setOnConversationLoadedListener(listener?: ({code, type, targetId, channelId, conversation}) => void): void;

参数说明

参数名参数类型描述
codenumber接口回调的状态码,0 代表成功,非 0 代表出现异常
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
conversationRCIMIWConversation获取到的会话

代码示例

engine.setOnConversationLoadedListener((res) => {
//...
});

常见问题

Q1: 当用户卸载重新安装后发现会话列表为空或者部分会话丢失 A1: 由于会话列表是从本地数据库获取的, 是在 SDK 内部数据库存储的,所以当用户在卸载的时候会删除本地数据库,导致重新安装后会话列表为空,而会出现部分会话的原因是因为开启了 离线消息补偿 功能,具体操作是在后台购买 多设备消息同步 功能,这个功能里默认涵盖了今天(当天 0 点)的离线消息补偿,所以当用户在新设备登陆会触发离线消息补偿功能,从而获取到部分会话,造成部分会话丢失的错觉。如果想要更多天的离线消息补偿,可 提交工单 修改,最多支持 7 天,设置时间过长,当单用户消息量超大时,可能会因为补偿消息量过大,造成端上处理压力的问题