会话列表多选模式

会话列表多选模式：通过替换数据源/回调、注册自定义 Cell、调整主题令牌来定制 IMKit 的展示与交互。

适用场景​

  • 自定义消息类型与气泡样式
  • 拦截/修改发送与接收流程
  • 会话列表多选与批量操作

前置条件​

  • 已理解 IMKit 组件边界（只依赖 IMLib 公开协议）
  • 宿主有自定义 Cell/菜单实现

对应 Global UIKit 组件​

由 ChatListViewController 承载：会话列表页（列表/搜索/连接态/空态/骨架）

契约项内容
PropsviewModel theme delegate options?
Eventsselect longpress refresh tapSearch
Behaviors绑定 ViewModel 状态：loading/empty/error/loaded；未读角标与 @ 角标；连接状态横幅（连接中/断开/重连）；下拉刷新；点击会话回调宿主路由（不自行 push）；deinit 取消订阅

Swift / Objective-C 接入​

// ios-imkit/uikit/customization/select-multiple-from-chat-list
let listController = IMPChatListViewController(viewModel: chatListViewModel, theme: .light, delegate: nil, options: nil)
navigationController.pushViewController(listController, animated: true)
IMPOSGlobalChatListViewController *controller = [[IMPOSGlobalChatListViewController alloc] initWithViewModel:self.viewModel theme:self.theme delegate:nil options:nil];
[self.navigationController pushViewController:controller animated:YES];
MVVM 边界

GlobalUIKit → IMKit → IMLib（公开接口）；ViewController 不直连网络，Delegate 只回调、导航由宿主或 ChatRouter 完成。

与融云对应页 / 差异​

项内容
融云页面ios-im-uikit/customization/select-multiple-from-chat-list（会话列表多选模式）
融云接口状态能力缺失（写边界页）
我方对应无直接 op（见差异说明）
差异说明会话列表多选模式（批量删除/标记已读）
能力缺口（如实标注）

融云该页描述的能力未完全在 IMLib 102 op / 16 事件中覆盖：会话列表多选模式（批量删除/标记已读）。本页不提供伪造接口。

相关错误码​

错误码名称含义处理
1001INVALID_PARAMETER参数错误修正参数/权限后重试
1002INVALID_TOKENToken 无效或已过期修正参数/权限后重试
1007MESSAGE_TOO_LARGE消息体过大（上限 5KB）修正参数/权限后重试
1009GROUP_MUTED你已被禁言修正参数/权限后重试
1010SENSITIVE_WORD内容包含敏感词修正参数/权限后重试
3001SDK_NOT_CONNECTED长连接未就绪可重试（退避）
3002SDK_TIMEOUT请求超时可重试（退避）
3003SDK_NETWORK_ERROR网络错误可重试（退避）

排查建议​

  • 继承/组合 Global UIKit 时先确认主题与 Dynamic Type 未被硬编码覆盖。
  • DataSource/Delegate 回调在主线程；UI 更新不要跨线程。
  • 自定义 Cell 通过 ChatCellModel 渲染，不要绕过 ViewModel 直接读数据库。

相关页面​