转发消息

转发消息：IMKit 以组件 + 数据源/回调的方式提供 UI 能力；本页聚焦该功能在组件层的接入点与配置。

适用场景​

  • 需要在现成会话页/会话列表上扩展功能
  • 需要确认功能对应的组件与 props/events

前置条件​

  • 已导入 ImpIaaSIMKit
  • 已完成 IMLib 初始化与连接
  • 宿主容器可挂载 UIView

rev28 契约状态​

已实现 / 部分覆盖

rev28 已冻结 IMKit features 8 组件与 Swift/ObjC 绑定；本页覆盖信息托管/群管理/联系人/多选/转发/引用的契约接入，未覆盖的特别关注/搜索用户等仍按能力边界说明。

组件：MessageForwardController​

消息转发选择器（单条/合并转发）

契约项内容
Propsmessages:[Message] mode:single|combine
EventsselectConversation(conversation) completed(result)
Behaviors单条转发用 sendMessage 原文；合并转发用 combineMessages + sendMessage；转发结果回调成功/失败，失败保留草稿

真实签名（bindings.ios.imkit.features）​

语言签名
SwiftIMPMessageForwardController(messages: [IMPMessage], mode: IMPForwardMode)
Objective-C- (instancetype)initWithMessages:(NSArray<IMPOSMessage *> *)messages mode:(IMPOSForwardMode)mode;

Swift 接入示例​

Swift
let forward = IMPMessageForwardController(messages: [message], mode: .single)

Objective-C 接入示例​

Objective-C
IMPOSMessageForwardController *forward = [[IMPOSMessageForwardController alloc] initWithMessages:@[] mode:IMPOSForwardModeSingle];

注入方式与回退策略​

  • 控制器只维护选择/转发/引用状态，不直接删除或发送消息；批量操作通过事件回调宿主。
  • 多选：selectionChanged(ids)、requestDelete(ids)、requestForward(ids)；宿主调用 IMLib 批量接口。
  • 转发：selectConversation(conversation)、completed(result)；合并转发使用 combineMessages + sendMessage。
  • 引用：quoteChanged(message?)；发送时把 quote 写入 content，取消引用恢复普通输入。

与融云对应页 / 差异​

项内容
融云页面ios-imkit/features/message-forward（转发消息）
融云接口状态部分覆盖（主路径可用，子能力缺失）
我方对应MessageForwardController、combineMessages、CONTENT_TYPE_COMBINE
差异说明rev27 转发控制器契约；单条/合并转发动作由宿主 sendMessage/combineMessages 完成

相关错误码​

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

相关页面​