输入状态
发送“正在输入”状态,默认 5 秒自动过期;适用于单聊与群聊。
平台调用风格
异步风格:Future<RcResult<T>>;错误码在 res.code,不使用异常表达业务失败。
接口一览
| 操作 | 语义 | 传输 | 返回 |
|---|---|---|---|
sendTypingStatus | 发送正在输入状态;不持久化;对端触发 TYPING 事件。 | WS 长连接 | null |
本页 1 个操作,其中 1 个在本平台绑定中声明了方法签名。
跨端方法名
| 操作 | Android | Web | Electron | macOS | Flutter | Native (C ABI) | iOS |
|---|---|---|---|---|---|---|---|
sendTypingStatus | sendTypingStatus | sendTypingStatus | sendTypingStatus | sendTypingStatus | sendTypingStatus | — | func |
方法名在 GA 平台之间保持一致(规则 A);Native C ABI 只覆盖部分操作,其余操作以 — 标注。
sendTypingStatus
发送正在输入状态;不持久化;对端触发 TYPING 事件。
sendTypingStatus(int conversationType, String targetId, bool typing)参数
| 参数 | 类型 | 说明 |
|---|---|---|
conversationType | ConversationType | 必填;会话类型枚举(ConversationType) |
targetId | string | 必填;目标会话 ID:单聊为对方 userId,群聊为 groupId,聊天室为 chatroomId |
typing | bool | 必填;是否正在输入(true/false) |
返回
null 无返回数据;成功与否通过错误码判断
示例
Dart
await engine.sendTypingStatus(1, 'user2', true);错误码
| 错误码 | 名称 | 分类 | HTTP | 可重试 | 说明 |
|---|---|---|---|---|---|
1004 | USER_NOT_FOUND | 客户端 / 参数 / 权限 | 404 | 否 | 用户不存在 |
1005 | GROUP_NOT_FOUND | 客户端 / 参数 / 权限 | 404 | 否 | 群组不存在 |
1006 | NOT_GROUP_MEMBER | 客户端 / 参数 / 权限 | 403 | 否 | 未加入群组 |
1008 | RATE_LIMITED | 客户端 / 参数 / 权限 | 429 | 是 | 发送过于频繁 |
3001 | SDK_NOT_CONNECTED | SDK 本地 | 0 | 是 | 长连接未就绪 |
相关文档
- 功能列表:103 个操作与签名
- 状态码:错误码与重试策略
- API 参考:类与成员
- IMLib 集成指南