输入区控制器(ChatInputController)

输入区控制器:ChatInputController 属于 ViewController(视图 / 生命周期 / 输入)。本页的 props / events / behaviors 来自 sdk-imkit.json → globalUIKit,声明与示例来自 bindings.ios.uikit,不手写漂移。

契约属性(props)​

属性类型可选说明
viewModelChatViewModel否页面状态机(ChatListViewModel / ChatViewModel)
options{maxLength:int,showTyping:bool,mention:bool}是页面选项(由契约声明的可选字段,例如搜索栏 / 网络横幅 / 历史 / 已读 / typing)

事件(events)​

事件参数说明
sendtext发送文本
typingBool输入状态变化(true / false)
heightChangedCGFloat输入区高度变化(键盘避让)

行为(behaviors)​

  • 草稿自动保存(防抖 500ms)
  • 空内容禁用发送
  • typing 节流(2s)
  • @提及插入
  • 发送失败保留输入并可重试

公开符号与声明​

语言声明
SwiftIMPChatInputController(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 条)。

相关文档​