集成 OPPO 推送

概述

统一推送联盟 成立之后，各大厂商都推出了自己的推送服务通道，主要目的是为了建立 Android 推送生态。目前小米，华为，魅族，OPPO，vivo 等厂商都推出了系统级别的推送通道，避免了各家 APP 都使用各自的长链接来维持推送通道、需要应用进程处于存活状态，而造成手机耗电、耗内存等问题。

前提条件

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

已集成最新版本的音视频通话 UIKit（Call Kit），并且完成在线邀请功能，详情请参考快速开始（包含呼叫邀请）。
已完成如下步骤：
1. 前往 OPPO 开放平台注册企业开发者账号，并进行认证，详情请参考开发者帐号注册流程。
2. 开发者身份认证成功后，使用 OPPO 企业开发者账号，登录 OPPO 开放平台，选择 “管理中心 > 应用服务平台 > 开发服务 > 消息推送 > 创建新的应用”，创建一个新的应用。
3. 开通推送权限，流程请参考 OPPO 官方文档推送服务开启指南。
4. 申请通过后，可在 OPPO 推送平台 > 配置管理 > 应用配置页面查看 AppKey、AppSecret 和 MasterSecret（仅开发者账号（主账号）可查看）。

使用步骤

在您项目根目录的主 gradle 中配置 mavenCentral 支持。

Untitled

buildscript {  
    repositories {  
        mavenCentral()  
    }  
}  

allprojects {
    repositories {  
        mavenCentral()  
    }     
}

Copied!

下载 OPPO 推送 SDK，并将其拷贝到您项目的的 “app/libs” 目录下。
在项目的应用级 “build.gradle” 文件中添加 aar 依赖。

Untitled

dependencies {
 implementation files('libs/com.heytap.msp_3.5.2-release-20240516-416001043.aar') // 版本为 3.5.2 的 OPPO 推送 SDK
 implementation 'im.zego:zpns-oppo:2.7.0' // 获取用于 OPPO 推送服务的 ZPNs 库

 //以下为 OPPO 推送 SDK 依赖的三方库
 implementation 'com.google.code.gson:gson:2.10.1'
 implementation 'commons-codec:commons-codec:1.6'
 implementation 'androidx.annotation:annotation:1.1.0'
}

Copied!

防止混淆代码

在 “proguard-rules.pro” 文件中，为 OPPO 推送 SDK 添加 -keep 类的配置，这样可以防止混淆 OPPO 推送 SDK 公共类名称：
Untitled
-keep public class * extends android.app.Service -keep class com.heytap.msp.** { *;}
1
Copied!
以上配置完成后，请在 ZEGO 控制台自助配置 ZIM 离线推送证书（详情请参考项目管理 - 即时通讯 - 离线推送配置），若无法配置，请联系 ZEGO 技术支持处理。

OPPO 推送消息限制

OPPO 推送服务将消息推送通道分为两种，公信和私信，具体限制数量规则如下，详情请参见 OPPO 官网文档推送服务受限说明。

应用推送总量限制

通知栏推送权限	应用要求	消息推送量（条/日）
通知栏推送权限	应用要求	消息推送通道	累计用户数	可推送总量
正式权限	应用已上架 OPPO 软件商店	公信	<50000	100000
		公信	≥50000	累计用户×2
		私信	不限量。
测试权限	应用未上架 OPPO 软件商店	消息推送通道	可推送总量
		公信	1000
		私信	不支持申请。

单设备推送条数限制

应用类别	单用户推送限制（条/日）
应用类别	公信消息	私信消息
新闻类（三级分类为新闻类）	5条	不限量。
其他应用类型	2条	不限量。

使用私信通道不限量推送

您需要通过创建私信通道，才能无限制地向 OPPO 设备推送消息，详情请参考 OPPO 官网文档创建私信通道（需要 OPPO 审核）。
请登录 ZEGO 控制台，添加 resourcesID，步骤如下：
1. 选择项目管理，查看对应的项目。
2. 选择服务配置- 即时通讯页面，下滑到“自定义推送策略（resourcesID）配置，点击“添加 resourcesID”。
3. 提供 resourcesID（由您自定义，不超过 32 个字符）、channel_id（渠道 ID）。
  
  Note
  建议 resourcesID 能够直接反映推送目的。例如，目的是打电话，就可以命名为 call_resource。
在发起呼叫时，可以指定使用该 resourcesID 对应的通道进行推送。您需要将配置的 resourcesID 填写到对应的呼叫邀请按钮中或者设置给呼叫邀请接口，即可在呼叫邀请的时候使用离线推送功能。