小米推送集成指南

概述

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

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

前提条件

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

• 已集成最新版本的 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “3 集成 SDK”。
• 已完成如下步骤：
  1. 前往 小米开放平台 注册开发者账号，并进行认证，详情请参考 企业开发者账号注册流程。
  2. 开发者身份认证成功后，使用小米开发者账号，登录 小米开发者后台，在“应用服务”中选择“消息推送”。
     
  3. 点击“创建应用”，按照流程输入相关信息，创建自己的应用，并获取该应用的 AppID、AppKey、AppSecret 等信息。
     
     

使用步骤

1. 下载 小米推送 SDK。

2. 将下载到的 SDK “MiPush_SDK_Client_5_7_8-C_3rd.aar” 文件，拷贝到您项目路径的 “app/libs” 目录下。

3. 在 “build.prop” 中添加 aar 依赖。

   dependencies {
       implementation files('libs/MiPush_SDK_Client_5_7_8-C_3rd.aar') // 版本为 5.7.8 的小米推送 SDK
   }

   由于 Android 12 通知 trampoline 限制（详情请参考 Google 官方文档 行为变更：以 Android 12 为目标平台的应用 - 通知 trampoline 限制），targetSdkVersion >= 31 的应用需要接入小米推送 SDK 4.9.1 或以上版本，否则会出现点击通知无法正常跳转的情况。

4. 以上配置完成后，请在 ZEGO 控制台 自助配置 ZIM 离线推送证书（详情请参考 项目管理 - 即时通讯 - 离线推送配置），若无法配置，请联系 ZEGO 技术支持处理。

5. 防止混淆代码

   在 “proguard-rules.pro” 文件中，为 小米推送 SDK 添加 -keep 类的配置，这样可以防止混淆小米推送 SDK 公共类名称：

   # 以下的 “com.xiaomi.mipushdemo.DemoMessageRreceiver” 应改成 App 中定义的完整类名
   -keep class com.xiaomi.mipush.sdk.DemoMessageReceiver {*;}

小米推送消息限制

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

使用私信通道无限制推送

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

   一旦创建 Channel 并发送了带有 Channel 的消息，设备上即会生成这个 Channel，不能删除也不能修改，所以请谨慎创建 Channel。

2. 创建 Channel 后，请参考 resourcesID 说明 - 配置，在 ZEGO 控制台上使用如下信息配置 resourcesID：

   • resourcesID：由您自定义，不超过 32 个字符。

   • channel_id：渠道 ID，必需。

   • channel_name：渠道名称，可选。

   • channel_description：渠道描述，可选。

     建议 resourcesID 能够直接反映推送目的。例如，目的是打电话，就可以命名为 call_resource。

3. 在发起推送时，可以指定使用该 Resource ID 对应的通道进行推送。您需要将配置的 Resource ID 填写到 ZIMPushConfig 中，实现代码请参考 实现离线推送 - 发送单聊消息时使用离线推送功能。