输入区控制器(ChatInputController)
输入区控制器:ChatInputController 属于 ViewController(视图 / 生命周期 / 输入)。本页的 props / events / behaviors 来自 sdk-imkit.json → globalUIKit,声明与示例来自 bindings.ios.uikit,不手写漂移。
契约属性(props)
| 属性 | 类型 | 可选 | 说明 |
|---|---|---|---|
viewModel | ChatViewModel | 否 | 页面状态机(ChatListViewModel / ChatViewModel) |
options | {maxLength:int,showTyping:bool,mention:bool} | 是 | 页面选项(由契约声明的可选字段,例如搜索栏 / 网络横幅 / 历史 / 已读 / typing) |
事件(events)
| 事件 | 参数 | 说明 |
|---|---|---|
send | text | 发送文本 |
typing | Bool | 输入状态变化(true / false) |
heightChanged | CGFloat | 输入区高度变化(键盘避让) |
行为(behaviors)
- 草稿自动保存(防抖 500ms)
- 空内容禁用发送
- typing 节流(2s)
- @提及插入
- 发送失败保留输入并可重试
公开符号与声明
| 语言 | 声明 |
|---|---|
| Swift | IMPChatInputController(viewModel: IMPChatViewModel, options: IMPChatInputOptions?) |
| Objective-C | - (instancetype)initWithViewModel:(IMPOSGlobalChatViewModel *)viewModel options:(IMPOSGlobalChatInputOptions *)options; |
使用示例(Swift / Objective-C)
IMPChatInputController(viewModel: chatViewModel, options: nil)IMPOSGlobalChatInputController *chatInputController =
[[IMPOSGlobalChatInputController alloc] initWithViewModel:self.viewModel options:nil];示例口径
示例由绑定签名与契约类型生成:构造函数参数、协议方法、属性名均来自契约;实际业务中把示例变量替换为宿主实例即可。
在架构中的位置
| 项 | 值 |
|---|---|
| 层 | ViewController(视图 / 生命周期 / 输入) |
| 依赖 | GlobalUIKit -> IMKit -> IMLib(公开接口) |
| 相关组件 | ChatViewModel、ChatViewController |
错误处理
ViewModel 层通过事件上报错误(如 error(err));错误码与处理建议见 Global IM UIKit 错误处理、状态码(运行时 43 条)与 状态码全量对照(440 条)。