跳到主要内容

状态类型消息格式

即时通讯服务将客户端默认不存储、不计入会话消息未读数的消息类型归为一类,称为状态类消息。

提示

请注意区分状态类消息与 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"
}

内容结构参数

正在输入状态消息内容结构参数如下表所示:

名称类型必传说明
typingContentTypeString正在输入消息类型。

客户端默认属性

  • 不会在客户端本地存储
  • 不计入会话消息未读数
  • 不支持离线消息推送