原生移动开发 / 系统课时

接入小米 Mi Push

接入小米 Mi Push

本篇从 Android 客户端完成 Mi Push 的最小闭环:初始化 SDK、设置区域、调用 registerPush 获取当前应用设备的 RegID,再把 RegID 上报到业务服务器,并接住注册回调。小米当前官方 AAR 文档明确要求在注册前先设置数据存储区域。([小米开发者平台][4])

学习目标

  • 能正确初始化 Mi Push 客户端
  • 能理解 APP_ID、APP_KEY 与 RegID 的职责
  • 能把设备注册结果接入业务服务端

初始化顺序与区域配置

Mi Push 客户端通常在 Application.onCreate() 中初始化。当前官方 AAR 文档指出,应先调用 MiPushClient.setRegion,再调用 registerPush;注册成功后通过 onReceiveRegisterResult 或 onCommandResult 获取结果,其中 RegID 是当前应用在当前设备上的推送标识。([小米开发者平台][4])

Mi Push 注册与 RegID 上报链路

片段示例,依赖版本与 Maven 坐标应以当前小米官方 AAR 文档为准:

java
import android.app.Application;
import android.util.Log;
import com.xiaomi.mipush.sdk.MiPushClient;

public class DemoApplication extends Application {
    private static final String APP_ID = "<MI_APP_ID>";
    private static final String APP_KEY = "<MI_APP_KEY>";

    @Override
    public void onCreate() {
        super.onCreate();
        // 区域必须先于 registerPush 设置,实际区域按业务与官方支持范围选择。
        MiPushClient.setRegion(this, MiPushClient.Region.Global);
        MiPushClient.registerPush(this, APP_ID, APP_KEY);
        Log.d("MiPush", "registerPush requested");
    }
}

预期结果

text
应用启动时执行 setRegion 后再执行 registerPush;成功注册后可在注册回调中取得 RegID。

处理注册结果

Mi Push 的关键不是“调用过 registerPush”,而是把注册结果真正接入自己的设备绑定逻辑。官方文档提供 onReceiveRegisterResult 与 onCommandResult 两类结果回调;成功后取得的 RegID 应上传业务服务器,服务器以后按该标识关联用户或设备。([小米开发者平台][5])

片段示例:

java
import android.content.Context;
import android.util.Log;
import com.xiaomi.mipush.sdk.MiPushCommandMessage;
import com.xiaomi.mipush.sdk.MiPushMessage;
import com.xiaomi.mipush.sdk.PushMessageReceiver;
import java.util.List;

public class AppPushReceiver extends PushMessageReceiver {
    @Override
    public void onReceiveRegisterResult(Context context, long errorCode, String regId) {
        Log.d("MiPush", "register result=" + errorCode);
        if (regId != null && !regId.isEmpty()) {
            reportRegIdToServer(regId);
        }
    }

    @Override
    public void onCommandResult(Context context, MiPushCommandMessage message) {
        Log.d("MiPush", "command result=" + message.getResultCode());
    }

    @Override
    public void onReceiveMessage(Context context, MiPushMessage message) {
        Log.d("MiPush", "message received");
    }

    @Override
    public void onReceivePassThroughMessage(Context context, MiPushMessage message) {
        Log.d("MiPush", "pass-through message received");
    }

    @Override
    public void onNotificationMessageClicked(Context context, MiPushMessage message) {
        Log.d("MiPush", "notification clicked");
    }

    private void reportRegIdToServer(String regId) {
        // 片段示例:实际项目调用自己的 HTTPS 注册接口。
    }
}

预期结果

text
注册成功且返回 RegID 时执行 reportRegIdToServer;收到普通、透传或通知点击事件时进入对应回调。

整理服务端设备标识

客户端不要只把 RegID 打日志就结束。业务服务器至少应记录“用户或业务主体 + 厂商 + RegID + 更新时间”等关联信息,并允许后续更新同一设备的标识。这里的 RegID 是 Mi Push 当前应用设备注册产生的标识,不应误当作业务用户 ID。([小米开发者平台][5])

当用户退出登录时,也应明确设备绑定是否随账号解绑;不要把“注销 Mi Push”与“业务账号退出”混成同一个动作。Mi Push 官方还提供 unregisterPush 用于关闭该应用继续接收 Mi Push 服务推送的状态。([小米开发者平台][4])

接入失败时先查什么

最先检查三件事:是否在 registerPush 前调用了 setRegion,APP_ID 与 APP_KEY 是否来自同一个小米应用,以及注册代码是否运行在主进程。官方文档特别提示不要在多个进程重复初始化,并要求相关推送组件保持正确的进程关系。([小米开发者平台][4])

验证成功的标准不是“没有崩溃”,而是能看到一次成功注册结果、获得非空 RegID、把它上传业务服务器,并最终能够用服务器侧记录的标识验证推送链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入小米 Mi Push

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通