Vivo Push

vivo推送服务于2023年4月3日起，针对不同应用类别的消息进行统一管理。

1. 集成SDK

步骤: 注册开发者账号 - 创建应用 - 申请推送服务(获取到app id等) - 集成SDK即可；注意：vivo推送服务SDK支持的最低android版本为Android 6.0

1. 在android项目app目录下的build.gradle中添加aar依赖

dependencies {
  implementation fileTree(include: ['*.jar'],   dir: 'libs')
  implementation   files("libs/vivo_pushsdk-3.0.0.0.aar")
}

2. 添加权限(vivo Push集成只需要配置网络权限)；配置appid 、api key等信息

vivo Push集成需要配置对应的appid 、app key信息，其中appid 和app key是在开发者平台中申请的

<!--Vivo Push开放平台中应用的appid 和api key--> 
<meta-data 
   android:name="com.vivo.push.api_key" 
   android:value="xxxxxxxx"/> 

<meta-data 
   android:name="com.vivo.push.app_id" 
   android:value="xxxx"/>

3. 启动推送
   在工程的Application中，添加以下代码，用来启动打开push开关，成功后即可在通知消息到达时收到通知。

// 初始化push
PushClient.getInstance(getApplicationContext()).initialize(); 

// 打开push开关, 关闭为turnOffPush，详见api接入文档
PushClient.getInstance(getApplicationContext()).turnOnPush(new IPushActionListener() { 
    @Override
    public void onStateChanged(int state) { 
       // TODO: 开关状态处理， 0代表成功
    } 
});

4. 获取token
   即获取regId，使用PushClient.getInstance(context).getRegId() 函数获取；

   在 Api 接口 turnOnPush回调成功之后，即可获取到注册id。

5. 点击通知消息
   服务端Api 字段 skipType 跳转类型分别是： 1 是打开App 首页， 2 是打开特定Url 网址页面， 3 是打开自定义页面。
   打开App首页或者打开自定义页面，是通过VIVO手机通知中心跨应用启动Activity来实现，需要App保证被拉起的目标Activity exported属性默认设置为true，无权限配置，可以在点击通知时打开指定的Activity。

PS:

1. vivo推送服务的客户端 SDK 集成非常简单，仅需一位工程师 0.5 天的时间即可完成客户端 SDK 的集成。，这句话是vivo官方说的：）
2. vivo推送服务SDK支持的最低android版本为Android 6.0
3. 当通过"自定义/打开应用页面"方式启动应用内Activity时，该Activity在AndroidManifest.xml必须配置属性android:exported="true"

2. 常见问题

• 推送标题和内容支持添加emoji表情
  开发者可在新建推送输入推送标题和内容时，插入emoji表情（分别最多不超过3个）以丰富推送内容，吸引用户点击了解推送内容

• 应用每天可以发送的消息数量是多少？
  平台消息类型分为两类——按消息类型是否与用户强相关将消息分为“运营消息”和“系统消息”。用户单应用每日运营消息接收条数上限5条，系统消息无限制

• 手机晚上无法收到推送？在限制时间之外发送推送，是会延迟推送还是被直接抛弃？
  为避免造成用户打扰，目前vivo手机接收的消息为7:00-23:00，服务器允许推送时间为7:00-23:00，系统消息不受此时间限制。

• 跳转配置打开应用页面和自定义键值对的示例是什么？

• vivo通知栏消息展示样式是否可自定义？
  注： 在vivopush中，由于通知栏是由vivo服务框架弹出，因此图标均不可自定义。

3. 参考

1. vivo推送简介
2. 异常问题处理
3. Android PUSH-SDK集成指南
4. vivo推送使用指南：推送统计，在线诊断等
5. 推送消息分类说明：“系统消息”、“运营消息”两大类
6. 服务端API接口文档
7. 【桌面图标角标】适配说明