tencent cloud

移动推送

产品动态
公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
产品简介
产品概述
产品优势
应用场景
全球化部署
购买指南
价格总览
购买指引
计费模式
免费试用
欠费说明
快速入门
创建产品和应用
Android 快速接入
iOS 快速接入
创建推送任务
查询推送记录
推送测试方法指引
产品限制说明
操作指南
推送管理
推送高级功能
实践教程
iOS 平台角标功能实践
API 文档
简介
API 概览
调用方式
推送相关接口
标签相关接口
账号相关接口
统计相关接口
用户属性相关接口
服务端错误码
服务端 SDK
API(Java)
SDK 文档
Android 接入指南
iOS 接入指南
客户端集成插件
macOS接入指南
用户及权限
快速入门配置
进阶自定义配置
资源标签
服务协议
服务等级协议
开发者协议
常见问题
iOS 常见问题
Android 常见问题
Flutter 常见问题
其他问题
移动推送政策
移动推送隐私协议
TPNS 数据处理和安全协议
Developer Agreement
联系我们
词汇表
文档移动推送

vivo 通道接入

聚焦模式
字号
最后更新时间: 2024-01-16 17:39:39

操作场景

vivo 通道是由 vivo 官方提供的系统级推送通道。在 vivo 手机上,推送消息能够通过 vivo 的系统通道抵达终端,并且无需打开应用,即可收到推送,更多详情请参见 vivo 推送官网
说明:
如遇到 debug 版本点击通知后无法拉起 App,请在权限设置中找到后台弹出界面,并开启当前应用的权限开关。
vivo 通道暂不支持应用内消息,此类型的消息将通过移动推送自建通道下发。
vivo 通道对应用的每日推送量有额度限制,详情请参见 厂商通道限额说明,超过限制部分将走移动推送自建通道进行补推发送。
vivo 通道7:00 - 23:00允许推送消息,其他时间只能推送系统消息,系统消息申请详情请参见 vivo 系统消息申请指南
vivo 通道单应用单用户每天接收运营消息条数上限为5条,系统消息不限接收条数。
vivo 通道仅支持部分较新的机型和对应的系统及以上系统,详情请参见 vivo 推送常见问题汇总

操作步骤

获取密钥

1. 开发者需向 vivo 申请开通推送权限,获取到 AppID 、AppKey、AppSecret 三个密钥参数。详情请参见 快速接入指引
说明:
开发者的应用必须要在 vivo 开放平台通过审核上架后,才会通过消息推送服务审核。
2. 复制应用的 AppId、AppKey 和 AppSecret 参数填入 移动推送控制台>配置管理>基础配置>vivo 官方推送通道栏目中。

配置内容

AndroidStudio 集成方法

在 App 模块下的 build.gradle 文件内,完成移动推送所需的配置后,再增加以下节点:
1. 配置 vivo 的 AppID 和 AppKey。示例代码如下:
manifestPlaceholders = [
VIVO_APPID:"xxxx",
VIVO_APPKEY:"xxxxx",
]
2. 导入 vivo 推送相关依赖。示例代码如下:
implementation 'com.tencent.tpns:vivo:[VERSION]-release' // vivo 推送 [VERSION] 为当前 SDK 版本号,版本号可在 Android SDK 发布动态查看
说明:
vivo 推送 [VERSION] 为当前 SDK 版本号,版本号可在 Android SDK 发布动态 查看。

Eclipes 集成方法

获取移动推送vivo 通道 SDK 包后,按照移动推送官网手动集成方法,在配置好移动推送主版本的基础下,进行以下设置:
1. 下载 SDK 安装包
2. 打开 Other-Push-jar 文件夹, 导入 vivo 推送相关 jar 包。
3. Androidmanifest.xml 文件中,新增如下配置:
<application>
<service
android:name="com.vivo.push.sdk.service.CommandClientService"
android:exported="true"
android:permission="com.push.permission.UPSTAGESERVICE" />
<activity
android:name="com.vivo.push.sdk.LinkProxyClientActivity"
android:exported="false"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!-- push应用定义消息receiver声明 -->
<receiver
android:name="com.tencent.android.vivopush.VivoPushMessageReceiver"
android:exported="false">
<intent-filter>
<!-- 接收push消息 -->
<action android:name="com.vivo.pushclient.action.RECEIVE" />
</intent-filter>
</receiver>
<!-- version 3.0.0.3 -->
<!-- 该字段大于等于480,则表示支持点击消息直接打开应用activity,优化启动慢问题。 -->
<meta-data
android:name="sdk_version_vivo"
android:value="483" />
<meta-data
android:name="local_iv"
android:value="MzMsMzQsMzUsMzYsMzcsMzgsMzksNDAsNDEsMzIsMzgsMzcsMzYsMzUsMzQsMzMsI0AzNCwzMiwzMywzNywzMywzNCwzMiwzMywzMywzMywzNCw0MSwzNSwzNSwzMiwzMiwjQDMzLDM0LDM1LDM2LDM3LDM4LDM5LDQwLDQxLDMyLDM4LDM3LDMzLDM1LDM0LDMzLCNAMzQsMzIsMzMsMzcsMzMsMzQsMzIsMzMsMzMsMzMsMzQsNDEsMzUsMzIsMzIsMzI" />
<!-- version 3.0.0.3 end-->
<meta-data
android:name="com.vivo.push.api_key"
android:value="${VIVO_APPKEY}" />
<meta-data
android:name="com.vivo.push.app_id"
android:value="${VIVO_APPID}" />
</application>


开启 vivo 推送

在调用移动推送 XGPushManager.registerPush 之前,开启第三方推送接口:
//打开第三方推送
XGPushConfig.enableOtherPush(getApplicationContext(), true);


//注册成功的日志如下
I/TPush: [OtherPushClient] handleUpdateToken other push token is : 160612459******08955218 other push type: vivo
I/TPush: [PushServiceBroadcastHandler] >> bind OtherPushToken success ack with [accId = 150000**** , rsp = 0] token = 01a22fb503a33******66b89fad6be3ed343 otherPushType = vivo otherPushToken = 160612459******08955218


代码混淆

-dontwarn com.vivo.push.**
-keep class com.vivo.push.**{*; }
-keep class com.vivo.vms.**{*; }
-keep class com.tencent.android.vivopush.VivoPushMessageReceiver{*;}
说明:
混淆规则需要放在 App 项目级别的 proguard-rules.pro 文件中。

常见问题排查

vivo 推送注册错误码查询方法

若观察到如下类似日志则说明 vivo 厂商通道注册失败,开发者可以通过以下方式获取 vivo 推送注册错误码:
[OtherPushClient] handleUpdateToken other push token is : other push type: vivo
推送服务 debug 模式下,过滤关键字 “OtherPush”,查看相关返回码日志(例如 [OtherPushVivoImpl] vivoPush Register or UnRegister fail, code = 10003),并前往 厂商通道注册失败排查指南 查找对应原因,获取解决办法。

推送 vivo 响应失败 code:10045,是什么原因?

应用审核中不可发送正式消息,请前往 vivo 平台确认推送权限审核进度。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈