Emoji 与贴纸表情

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

适用场景​

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

前置条件​

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

对应 IMKit 组件​

该主题由 MessageInput 组件承载（输入区）。

契约项内容
Propsdraft disabled muted mentionCandidates? maxLength?
Eventssend typing pickImage pickFile startRecord pickLocation draftChanged
Behaviors输入时 500ms 防抖触发 typing(true)，3s 无输入触发 typing(false)；被禁言（muted=true）禁用发送并提示；仍可查看；草稿自动保存（IMLib.saveTextMessageDraft），发送成功后清空；群聊支持 @ 选择器（全员/指定成员），生成 mentionedInfo

Swift / Objective-C 接入​

// MessageInput：Emoji 与贴纸表情
let emoticonView = MessageInputView(frame: .zero)
emoticonView.frame = container.bounds
container.addSubview(emoticonView)
// 数据/回调见组件 API：/docs/ios-imkit/components/message-input

该组件的 Objective-C 入口没有可解析的初始化选择器（绑定声明是说明文本，不是可编译代码），因此不展示 Objective-C 代码块；按下面接入表使用；组件页提供 Objective-C 接入表（helper 组件为 Swift 专用，无独立 ObjC 示例）。

项值
Objective-C 类未导出独立类（使用协议/渲染器）
初始化选择器—
接入方式按 MessageInput 组件页 的 Objective-C 接入表与渲染器约定接入
组件边界

IMKit 只依赖 IMLib 公开协议与模型；不得在组件层直连传输/存储实现。宿主负责页面导航与权限。

与融云对应页 / 差异​

项内容
融云页面ios-imkit/features/emoticon（Emoji 与贴纸表情）
融云接口状态能力缺失（写边界页）
我方对应无直接 op（见差异说明）
差异说明Emoji 面板与贴纸消息（内置表情、贴纸包、GIF 表情）
能力缺口（如实标注）

融云该页描述的能力未完全在 IMLib 102 op / 16 事件中覆盖：Emoji 面板与贴纸消息（内置表情、贴纸包、GIF 表情）。本页不提供伪造接口。

相关错误码​

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

接入检查​

  • 确认已导入 ImpIaaSIMKit 并完成 IMLib 初始化/连接。
  • 组件挂载到宿主 UIView 后，按契约注入数据（props/数据源）并注册事件。
  • 自定义 Cell/菜单时保持消息模型为只读，避免直接修改 SDK 内部状态。

相关页面​