vivo 推送集成指南
概述
统一推送联盟 成立之后，各大厂商都推出了自己的推送服务通道，主要目的是为了建立 Android 推送生态。目前小米，华为，魅族，OPPO，vivo 等厂商都推出了系统级别的推送通道，避免了各家 APP 都使用各自的长链接来维持推送通道、需要应用进程处于存活状态，而造成手机耗电、耗内存等问题。
开发者使用 ZIM 提供的“离线推送”功能之前，请参考本文，接入 vivo 厂商的离线推送通道。
前提条件
在接入 vivo 的离线推送通道之前，请确保：
-
已集成最新版本的音视频通话 UIKit（Call Kit），并且完成在线邀请功能。详情请参考 快速开始（包含呼叫邀请）。
-
已完成如下步骤：
- 点击“推送申请”，申请一个新的应用，并获取该应用的 AppID、AppKey、AppSecret 等信息。
使用步骤
在您项目根目录的主“gradle”文件中配置 mavenCentral 支持。
buildscript {
repositories {
mavenCentral()
}
}
allprojects {
repositories {
mavenCentral()
}
}
下载 vivo 推送 SDK，并将其拷贝到您项目的的“app/libs”目录下。
本文提供的 vivo 推送 SDK 包建议搭配 ZPNs SDK v2.7.0。
在应用级的“build.gradle”文件中添加 aar 依赖，参考如下：
implementation files('libs/vivo_pushSDK_v4.0.4.0_504.aar') // // 版本为 4.0.4 的 vivo 推送 SDK
implementation 'im.zego:zpns-vivo:2.7.0' // 获取用于 vivo 推送的 ZPNs 包
请在当前工程“AndroidManifest.xml”中的 Application 节点下添加以下代码，开发者需要在当前应用程序中，配置前提条件中获取到的 vivo 应用的 AppID、AppKey 等信息。
<!--Push开放平台中应用的appid 和api key-->
<meta-data
android:name="api_key"
android:value="xxxxxxxx"/>
<meta-data
android:name="app_id"
android:value="xxxx"/>
在“proguard-rules.pro”文件中，为 vivo 推送 SDK 添加 -keep 类的配置，这样可以防止混淆 vivo 推送 SDK 公共类名称：
-dontwarn com.vivo.push.**
-keep class com.vivo.push.**{*; }
-keep class com.vivo.vms.**{*; }
以上配置完成后，请在 ZEGO 控制台 自助配置 ZIM 离线推送证书（详情请参考 项目管理 - 即时通讯 - 离线推送配置），若无法配置，请联系 ZEGO 技术支持处理。
vivo 推送消息限制
vivo 推送将消息分为“系统消息”和“运营消息”两大类别。未接入消息分类，将默认为运营消息，受运营消息规则管控。详情请参见 vivo 官网文档 推送消息限额。
| 消息分类 | 应用类别 | 用户接收数量限制 |
|---|---|---|
| 系统消息 | / | 无限制。 |
| 运营消息 | 新闻资讯类（具备《互联网新闻信息服务许可证》，且应用分类为“新闻资讯”）。 | 5条。 |
| 其他类。 | 2条。 | |
| 测试消息 | 审核中的应用，推送权限为“受限”，只能通过 API，向在 Web 页面中添加的测试设备发送测试消息，测试设备数量上限为 20 个，测试消息不受量级和频控限制。 发送测试消息时注意填写 pushMode=1（0：正式推送；1：测试推送；不填默认为 0）。若未填写，则文案相同时，将被当做重复运营消息被去重。 | |
- 通知开启的有效用户：应用集成的 push-sdk 订阅成功，且设备近 14 天内有联网的通知权限开启用户。
- 通知开启有效用户数＜10000，则运营消息量级默认为 10000。
基于系统消息配置不限量推送
请参考 resourcesID 说明 - 配置，在 ZEGO 控制台上使用如下信息配置 resourcesID：
| 字段 | 说明 |
|---|---|
| resourcesID | 由您自定义，不超过 32 个字符。 说明 建议 resourcesID 能够直接反映推送目的。例如，目的是打电话，就可以命名为 call_resource。 |
| category | 推送类别。 注意
|
| classification | 消息类型。
|
| push_mode | 推送模式。
|
完成上述配置后，请参考 实现离线推送 集成 ZPNs SDK 等其他步骤。