通知类消息格式
提示(小灰条)通知消息
即时通讯服务定义了 ObjectName 为 RC:InfoNtf
的提示(小灰条)通知消息。您可以需要通知、提示用户时,向会话中发送或本地插入该类型的消 息。
调用服务端 API 发送消息时,必须指定 ObjectName,并将对应类型的消息内容 JSON 对象序列化为 JSON String,放入 API 接口的 content
字段中。客户端 SDK 中已内置该消息类型,可直接调用相关方法发送。
提示小灰条消息包含的「消息内容」为 JSON 对象,结构如下:
{
"message":"请在聊天中注意人身财产安全",
"extra":""
}
内容结构参数
提 示小灰条消息内容结构参数如下表所示:
名称 | 类型 | 必传 | 说明 |
---|---|---|---|
message | String | 是 | 提示条消息内容。 |
extra | String | 否 | 扩展信息,可以放置任意的数据内容,也可以去掉此属性。 |
客户端默认属性
- 在客户端本地存储
- 不计入会话消息未读数
- 默认未支持远程推送:即时通讯服务端没有为该消息类型预置推送通知标题和通知内容。如果需要在收件人不在线触发远程推送通知,请在发送消息时传入自定义的推送通知内容。
撤回通知消息
即时通讯服务定义了 ObjectName 为 RC:RcNtf
的撤回通知消息,用于提示消息已撤回。
客户端 SDK 中已内置该消息类型。SDK 内部用于在执行撤回消息操作后展示撤回通知。不建议客户直接发送该消息。