集成小米推送

概述

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

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

已集成最新版本的音视频通话 UIKit（Call Kit），并且完成在线邀请功能，详情请参考快速开始（包含呼叫邀请）。
已完成如下步骤：
1. 前往小米开放平台注册开发者账号，并进行认证，详情请参考企业开发者账号注册流程。
2. 开发者身份认证成功后，使用小米开发者账号，登录小米开发者后台，在“应用服务”中选择“消息推送”。
3. 点击“创建应用”，按照流程输入相关信息，创建自己的应用，并获取该应用的 AppID、AppKey、AppSecret 等信息。
4. 完成以上步骤以后，您还需要提交应用审核。审核通过即应用创建完成，接下来还需要申请开通小米推送服务，请参考本文小米推送消息限制

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

Untitled

buildscript {  
    repositories {  
        mavenCentral()  
    }  
}  

allprojects {
    repositories {  
        mavenCentral()  
    }     
}

Copied!

下载小米推送 SDK，并将其拷贝到您项目的的 “app/libs” 目录下。
在项目的应用级 “build.gradle” 文件中添加 aar 依赖。
Untitled
dependencies { implementation files('libs/MiPush_SDK_Client_6_0_1-C_3rd.aar') // 版本为 6.0.1 的小米推送 SDK implementation 'im.zego:zpns-xiaomi:2.7.0' // 获取用于小米推送服务的 ZPNs 库 }
1
Copied!
Warning
由于 Android 12 通知 trampoline 限制（详情请参考 Google 官方文档行为变更：以 Android 12 为目标平台的应用 - 通知 trampoline 限制），targetSdkVersion >= 31 的应用需要接入小米推送 SDK 4.9.1 或以上版本，否则会出现点击通知无法正常跳转的情况。
在 “proguard-rules.pro” 文件中，为小米推送 SDK 添加 -keep 类的配置，这样可以防止混淆公共类名称：
proguard-rules.pro
-dontwarn com.xiaomi.push.** -keep class com.xiaomi.push.** { *; }
1
Copied!
以上配置完成后，请在 ZEGO 控制台自助配置 ZIM 离线推送证书（详情请参考项目管理 - 即时通讯 - 离线推送配置），若无法配置，请联系 ZEGO 技术支持处理。

小米推送将消息分为“私信消息”和“公信消息”两个类别，若应用选择不接入私信或公信，则会接入默认通道，详情请参考小米官网文档小米推送消息限制说明。

请参考小米官方文档小米推送消息分类新规 - channel申请及接入方法，创建 Channel，创建 Channel 时选择私信通道。创建后，请提交小米审核。

Warning
一旦创建 Channel 并发送了带有 Channel 的消息，设备上即会生成这个 Channel，不能删除也不能修改，所以请谨慎创建 Channel。
审核通过后，请登录 ZEGO 控制台，添加 resourcesID，步骤如下：
1. 选择项目管理，查看对应的项目。
2. 选择服务配置- 即时通讯页面，下滑到“自定义推送策略（resourcesID）配置，点击“添加 resourcesID”。
3. 填入 resourcesID（由您自定义，不超过 32 个字符）、您在小米控制台添加的 channel_id（渠道 ID，必需）、channel_name（渠道名称，可选）、channel_description（渠道描述，可选）。
  
  Note
  建议 resourcesID 能够直接反映推送目的。例如，目的是打电话，就可以命名为 call_resource。
在发起呼叫时，可以指定使用该 resourcesID 对应的通道进行推送。您需要将配置的 resourcesID 填写到对应的呼叫邀请按钮中或者设置给呼叫邀请接口，即可在呼叫邀请的时候使用离线推送功能。