Google 推送集成指南（Web）

概述

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

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

前提条件

在接入 FCM 的离线推送通道之前，请确保：

• 连接海外网络的 Chrome 浏览器。
• 可访问的 HTTPS 域名或 IP 。
• 已集成最新版本的 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “3 集成 SDK”。
• 已在 Firebase 上添加并注册 Web App，详情请参考本文 在 Firebase 上添加并注册 Web App。

在 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 配置。

   var appID = 0; // Your Application ID of ZEGO ZIM
   ZIM.create({ appID: appID }); 
   var zim = ZIM.getInstance();
   
   var config = {
       // From firebaseConfig
       apiKey: '',
       authDomain: '',
       projectId: '',
       storageBucket: '',
       messagingSenderId: '',
       appId: '',
       measurementId: '',
   
       // From Web Push certificates
       vapidKey: '',
   }
   ZPNs.getInstance().register(config, zim);

4. 前往 下载 获取最新版本的 ZPNs SDK，将其中的 firebase-messaging-sw.js 文件，拷贝到项目根目录。

5. 以上配置完成后，请联系 ZEGO 技术支持配置离线推送证书。