文档导航
server
API 版本:  v1
公告:融云新文档中心已上线,欢迎到新文档中心阅读 IM 服务端文档

状态类型消息格式

更新时间:2024-01-26 PDF

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

提示

请注意区分状态类消息与 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"
}
              
已复制
1
2
3

内容结构参数

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

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

客户端默认属性

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

您的改进建议

意见反馈

问题类型

联系我们

提交工单

技术支持|集成使用|产品方案


商务咨询

7 x 24 小时

为您解答方案与报价问题

131 6185 6839

文档反馈