在即时通讯 IM 中集成 OPPO 推送

环信即时通讯 IM SDK 中已集成 OPPO 推送相关逻辑，你还需要完成以下步骤。

步骤一 在 OPPO 开发者后台创建应用

在 OPPO 开发者后台创建应用，开启推送服务，上传对应的证书指纹，详见 OPPO 官方介绍：OPPO 推送服务集成。

步骤二 上传推送证书

在环信控制台上传 OPPO 推送证书。

1. 登录 环信控制台，选择你的应用 > 功能配置 > 增值功能 > 即时推送。

2. 在 证书管理 页面，点击 添加推送证书。在 添加推送证书 对话框中选择 OPPO 页签，配置 OPPO 推送参数。参数相关信息，详见你在 OPPO 开发者后台创建的应用的 appkey 和 mastersecret 以及程序的 包名等信息。

参数	类型	是否必需	描述
证书名称	String	是	填写 OPPO App Key。
推送密钥	String	是	填写 OPPO Master Secret。Master Secret 需要到 OPPO 推送平台 > 配置管理 > 应用配置 页面查看。
应用包名	String	是	填写 OPPO App package name。
Channel ID	String	否	填写 Channel ID。
Activity	String	否	选择点击通知后的动作。

步骤三 集成 OPPO 推送

1. 配置 OPPO 推送 aar 包：在 OPPO 推送官网下载推送 SDK 包，将 aar 包存放在 libs 目录下并 sync。

   此外，也可以直接使用环信 Android IM Demo 中集成的 OPPO 推送的 aar 包。

2. 配置 AndroidManifest.xml。

提示

从 4.8.1 版本开始，OPPO 推送 SDK 版本更新至 3.5.2 版本。

• 推送服务需要的权限列表：

<!-- OPPO 推送配置 start -->
<uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE"/>
<uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
<!-- OPPO 推送配置 end -->

• 推送服务需要的 service：

<!-- OPPO 推送配置 start -->
<service
android:name="com.heytap.msp.push.service.CompatibleDataMessageCallbackService"
android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE">
<intent-filter>
    <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
</intent-filter>
</service> <!--兼容 Q 以下版本-->

<service
android:name="com.heytap.msp.push.service.DataMessageCallbackService"
android:permission="com.heytap.mcs.permission.SEND_PUSH_MESSAGE">
<intent-filter>
    <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
    <action android:name="com.heytap.msp.push.RECEIVE_MCS_MESSAGE"/>
</intent-filter>
</service> <!--兼容 Q 版本-->
<!-- OPPO 推送配置 end -->

3. 在即时通讯 IM SDK 初始化时，配置启用 OPPO 推送。

   EMOptions options = new EMOptions();
   ...
   EMPushConfig.Builder builder = new EMPushConfig.Builder(this);
   builder.enableOppoPush(String appKey,String appSecret);
   // 将 pushconfig 设置为 ChatOptions
   options.setPushConfig(builder.build());
   // 初始化 IM SDK
   EMClient.getInstance().init(this, options);
   

4. 调用 OPPO 推送的初始化方法。

   HeytapPushManager.init(context, true);