Google 推送集成指南（Web）

概述

Google 推送 FCM（Firebase Cloud Messaging）是一种跨平台消息传递解决方案，支持海外用户推送离线消息，可供开发者可靠地传递消息。

开发者使用 ZIM 提供的“离线推送”功能之前，请参考本文，接入 Google FCM 厂商的离线推送通道。

前提条件

使用 FCM 成功推送需要以下条件：

1. 连接海外网络的 Chrome 浏览器。
2. 可访问的 HTTPS 域名或 IP 。

在 Firebase 上添加并注册 Web App

1. 前往 Firebase 平台，登录自己的 Google 账号。

2. 登录成功后，在页面中，选择 “Add project”，输入项目名称及相关信息。

   

3. 添加项目完成后，点击，进入项目详情。

   

4. 在界面中点击如图的按钮，创建 Web 应用。

   

5. 填写 Web 应用的相关信息，然后点击 “Register app”。

   

6. 注册完成后，点击 “Service accounts > Generate new private key” 生成 JSON 配置文件。集成 SDK 时，需要将此文件提交给 ZEGO 技术支持。

   

实现流程

1. 选择 “Cloud Messaging”，生成 Web Push certificates。请复制图中框选的 “key pair“ 用于下文配置 vapidKey。

   

2. 拷贝 firebaseConfig 变量信息。

   

3. 将拷贝到的 firebaseConfig 信息，复制到项目中，在项目里注册 ZPNs 配置。

   ZIMAppConfig appConfig = ZIMAppConfig();
   appConfig.appID = 0;
   appConfig.appSign = "";
   
   ZIM.create(appConfig);
   
   ZPNsWebConfig config = ZPNsWebConfig();
   config.apiKey = "";
   config.authDomain = "";
   config.projectID = "";
   config.storageBucket = "";
   config.messagingSenderID = "";
   config.appID = "";
   config.measurementID = "";
   // 来自 Key pair 
   config.vapidKey = "";
   ZPNs.getInstance().registerPush(webConfig: config);

4. 前往 下载 获取最新版本的 ZPNs SDK，flutter 项目只需将其中的 firebase-messaging-sw.js 文件，拷贝到打包后的 web 根目录，与 index.html 在同一个目录下，无需引入。

5. 以上配置完成后，请在 ZEGO 控制台 自助配置 ZIM 离线推送证书（详情请参考 项目管理 - 即时通讯 - 离线推送配置），若无法配置，请联系 ZEGO 技术支持处理。