删除消息
删除消息:IMKit 以组件 + 数据源/回调的方式提供 UI 能力;本页聚焦该功能在组件层的接入点与配置。
适用场景
- 需要在现成会话页/会话列表上扩展功能
- 需要确认功能对应的组件与 props/events
前置条件
- 已导入 ImpIaaSIMKit
- 已完成 IMLib 初始化与连接
- 宿主容器可挂载 UIView
对应 Global UIKit 组件
由 ChatCellModel 承载:消息渲染模型
| 契约项 | 内容 |
|---|---|
| Props | message showTime showAvatar readCount sendState |
| Events | — |
| Behaviors | 时间分隔规则(5 分钟);发送状态图标(发送中/成功/失败);群已读计数(n/m);撤回占位;自定义类型降级展示 |
Swift / Objective-C 接入
Objective-C 示例已隐藏(含未导出符号)
该示例引用了 SDK 头文件未导出的符号(多为 Swift 专用 helper)。请使用下表真实 ObjC 类,或参考对应组件页的 Objective-C 接入说明。
| 可用 ObjC 类 | 用途 |
|---|---|
IMPOSClient | IMLib 客户端(连接、消息、会话、群组等) |
IMPOSChatViewController | IMKit 会话页(真实 ObjC 类) |
IMPOSConversationListViewController | IMKit 会话列表页(真实 ObjC 类) |
IMPOSGlobalChatViewController | Global UIKit 会话页(真实 ObjC 类) |
IMPOSGlobalChatListViewController | Global UIKit 会话列表页(真实 ObjC 类) |
// ios-imkit/uikit/features/message-delete
let deleteCellModel = IMPChatCellModel(message: message, showTime: true, showAvatar: true, readCount: nil, sendState: .sent)
print(deleteCellModel)MVVM 边界
GlobalUIKit → IMKit → IMLib(公开接口);ViewController 不直连网络,Delegate 只回调、导航由宿主或 ChatRouter 完成。
与融云对应页 / 差异
| 项 | 内容 |
|---|---|
| 融云页面 | ios-im-uikit/features/message-delete(删除消息) |
| 融云接口状态 | 能力缺失(写边界页) |
| 我方对应 | 无直接 op(见差异说明) |
| 差异说明 | 删除消息(本地/远端)与 UI 入口 |
能力缺口(如实标注)
融云该页描述的能力未完全在 IMLib 102 op / 16 事件中覆盖:删除消息(本地/远端)与 UI 入口。本页不提供伪造接口。
相关错误码
| 错误码 | 名称 | 含义 | 处理 |
|---|---|---|---|
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 | 网络错误 | 可重试(退避) |
排查建议
- 继承/组合 Global UIKit 时先确认主题与 Dynamic Type 未被硬编码覆盖。
- DataSource/Delegate 回调在主线程;UI 更新不要跨线程。
- 自定义 Cell 通过 ChatCellModel 渲染,不要绕过 ViewModel 直接读数据库。