输入状态
发送“正在输入”状态,默认 5 秒自动过期;适用于单聊与群聊。
平台调用风格
双语言同契约:Swift 用 async -> RcResult<T>(错误码在 RcResult.code,返回 null 的 op 用 RcResult<Void>);Objective-C 用 - (void)opWithParam:... completion:(void (^)(RcResult *))completion,回调在主线程投递。
接口一览
| 操作 | 语义 | 传输 | 返回 |
|---|---|---|---|
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 事件。
func sendTypingStatus(conversationType: IMPConversationType, targetId: String, typing: Bool) async -> RcResult<Void>参数
| 参数 | 类型 | 说明 |
|---|---|---|
conversationType | ConversationType | 必填;会话类型枚举(ConversationType) |
targetId | string | 必填;目标会话 ID:单聊为对方 userId,群聊为 groupId,聊天室为 chatroomId |
typing | bool | 必填;是否正在输入(true/false) |
返回
null 无返回数据;成功与否通过错误码判断
示例(Swift / Objective-C)
let res = await client.sendTypingStatus(conversationType: .privateChat, targetId: "user2", typing: true)
if res.code != 0 { print("IM 调用失败:\(res.msg ?? "")") }[client sendTypingStatusWithConversationType:1 /* 单聊 */ targetId:@"user2" typing:true completion:^(IMPOSResult *result) {
if (result.code != 0) { NSLog(@"IM 调用失败:%ld %@", (long)result.code, result.msg); }
}];错误码
| 错误码 | 名称 | 分类 | 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 集成指南