原生移动开发 / 系统课时
接入 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 官方接入指南为准,不要把不同版本教程中的组件名混用。
<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>预期结果
Gradle 构建能够完成,应用运行时可以读取 vivo Push SDK,并且 SDK 使用工程内配置的 AppID 与 AppKey。初始化并获取 RegId
PushClient 的核心使用方式是先 initialize(),再检查 isSupport(),最后调用 turnOnPush();当回调状态为 0 时,可通过 getRegId() 取得当前设备的 RegId。公开的 SDK 集成示例采用了这一调用顺序。([Tencent RTC][2])
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);
}
}
});
}
}预期结果
支持 vivo Push 且开通成功:打印 vivo Push enabled,并得到非空 regId。
不支持的设备:打印 vivo Push unsupported。
打开 Push 失败:打印 vivo Push enable failed,并记录具体 state 供后续排查。不要把 regId 当成永久不变的业务主键。它首先是推送通道标识,客户端拿到后应与当前登录用户建立服务端映射,并允许后续注册变化覆盖旧值。公开的 vivo Push 集成示例也将取得的 RegId 用于后续第三方推送绑定。([Tencent RTC][2])

验证不同应用状态下的触达
Token 获取成功只能证明注册链路成立,还不能证明最终触达。测试时至少覆盖应用前台、退到后台以及被用户结束后再次打开三个状态,并记录“消息是否收到、是否展示通知、点击后是否进入目标页面”。不同 SDK 版本和系统策略下,后台展示和回调路径可能存在差异,因此测试结果应以实际设备为准。公开集成资料也区分了 Push 能力状态和具体消息回调处理。([Tencent RTC][2])
验证清单
1. 安装测试包并确认 AppID、AppKey 与当前包名对应。
2. 启动应用,确认 initialize 与 turnOnPush 成功。
3. 记录 getRegId() 返回值,并确认服务端已保存。
4. 服务端向该 RegId 发送一条测试消息。
5. 分别测试前台、后台、重新打开应用三种状态。
6. 记录通知展示结果和消息点击后的页面结果。预期结果
注册成功:设备侧得到非空 RegId。
发送成功:服务端能够以该设备标识发起测试消息。
前后台测试:能够观察到实际设备上的通知或消息处理结果,并可据日志判断消息究竟停在注册、发送还是展示阶段。当 vivo Push 出现“有 RegId 但收不到消息”时,不要立即修改业务代码。先确认 AppID/AppKey、设备支持状态、turnOnPush 返回状态、服务端目标 RegId,以及当前应用状态是否一致,再判断是通道问题还是通知展示问题。这样才能把一次厂商推送故障定位到具体链路节点。