跳转至

会话操作

获取会话

提示

返回的会话列表按照时间从前往后排列,如果有置顶的会话,则置顶的会话会排列在前面。

全量获取

参数 类型 说明
conversationTypeList NSArray 会话类型的数组(需要将 RCConversationType 转为 NSNumber 构建 Array)
返回值 NSArray 返回会话 RCConversation 的列表
- (NSArray *)getConversationList:(NSArray *)conversationTypeList;

分页获取

参数 类型 说明
conversationTypeList NSArray 会话类型的数组(需要将 RCConversationType 转为 NSNumber 构建 Array)
count int 获取的数量
startTime long long 会话的时间戳(获取这个时间戳之前的会话列表,0 表示从最新开始获取)
返回值 NSArray 会话 RCConversation 的列表
- (NSArray *)getConversationList:(NSArray *)conversationTypeList count:(int)count startTime:(long long)startTime;

置顶会话

提示

置顶设置只保存在本地数据库中,不会同步到服务端和其他设备。

设置

参数 类型 说明
conversationType RCConversationType 会话类型
targetId NSString 会话目标 Id
isTop BOOL 是否置顶
返回值 BOOL 设置是否成功
- (BOOL)setConversationToTop:(RCConversationType)conversationType
                    targetId:(NSString *)targetId
                       isTop:(BOOL)isTop;

获取

参数 类型 说明
conversationTypeList NSArray 话类型的数组(需要将 RCConversationType 转为 NSNumber构建 Array)
返回值 NSArray 置顶的会话 RCConversation 的列表
- (NSArray<RCConversation *> *)getTopConversationList:(NSArray *)conversationTypeList;

搜索会话

参数 类型 说明
conversationTypeList NSArray 话类型的数组(需要将 RCConversationType 转为 NSNumber构建 Array)
objectNameList NSArray 需要搜索的消息类型名列表(即每个消息类方法 getObjectName 的返回值)
keyword NSString 关键字
返回值 RCSearchConversationResult 匹配的会话搜索结果列表
- (NSArray<RCSearchConversationResult *> *)searchConversations:(NSArray<NSNumber *> *)conversationTypeList
                                                   messageType:(NSArray<NSString *> *)objectNameList
                                                       keyword:(NSString *)keyword;

删除会话

按 Id 删除

参数 类型 说明
conversationType RCConversationType 会话类型
targetId NSString 会话目标 Id
isTop BOOL 是否置顶
返回值 BOOL 设置是否成功
- (BOOL)removeConversation:(RCConversationType)conversationType
				  targetId:(NSString *)targetId;

按类型删除

参数 类型 说明
conversationTypeList NSArray 话类型的数组(需要将 RCConversationType 转为 NSNumber构建 Array)
返回值 BOOL 置顶的会话 RCConversation 的列表
- (BOOL)clearConversations:(NSArray *)conversationTypeList;