群组概述

群组概述：用户资料、在线状态与群组概览属于账号/资料域；IMLib 提供查询与订阅，IMKit 提供展示组件。

适用场景​

  • 展示用户昵称/头像/在线状态
  • 群组概览与成员入口
  • 资料变更后的界面刷新

前置条件​

  • IMLib 已连接
  • 已拿到 userId/groupId
  • 宿主有资料页容器

对应 Global UIKit 组件​

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

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

Swift / Objective-C 接入​

// 声明：IMPChatListViewModel(client: IMPClient, dataSource: IMPChatListDataSource?, options: IMPChatListViewModelOptions?)
let groupoverviewChatListViewModel = 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/user/group-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 直接读数据库。

相关页面​