实现静默推送

---

功能简介

静默推送属于特殊的远程通知，主要用于后台运行的 App 和服务器进行数据同步，例如：App 不在活跃时，App 内数据已经过时，服务器会发送静默推送，此时 App 则进行数据更新，用户全程无感知。

前提条件

在实现静默推送之前，请确保：

• 已在 ZEGO 控制台 创建项目，获取到了接入 ZIM SDK 服务所需的 AppID、AppSign。ZIM 服务权限不是默认开启的，使用前，请先在 ZEGO 控制台 自助开通 ZIM 服务（详情请参考控制台的 服务配置 - 即时通讯 - 开通服务），若无法开通 ZIM 服务，请联系 ZEGO 技术支持开通。

• 已集成 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “2 集成 SDK”。

• 已集成 ZPNs SDK 2.3.3 或以上版本 并实现离线推送，详情请参考 实现离线推送。

实现流程

发送静默推送

1. 联系 ZEGO 技术支持配置携带静默推送策略的 resourceID。静默推送策略有 iOS 和 FCM 两种。根据实际需求，您可以选择只携带一种静默推送策略的 resourceID。

2. 在需要发送离线推送的场景（如 呼叫邀请、离线推送 等），向 ZIMPushConfig 的 resourceID 字段填入预先配置好的值，并根据具体业务场景的需要填入 payload 字段。

   var pushConfig = {
       resourcesID: "your resourcesID", // 联系 ZEGO 技术支持配置的 resourcesID
       title: "your title",
       content: "your content",
       payload: "your payload",
   };

3. 完成上述步骤，即可向别人发送静默推送

接收静默推送

iOS 或 Android App 在前台，或者在后台而未终止时

通过注册 throughMessageReceived 事件来接收在线静默推送通知。

ZPNs.getInstance().on('throughMessageReceived', message => {
    console.log('ZPNs throughMessageReceived', message);
    // 处理在线静默推送通知
})

Android App 在后台被终止时

需要在您的项目的入口文件导入 ZPNs ，并调用 setBackgroundMessageHandler 设置回调来接收离线静默推送通知。

import ZPNs from 'zego-zpns-react-native';

/** 项目入口的代码，开发者无需处理 **/ 
// import { AppRegistry, Platform } from 'react-native';
// import App from './App';
// import { name as appName } from './app.json';

// AppRegistry.registerComponent(appName, () => App);
/** 项目入口的代码，开发者无需处理 **/

// 注意：以下代码不能在 UI 组件里调用！
ZPNs.setBackgroundMessageHandler(message => {
    console.log('ZPNs backgroundMessageHandler', message);
    // 处理 Android 离线静默推送通知
})

完成上述步骤，即可向别人发送静默推送以及接收来自别人的静默推送。