圈组系统通知是用户在使用圈组功能的过程中，由云信 IM 下发给用户相关事件的通知，比如圈组服务器中的成员变更，频道变更等事件。

功能介绍

圈组内置系统通知只能通过具体事件触发，由云信 IM 发送给相关的圈组用户。用户只需注册圈组系统通知的相关监听，就能接收到对应的系统通知。

圈组自定义系统通知支持用户主动发送，并可以指定发送给全员或部分成员。

云信 IM Android SDK 的 QChatMessageService 接口提供管理圈组系统通知的相关方法，QChatServiceObserver 接口提供监听圈组系统通知的相关方法，帮助您快速实现对圈组系统通知的管理。

NIM SDK 中的 QChatSystemNotification 类定义了圈组的系统通知，其内置方法如下：

实现方法

本文以服务器所有者（即创建者）和服务器成员的交互为例，介绍服务器所有者发送圈组自定义系统通知的实现流程和触发内置圈组系统通知的实现流程。

前提条件

• 已接入圈组，并已创建圈组服务器。
• 已创建云信 IM 账号，作为下文中服务器所有者和服务器成员的云信 IM 账号。

实现流程

以下只对部分重要步骤进行说明：

1. 服务器成员注册 observeReceiveSystemNotification 监听圈组系统通知的接收。

   示例代码：

   NIMClient.getService(QChatServiceObserver.class).observeReceiveSystemNotification(new Observer<List<QChatSystemNotification>>() {
   @Override
   public void onEvent(List<QChatSystemNotification> qChatSystemNotifications) {
   //收到圈组系统通知
   for (QChatSystemNotification qChatSystemNotification : qChatSystemNotifications) {
   //处理圈组系统通知
   }
   }
   }, true);
   

2. 服务器所有者通过调用 sendSystemNotification 发送圈组自定义系统通知。

   其中 QChatSendSystemNotificationParam 是发送圈组自定义系统通知入参，提供四种构造方法，通过入参的不同来进行区分，通知给不同的对象：

   通知的对象	涉及的入参
   通知给圈组服务器全员	serverId（服务器 ID）
   通知给圈组服务器中的某个频道全员	serverId（服务器 ID），channelId（频道 ID）
   通知给圈组服务器中的部分成员	serverId（服务器 ID），toAccids（通知的服务器成员列表）
   通知给圈组服务器中的某个频道中的部分成员	serverId（服务器 ID），channelId（频道 ID），toAccids（通知的频道成员列表）

   若需要在发送自定义系统通知前提前构造一个 QChatSystemNotification，您可以通过 QChatSendSystemNotificationParam 的toSystemNotification 构造圈组自定义系统通知。

   示例代码：

   QChatSendSystemNotificationParam param = new QChatSendSystemNotificationParam(943445L,885305L);
   param.setBody("测试自定义系统通知");
   param.setExtension(getExtension());
   param.setPushPayload(getPushPayload());
   param.setPushContent("测试推送自定义系统通知");
   param.setPushEnable(true);
   param.setNeedBadge(true);
   param.setNeedPushNick(true);
   
   QChatSystemNotification currentSystemNotification = param.toSystemNotification();
   
   NIMClient.getService(QChatMessageService.class).sendSystemNotification(param).setCallback(new RequestCallback<QChatSendSystemNotificationResult>() {
   @Override
   public void onSuccess(QChatSendSystemNotificationResult result) {
   //发送自定义系统通知成功,返回发送成功的自定义系统通知具体信息
           QChatSystemNotification notification = result.getSentCustomNotification();
   }
   
   @Override
   public void onFailed(int code) {
   //发送自定义系统通知息失败，返回错误code
   }
   
   @Override
   public void onException(Throwable exception) {
   //发送自定义系统通知异常
   }
   });
   

3. 服务器成员收到来自服务器所有者的自定义系统通知。

4. 服务器成员通过调用 markSystemNotificationsRead 标记圈组系统通知已读。

   标记已读后的系统通知将从服务端删除，后续不会在其他端接收。

   示例代码：

   QChatSystemNotification systemNotification = getMarkSystemNotification();
   List<Pair<Long, QChatSystemNotificationType>> pairs = new ArrayList<>();
   pairs.add(new Pair<>(systemNotification.getMsgIdServer(),systemNotification.getType()));
   
   QChatMarkSystemNotificationsReadParam param = new QChatMarkSystemNotificationsReadParam(pairs);
   NIMClient.getService(QChatMessageService.class).markSystemNotificationsRead(param).setCallback(new RequestCallback<Void>() {
       @Override
       public void onSuccess(Void result) {
           //标记成功
       }
   
       @Override
       public void onFailed(int code) {
           //标记失败
       }
   
       @Override
       public void onException(Throwable exception) {
           //标记异常
       }
   });
   

5. 服务器所有者调用 deleteServer 方法删除圈组服务器。

   示例代码：

   NIMClient.getService(QChatServerService.class).deleteServer(new QChatDeleteServerParam(944335L)).setCallback(
           new RequestCallback<Void>() {
               @Override
               public void onSuccess(Void result) {
                   // 删除Server成功
               }
   
               @Override
               public void onFailed(int code) {
                   //  删除Server失败，返回错误code
               }
   
               @Override
               public void onException(Throwable exception) {
                   //  删除Server异常
               }
           });
   
   

6. 服务器所有者和服务器成员收到系统投递的内置系统通知。

   该示例收到类型为“删除服务器”的系统通知，更多事件类型和相应的通知接收条件，请参见圈组系统通知分类和圈组系统通知接收机制。

7. （可选）如果因为网络等原因，自定义系统通知发送失败，用户可以调用 resendSystemNotification 方法重新发送自定义系统通知。

   如果重发已经发送成功的自定义系统通知，那么通知接收方不会再次收到该系统通知。

   示例代码：

   NIMClient.getService(QChatMessageService.class).resendSystemNotification(new QChatResendSystemNotificationParam(currentSystemNotification)).setCallback(new RequestCallback<QChatSendSystemNotificationResult>() {
       @Override
       public void onSuccess(QChatSendSystemNotificationResult result) {
           //重发自定义系统通知成功,返回发送成功的自定义系统通知具体信息
           QChatSystemNotification notification = result.getSentCustomNotification();
       }
   
       @Override
       public void onFailed(int code) {
           //重发自定义系统通知息失败，返回错误code
       }
   
       @Override
       public void onException(Throwable exception) {
           //重发自定义系统通知异常
       }
   });