跳到主要内容

删除会话

App 用户可能需要从会话列表中删除一个会话或多个会话，可以通过 SDK 删除会话功能实现。客户端的会话列表是根据本地消息生成的，删除会话操作指的是删除本地会话。

删除指定会话​

调用 removeConversation 可实现软删除的效果。该接口实际不会删除会话内的消息，仅将该会话项目从 SDK 的会话列表中移除。成功删除会话后，App 可以刷新 UI，不再向用户展示该会话项目。

BOOL success = [[RCIMClient sharedRCIMClient] removeConversation:ConversationType_PRIVATE
                                                        targetId:@"targetId"];
参数类型说明
conversationTypeRCConversationType会话类型，单聊传入 ConversationType_PRIVATE
targetIdNSString会话 id

如果会话内再来一条消息，该会话会重新出现在会话列表中，App 用户可查看会话内的历史消息和最新消息。

SDK 未提供同时删除指定会话项目和会话历史消息的接口。如果需要同时删除会话内的消息，您可以在删除指定会话时同时调用删除消息的接口。详见删除消息。

按会话类型删除会话​

App 用户可能需要清空某一类型的所有会话，例如清空所有群聊会话。SDK 支持按指定会话类型清空所有会话及会话信息，一次支持清空多个类型的会话。

BOOL success = [[RCIMClient sharedRCIMClient] clearConversations:@[@(ConversationType_PRIVATE),@(ConversationType_SYSTEM),@(ConversationType_GROUP)]];
参数类型说明
conversationTypeListNSArray会话类型的数组，需要将 RCConversationType 转为 NSNumber 构建 Array

删除全部会话​

SDK 内部没有清除全部会话的方法，如有需要可通过以下任一方式实现：

  • 如果 App 不涉及超级群业务，您可使用 按会话类型删除会话，传入所有会话类型。这种方式会清除本地消息。

  • 先获取会话列表，循环删除指定会话：

    NSArray *array = [[RCIMClient sharedRCIMClient] getConversationList:@[@(ConversationType_GROUP), @(ConversationType_PRIVATE)]];
    for (RCConversation *con in array) {
        [[RCIMClient sharedRCIMClient] removeConversation:con.conversationType targetId:con.targetId];
    }
最后于 更新