功能概述

功能概述：IMKit 以组件 + 数据源/回调的方式提供 UI 能力；本页聚焦该功能在组件层的接入点与配置。

适用场景​

  • 需要在现成会话页/会话列表上扩展功能
  • 需要确认功能对应的组件与 props/events

前置条件​

  • 已导入 ImpIaaSIMKit
  • 已完成 IMLib 初始化与连接
  • 宿主容器可挂载 UIView

对应 Global UIKit 组件​

由 ChatListViewModel 承载：会话列表状态机

契约项内容
Propsclient dataSource options?
EventsstateChanged error
Behaviorsload/refresh/loadMore 幂等；合并 CONVERSATION 事件增量；会话排序（置顶优先，其余 updatedAt 倒序）；错误重试与空态

Swift / Objective-C 接入​

// 声明：IMPChatListViewModel(client: IMPClient, dataSource: IMPChatListDataSource?, options: IMPChatListViewModelOptions?)
let overviewChatListViewModel = IMPChatListViewModel(client: client, dataSource: nil, options: nil)
// 由宿主持有并注入 ViewController
IMPOSGlobalChatListViewModel *controller = [[IMPOSGlobalChatListViewModel alloc] initWithClient:client dataSource:self.dataSource options:nil];
// 由宿主 ViewController 持有并注入数据
MVVM 边界

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

与融云对应页 / 差异​

项内容
融云页面ios-im-uikit/features/overview（功能概述）
融云接口状态边界页（非接口页）
我方对应无直接 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 直接读数据库。

相关页面​