跳转至

vivo

前期准备

在进行 vivo 推送适配之前,请确保您已经按照融云 Push 集成文档集成了融云 SDK;这是对 vivo 设备进行特殊适配的前提条件。

  1. 前往 vivo 开发者平台 注册账号并进行认证。

  2. 开发者身份认证后,进入 vivo 开发者平台-推送服务器平台 创建应用,并记录下应用的 AppID、AppKey。

  3. 登录融云开发者后台在 应用标识 中设置 Android 第三方推送,将第 2 步获取的 AppID 和 AppKey 填入 vivo 推送设置项并保存。

接入流程

导入推送 jar 包

进入 vivo 文档中心,下载 Push SDK 接入文档。将解压后的 libs 文件夹中 vivo_pushsdk-VERSION.jar ( VERSION 为版本名称) 拷贝到您的工程的 libs 文件夹中。

添加配置文件

在当前工程的 AndroidManifest.xml 文件中添加权限和声明信息,详见:

<!-- 推送需要的权限列表 -->   		
<uses-permission android:name="android.permission.INTERNET"/>

<!-- vivo 推送服务需要配置的 service、activity -->		
<service   		
    android:name="com.vivo.push.sdk.service.CommandClientService"   		
	android:exported="true"/>   	
<activity   		
	android:name="com.vivo.push.sdk.LinkProxyClientActivity"   	
	android:exported="false"   	
	android:screenOrientation="portrait"   	
	android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

<!-- vivo push 推送 receiver 声明 -->   		
<receiver android:name="io.rong.push.platform.vivo.VivoPushMessageReceiver" >   		
	<intent-filter>   	
		<!-- 接收 vivo push 消息 -->   
		<action android:name="com.vivo.pushclient.action.RECEIVE" />   
	</intent-filter>   	
</receiver>

并在 AndroidManifest.xml 文件中添加 vivo 推送配置项,将 vivo 推送平台生成的 AppID、AppKey 填入 vivo 推送配置项中

<!-- vivo 推送配置项 -->   		
<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 推送。

PushConfig.Builder builder = new PushConfig.Builder();
builder.enableVivoPush(true);
RongPushClient.setPushConfig(builder.build());

注:若同时使用其他推送请在 builder 中启用其他推送,若使用旧版本的 RongPushClient 的 register 方式启用的推送,请改用此 RongPushClient#setPushConfig 方式由 builder 启用推送。

推送通道选择策略

由于并非所有的 vivo 手机都支持 vivo 推送,所以仅在支持的手机上使用 vivo 推送,在不支持的手机上使用融云默认推送。

由于融云推送属于应用级别的推送,会受系统各种权限限制,我们建议您在使用时,在设置里打开自启动权限和通知权限,或者勾选“信任此应用”等,以提高推送到达率。

常见问题

接收 vivo 推送需要用户的 vivo 手机开启应用的通知权限。

关于 vivo 推送相关的内容,包括适用推送的时间和支持的手机型号请参考 vivo 开发平台的 vivo 推送服务指南