原生移动开发 / 系统课时

接入 vivo Push

接入 vivo Push

本课完成 vivo Push 的客户端接入闭环:把 vivo 应用参数配置到 Android 工程,初始化 PushClient,打开 Push 服务并获取 RegId,然后通过消息接收回调验证通知链路。vivo 生态的实际 SDK API 会随 SDK 版本变化,因此工程应以当前 vivo 接入包和官方文档为准;这里使用公开可核验的 PushClient.initialize()、isSupport()、turnOnPush() 和 getRegId() 链路。([Tencent RTC][2])

学习目标

  • 能完成 vivo Push 的应用参数配置和客户端初始化
  • 能在支持性检查通过后打开 Push 并取得 RegId
  • 能按应用前后台状态验证通知展示与消息回调,而不是只验证 Token 是否存在

配置应用标识与 SDK

先在 vivo 推送平台创建或配置应用,准备对应的 AppID 与 AppKey。公开的 vivo Android Push 接入资料以及使用 vivo 推送的集成案例都采用 com.vivo.push.app_id 与 com.vivo.push.api_key 这两个 Manifest 元数据键。([百度云推送][3])

下面是只承担“配置位置”说明的 Manifest 片段,具体 SDK 服务、Receiver 以及 android:exported 等声明应以你下载的 SDK 官方接入指南为准,不要把不同版本教程中的组件名混用。

xml
<application>
    <meta-data
        android:name="com.vivo.push.app_id"
        android:value="<VIVO_APP_ID>" />
    <meta-data
        android:name="com.vivo.push.api_key"
        android:value="<VIVO_API_KEY>" />
</application>

预期结果

text
Gradle 构建能够完成,应用运行时可以读取 vivo Push SDK,并且 SDK 使用工程内配置的 AppID 与 AppKey。

初始化并获取 RegId

PushClient 的核心使用方式是先 initialize(),再检查 isSupport(),最后调用 turnOnPush();当回调状态为 0 时,可通过 getRegId() 取得当前设备的 RegId。公开的 SDK 集成示例采用了这一调用顺序。([Tencent RTC][2])

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

import com.vivo.push.IPushActionListener;
import com.vivo.push.PushClient;

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

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

        PushClient client = PushClient.getInstance(getApplicationContext());
        client.initialize();

        if (!client.isSupport()) {
            Log.d(TAG, "vivo Push unsupported");
            return;
        }

        client.turnOnPush(new IPushActionListener() {
            @Override
            public void onStateChanged(int state) {
                if (state == 0) {
                    String regId = client.getRegId();
                    Log.d(TAG, "vivo Push enabled, regId=" + regId);
                    // RegId 应绑定当前用户并上报服务端。
                } else {
                    Log.d(TAG, "vivo Push enable failed, state=" + state);
                }
            }
        });
    }
}

预期结果

text
支持 vivo Push 且开通成功:打印 vivo Push enabled,并得到非空 regId。
不支持的设备:打印 vivo Push unsupported。
打开 Push 失败:打印 vivo Push enable failed,并记录具体 state 供后续排查。

不要把 regId 当成永久不变的业务主键。它首先是推送通道标识,客户端拿到后应与当前登录用户建立服务端映射,并允许后续注册变化覆盖旧值。公开的 vivo Push 集成示例也将取得的 RegId 用于后续第三方推送绑定。([Tencent RTC][2])

vivo Push 初始化、Token 获取与消息触达关系

验证不同应用状态下的触达

Token 获取成功只能证明注册链路成立,还不能证明最终触达。测试时至少覆盖应用前台、退到后台以及被用户结束后再次打开三个状态,并记录“消息是否收到、是否展示通知、点击后是否进入目标页面”。不同 SDK 版本和系统策略下,后台展示和回调路径可能存在差异,因此测试结果应以实际设备为准。公开集成资料也区分了 Push 能力状态和具体消息回调处理。([Tencent RTC][2])

text
验证清单
1. 安装测试包并确认 AppID、AppKey 与当前包名对应。
2. 启动应用,确认 initialize 与 turnOnPush 成功。
3. 记录 getRegId() 返回值,并确认服务端已保存。
4. 服务端向该 RegId 发送一条测试消息。
5. 分别测试前台、后台、重新打开应用三种状态。
6. 记录通知展示结果和消息点击后的页面结果。

预期结果

text
注册成功:设备侧得到非空 RegId。
发送成功:服务端能够以该设备标识发起测试消息。
前后台测试:能够观察到实际设备上的通知或消息处理结果,并可据日志判断消息究竟停在注册、发送还是展示阶段。

当 vivo Push 出现“有 RegId 但收不到消息”时,不要立即修改业务代码。先确认 AppID/AppKey、设备支持状态、turnOnPush 返回状态、服务端目标 RegId,以及当前应用状态是否一致,再判断是通道问题还是通知展示问题。这样才能把一次厂商推送故障定位到具体链路节点。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入 vivo Push

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

登录哪都通