Flutter
圈组系统通知概述
更新时间： 2024/03/07 13:15:27
圈组中的系统通知是由云信服务端下发给用户的通知类消息，用于包括创建服务器、创建频道、申请加入服务器等事件的通知。
系统通知分类
系统通知可分为内置系统通知和自定义系统通知。
| 系统通知类型 | 说明 | 离线系统通知限制 |
|---|---|---|
| 内置系统通知 | 圈组内置的系统通知, 类型包括“邀请服务器成员”、“踢除服务器成员”、“修改频道信息” 等 | 服务器成员管理事件的系统通知支持存离线，每月至多存 1,000 条离线通知。其他内置系统通知不存离线 |
| 自定义系统通知 | 开发者自定义系统通知。 SDK 不解析自定义系统通知，仅负责传递 | 每月 1,000 条离线通知 |
内置系统通知分类
圈组内置系统通知，可进一步分为服务器成员管理事件的系统通知、服务器其他相关事件的系统通知、频道事件系统通知、频道分组事件系统通知、身份组成员管理事件的系统通知和身份组权限事件系统通知。除了服务器成员管理事件的系统通知，其余类型都通过参与者与观察者机制控制接收人及其接收条件。
每个类型的具体触发条件和接收条件，请参考服务端文档的圈组系统通知。
系统通知定义
SDK 中定义圈组系统通知的结构为QChatSystemNotification类，该类的部分重要参数如下：
参数 |
类型 | 说明 |
|---|---|---|
serverId |
int | 通知所属的圈组服务器的 ID |
channelId |
int | 通知所属的频道的 ID |
toAccids |
List<String> |
通知接收者账号列表 |
fromAccount |
String | 通知发送者的网易云信账号 ID |
type |
QChatSystemNotificationType |
系统通知类型，具体类型参见 QChatSystemNotificationType |
time |
int | 通知发送成功的时间戳(毫秒) |
updateTime |
int | 通知更新时间戳 |
msgIdClient |
int | 客户端生成的通知 ID, 可做去重 |
msgIdServer |
int | 服务器生成的通知 ID，全局唯一 |
body |
String | 通知内容 |
attach |
String | 通知附件 |
status |
int | 状态，默认为 0。大于 10,000 为用户自定义的状态 |
persistEnable |
bool | 是否存离线，只有 toAccids 不为空，才能设置为存离线 |
pushEnable |
bool | 是否需要推送，默认false |
needBadge |
bool | 是否需要计数 |
系统通知功能概览
| 功能 | 说明 | 相关文档 |
|---|---|---|
| 系统通知收发 | 接收圈组内置系统通知和收发圈组自定义系统通知 | 圈组系统通知收发 |
| 系统通知更新 | 更新圈组自定义系统通知和四种内置系统通知 | 圈组系统通知更新 |
此文档是否对你有帮助？
