状态类型消息格式
即时通讯服务将客户端默认不存储、不计入会话消息未读数的消息类型归为一类,称为状态类消息。
提示
请注意区分状态类消息与 IM 服务端发送状态消息 API 的作用。
- 状态类消息特点:客户端默认不存储、不计入会话未读消息数。可由客户端发送(一般由 SDK 内部发送),或通过 IM Server API 发送。
- 发送状态消息的 IM Server API:可接受任意内置消息类型,如果接收者不在线,则无法收到消息。
正在输入状态消息
即时通讯服务定义了 ObjectName 为 RC:TypSts
的正在输入状态消息。
调用服务端 API 发送消息时,必须指定 ObjectName,并将对应类型的消息内容 JSON 对象序列化为 JSON String,放入 API 接口的 content
字段中。客户端 SDK 中已内置 正在输入状态消息 消息类型。客户端收到消息后不计入未读消息数、不存储。
- 如果在客户端 SDK 配置中启用了单聊输入状态功能,SDK 内部会自动往单聊会话中发送该类型消息。群聊场景下不支持由 SDK 自动发送正在输入状态消息。
- 如果使用即时通讯服务端 API 发送,请使用发送状态消息接口:发送单聊状态消息、发送群聊状态消息。
正在输入状态消息包含的「消息内容」为 JSON 对象,结构如下:
{
"typingContentType":"RC:TxtMsg"
}
内容结构参数
正在输入状态消息内容结构参数如下表所示:
名称 | 类型 | 必传 | 说明 |
---|---|---|---|
typingContentType | String | 是 | 正在输入消息类型。 |
客户端默认属性
- 不会在客户端本地存储
- 不计入会话消息未读数
- 不支持离线消息推送