会话页面

会话页面：会话列表、会话页、输入区与页面事件监听是 IMKit 的四类核心能力；本页给出组件组合与事件流。

适用场景​

  • 从零搭出会话列表/会话页
  • 拦截页面事件做埋点或自定义导航
  • 按类型聚合会话

前置条件​

  • 已导入 ImpIaaSIMKit
  • IMLib 已连接
  • 宿主有路由与页面容器

对应 IMKit 组件​

该主题由 ChatView 组件承载（会话详情（消息流 + 输入区））。

契约项内容
PropsconversationType targetId messages currentUserId hasMore showReadCount? onReactionClick? onReactionLongPress?
EventsloadMore sendText sendImage sendFile sendVoice sendLocation recall resend
Behaviors倒序渲染（最新在底部）；新消息到达自动滚底（用户上翻时给出“有新消息”提示）；按 messageId 去重；本地先显示 pending 气泡，ack 后替换为服务端消息；时间分隔：同一会话间隔 >5 分钟显示时间条；撤回消息渲染为占位文案“消息已撤回”，不显示原文；引用消息渲染引用块；@提及在文本中高亮；已读回执：发送者可见已读人数/状态（群聊按 readCounts/totalMembers）；翻页加载历史，beforeSeq 游标，hasMore=false 时显示“没有更多”；向每个消息气泡透传 message.reactions / message.expansion，并转发 onReactionClick / onReactionLongPress（setMessages / appendMessages / 宿主变更消息后始终取最新值）

Swift / Objective-C 接入​

// ChatView：会话页面
let conversationView = ChatView(frame: .zero)
conversationView.frame = container.bounds
container.addSubview(conversationView)
// 数据/回调见组件 API：/docs/ios-imkit/components/chat-view

该组件的 Objective-C 入口没有可解析的初始化选择器（绑定声明是说明文本，不是可编译代码），因此不展示 Objective-C 代码块；按下面接入表使用；组件页提供 Objective-C 接入表（helper 组件为 Swift 专用，无独立 ObjC 示例）。

项值
Objective-C 类未导出独立类（使用协议/渲染器）
初始化选择器initWithConversationType:targetId:
接入方式按 ChatView 组件页 的 Objective-C 接入表与渲染器约定接入
组件边界

IMKit 只依赖 IMLib 公开协议与模型；不得在组件层直连传输/存储实现。宿主负责页面导航与权限。

与融云对应页 / 差异​

项内容
融云页面ios-imkit/key-functions/conversation（会话页面）
融云接口状态部分覆盖（主路径可用，子能力缺失）
我方对应ChatView、ChatViewController、MessageBubble
差异说明聊天页骨架/历史分页/已读/撤回可用；缺标题栏定制、默认拉取条数配置、隐藏头像昵称开关

相关错误码​

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

接入检查​

  • 确认已导入 ImpIaaSIMKit 并完成 IMLib 初始化/连接。
  • 组件挂载到宿主 UIView 后，按契约注入数据（props/数据源）并注册事件。
  • 自定义 Cell/菜单时保持消息模型为只读，避免直接修改 SDK 内部状态。

相关页面​