拦截消息
拦截消息：通过替换数据源/回调、注册自定义 Cell、调整主题令牌来定制 IMKit 的展示与交互。
适用场景
- 自定义消息类型与气泡样式
- 拦截/修改发送与接收流程
- 会话列表多选与批量操作
前置条件
- 已理解 IMKit 组件边界（只依赖 IMLib 公开协议）
- 宿主有自定义 Cell/菜单实现
接收前拦截扩展点
- IMLib 通过 MESSAGES 事件把入站消息交给宿主；可在更新 UI/落库前执行过滤（丢弃、替换、审核标记）。
- 监听方式：client.addEventListener(.messages, listener:) / 或在主进程事件回调中处理；拦截结果由宿主决定，SDK 不提供 willReceiveMessage 同名协议。
- 差异：融云 RCIMMessageInterceptor / RCIMReceiveMessageDelegate 是 IMKit 层协议；我方以事件 + 宿主扩展点实现，缺少“同步返回是否接收”的钩子（能力边界）。
- 实现建议：在 MESSAGES 回调中先做敏感词/黑名单判断，再决定是否写入本地库与刷新 UI；被丢弃的消息记录审计日志便于追溯。
- 扩展点约束：过滤必须幂等，避免同一 messageId 多次处理；不要在主线程做重活，必要时切后台队列。
与融云对应页 / 差异
| 项 | 内容 |
|---|---|
| 融云页面 | ios-imkit/customization/message-intercept（拦截消息） |
| 融云接口状态 | 能力缺失（写边界页） |
| 我方对应 | 无直接 op（见差异说明） |
| 差异说明 | 拦截消息：willReceiveMessage 钩子，宿主可替换/丢弃入站消息 |
能力缺口（如实标注）
融云该页描述的能力未完全在 IMLib 102 op / 16 事件中覆盖：拦截消息：willReceiveMessage 钩子，宿主可替换/丢弃入站消息。本页不提供伪造接口。
相关错误码
| 错误码 | 名称 | 含义 | 处理 |
|---|---|---|---|
1001 | INVALID_PARAMETER | 参数错误 | 修正参数/权限后重试 |
1002 | INVALID_TOKEN | Token 无效或已过期 | 修正参数/权限后重试 |
1007 | MESSAGE_TOO_LARGE | 消息体过大（上限 5KB） | 修正参数/权限后重试 |
1009 | GROUP_MUTED | 你已被禁言 | 修正参数/权限后重试 |
1010 | SENSITIVE_WORD | 内容包含敏感词 | 修正参数/权限后重试 |
3001 | SDK_NOT_CONNECTED | 长连接未就绪 | 可重试（退避） |
3002 | SDK_TIMEOUT | 请求超时 | 可重试（退避） |
3003 | SDK_NETWORK_ERROR | 网络错误 | 可重试（退避） |
接入检查
- 确认已导入
ImpIaaSIMKit并完成 IMLib 初始化/连接。 - 组件挂载到宿主 UIView 后，按契约注入数据（props/数据源）并注册事件。
- 自定义 Cell/菜单时保持消息模型为只读，避免直接修改 SDK 内部状态。