消息上下文菜单

消息上下文菜单：通过替换数据源/回调、注册自定义 Cell、调整主题令牌来定制 IMKit 的展示与交互。

适用场景​

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

前置条件​

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

对应 Global UIKit 组件​

由 ChatDelegate 承载：聊天页交互回调协议

契约项内容
Props—
EventsdidTapAvatar didTapMessage didRequestReadDetail didRequestResend
Behaviors宿主负责头像/详情/重发 UI；失败重试走 ViewModel

Swift / Objective-C 接入​

// ios-imkit/uikit/customization/message-long-press
let chatController = IMPChatViewController(viewModel: chatViewModel, theme: .light, delegate: nil, options: nil)
navigationController.pushViewController(chatController, animated: true)

该组件在 Objective-C 侧没有可解析的初始化选择器（或属于协议/渲染模型），不展示 Objective-C 代码块；按组件页的 ObjC 声明接入。

项值
Objective-C 类IMPOSGlobalChatDelegate
初始化选择器—
接入方式见 ChatDelegate 组件页 的 ObjC 声明
MVVM 边界

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

与融云对应页 / 差异​

项内容
融云页面ios-im-uikit/customization/message-long-press（消息上下文菜单）
融云接口状态部分覆盖（主路径可用，子能力缺失）
我方对应ChatDelegate(longpress/reaction_longpress)
差异说明长按回调有；缺上下文菜单项动态配置（复制/转发/删除/引用/回应组合）

相关错误码​

错误码名称含义处理
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 直接读数据库。

相关页面​