原生移动开发 / 系统课时

接入 OPPO Push

接入 OPPO Push

本课把 OPPO Push 的客户端链路跑通:先完成平台侧开通与密钥准备,再初始化 SDK、判断设备支持情况、注册获取 RegId,最后检查通知权限并验证通知能否真正到达设备。OPPO 官方文档明确要求先初始化,再判断是否支持,注册成功后通过回调取得 RegId。([OPPO 开放平台][1])

学习目标

  • 能完成 OPPO Push 客户端的初始化、支持性检查与注册
  • 能正确处理 RegId 和注册回调,避免把“调用成功”误判成“已经可推送”
  • 能从注册、通知权限和设备状态三个环节验证完整触达链路

准备 OPPO Push 配置

先在 OPPO 开放平台为应用开通 Push,并准备客户端所需的 AppKey、AppSecret。官方文档中,AppKey 与 AppSecret 用于客户端注册;MasterSecret 属于服务端发送消息时使用的凭据,不应写入 APK。([OPPO 开放平台][1])

SDK 依赖建议直接按照你当前使用的 OPPO 官方接入文档添加,并把版本固定在项目依赖管理中,不要复制网上未经确认的旧版本坐标。历史官方 SDK 文档的客户端核心 API 为 HeytapPushManager,包括 init、isSupportPush、register、getRegister 和通知状态相关接口。([OPPO 开放平台][1])

完成初始化与注册

下面示例假设项目已经按当前 OPPO SDK 文档完成依赖,并在可执行的 Android Application 中调用。示例只演示客户端核心链路,真实项目中应把 RegId 上报到自己的服务端,并在服务端保存最新值。

java
import android.app.Application;
import android.util.Log;

import com.heytap.msp.push.HeytapPushManager;
import com.heytap.msp.push.callback.ICallBackResultService;

public class App extends Application {
    private static final String TAG = "OppoPush";

    @Override
    public void onCreate() {
        super.onCreate();

        // 先初始化,再判断平台能力并注册。
        HeytapPushManager.init(this, false);

        if (!HeytapPushManager.isSupportPush()) {
            Log.d(TAG, "OPPO Push unsupported");
            return;
        }

        HeytapPushManager.register(this, "<OPPO_APP_KEY>", "<OPPO_APP_SECRET>",
                new ICallBackResultService() {
                    @Override
                    public void onRegister(int responseCode, String registerID) {
                        if (responseCode == 0) {
                            Log.d(TAG, "register success, regId=" + registerID);
                            // 将 registerID 绑定到当前登录用户并上报服务端。
                        } else {
                            Log.d(TAG, "register failed, code=" + responseCode);
                        }
                    }

                    @Override public void onUnRegister(int responseCode) {}
                    @Override public void onGetPushStatus(int responseCode, int status) {}
                    @Override public void onGetNotificationStatus(int responseCode, int status) {}
                    @Override public void onSetPushTime(int responseCode, String pushTime) {}
                });
    }
}

预期结果

text
支持 OPPO Push 的设备:先打印注册结果;注册成功时回调 responseCode=0,并得到一个非空 regId。
不支持的设备:打印 OPPO Push unsupported,不继续注册。

这里最容易犯的错误是只看到注册 API 没抛异常,就认为设备已经具备触达条件。官方回调约定中,responseCode 为 0 才表示该次操作成功;RegId 是客户端注册后的唯一标识,可用于服务端指定设备发送。([OPPO 开放平台][1])

OPPO Push 注册与通知触达链路

检查通知状态与失败原因

当 RegId 已经存在但通知仍没有出现时,应继续检查通知权限、服务端目标 RegId 和设备侧 Push 状态。OPPO SDK 提供 getNotificationStatus() 与 getPushStatus() 等接口;通知状态与 Push 服务状态是两个不同维度,不能用其中一个替代另一个。([OPPO 开放平台][1])

注册失败时,优先核对 AppKey、AppSecret、平台权限和设备支持情况。对于首次注册失败,官方文档还提供 getRegister() 用于基于上一次注册参数重试。([OPPO 开放平台][1])

text
验证顺序
1. 当前设备是否支持 OPPO Push
2. HeytapPushManager.init 是否已执行
3. register 回调是否返回 responseCode=0
4. regId 是否已保存并与当前用户正确绑定
5. 系统通知权限是否开启
6. 服务端发送目标是否就是该设备的 regId
7. 再观察设备通知栏是否收到消息

预期结果

text
每一步都有明确结果;只有“注册成功 + regId 正确 + 通知能力可用 + 服务端目标正确”同时满足时,才能继续判断消息内容或运营平台配置问题。

完成这条链路后,OPPO Push 的接入就不再是“SDK 调用过了”,而是可以用 RegId、状态检查和实际通知结果逐层证明客户端确实具备接收条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入 OPPO Push

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

登录哪都通