引用回复
引用回复:IMKit 以组件 + 数据源/回调的方式提供 UI 能力;本页聚焦该功能在组件层的接入点与配置。
适用场景
- 需要在现成会话页/会话列表上扩展功能
- 需要确认功能对应的组件与 props/events
前置条件
- 已导入 ImpIaaSIMKit
- 已完成 IMLib 初始化与连接
- 宿主容器可挂载 UIView
rev28 契约状态
已实现 / 部分覆盖
rev28 已冻结 IMKit features 8 组件与 Swift/ObjC 绑定;本页覆盖信息托管/群管理/联系人/多选/转发/引用的契约接入,未覆盖的特别关注/搜索用户等仍按能力边界说明。
组件:QuoteBar
引用/回复输入条(展示被引用消息、取消引用)
| 契约项 | 内容 |
|---|---|
| Props | message:Message? onCancel:() |
| Events | quoteChanged(message?) |
| Behaviors | 设置引用后输入区展示原文摘要;发送时把 quote 写入 content;取消引用恢复普通输入 |
真实签名(bindings.ios.imkit.features)
| 语言 | 签名 |
|---|---|
| Swift | IMPQuoteBar(message: IMPMessage?) |
| Objective-C | - (instancetype)initWithMessage:(IMPOSMessage *)message; |
Swift 接入示例
Swift
let quoteBar = IMPQuoteBar(message: message)Objective-C 接入示例
Objective-C
IMPOSQuoteBar *quoteBar = [[IMPOSQuoteBar alloc] initWithMessage:nil];注入方式与回退策略
- 控制器只维护选择/转发/引用状态,不直接删除或发送消息;批量操作通过事件回调宿主。
- 多选:selectionChanged(ids)、requestDelete(ids)、requestForward(ids);宿主调用 IMLib 批量接口。
- 转发:selectConversation(conversation)、completed(result);合并转发使用 combineMessages + sendMessage。
- 引用:quoteChanged(message?);发送时把 quote 写入 content,取消引用恢复普通输入。
与融云对应页 / 差异
| 项 | 内容 |
|---|---|
| 融云页面 | ios-imkit/features/message-reference(引用回复) |
| 融云接口状态 | 部分覆盖(主路径可用,子能力缺失) |
| 我方对应 | QuoteBar、sendTextMessage(quote) |
| 差异说明 | rev27 引用条契约;发送 quote 由宿主写入 content |
相关错误码
| 错误码 | 名称 | 含义 | 处理 |
|---|---|---|---|
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 | 网络错误 | 可重试(退避) |