跳到主要内容

集成 vivo 推送

按照本指南集成vivo 推送客户端，融云 SDK 支持从 vivo 推送服务收取推送。

在集成第三方推送前，请确保已在 IM 服务功能配置页面配置 Android 应用 ID。详见推送集成概述。

在内嵌的 IM 服务功能配置页面配置 vivo 推送​

如果想通过 vivo 推送接收融云即时通讯服务的推送通知，您需要在控制台上提供您的 vivo 推送应用的详细信息。

  1. 前往 vivo 开发者平台-推送服务器平台，并记录下 vivo 应用的 AppID、AppKey、AppSecret。

    提示

    如果没有 vivo 开发者账号，或尚未创建应用，参考 vivo 文档 vivo 推送接入流程。

    (width=600)

    (height=400)

  2. 在需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中，进入 离线推送 > 应用标识及推送证书管理 > 设置推送 > Android > vivo 推送，填入上一步获取的 AppID、AppKey、AppSecret。

    (height=400)

  3. （可选）配置推送通知标题。设置默认的推送通知标题。一般情况下客户端发送消息转 Push 时不使用此标题设置。在调用融云服务端 API /push.json、 /push/user.json、/push/custom.json 接口推送通知时，如未传入通知标题，则使用该处设置的标题。从服务端发消息时，如果发送用户 ID 在融云服务端没有用户名，也会使用此 “推送通知标题”。

  4. 配置推送模式。关于正式推送与测试推送的区别，请参考 vivo 文档vivo 推送使用指南。

  5. （可选）配置推送通道类型与 Category（消息二级分类）。如果调用客户端或服务端 API 发送消息或推送通知时未传值，默认使用此处配置的值。请参考 vivo 文档推送消息分类说明进行配置。

  6. 保存设置。所有设置 15 分钟后生效。

您已完成需要控制台 vivo 推送配置的全部内容。现在可以设置客户端集成。

配置客户端接收 vivo 推送​

在 App 的 build.gradle 中添加依赖，并配置 vivo 的 VIVO_APP_ID 和 VIVO_APP_KEY。

Groovy
android {
 defaultConfig {
    //...
    manifestPlaceholders = [
        VIVO_APP_ID : "xxxxxxxxxx",
        VIVO_APP_KEY: "xxxxxxxxxx"
    ]
 }
}
dependencies {
    // x.y.z 为当前 IM SDK 版本号
    implementation 'cn.rongcloud.sdk.push:vivo:x.y.z'
}

启用 vivo 推送服务​

在 SDK init 之前，调用下面代码，初始化 RongPushPlugin 模块。

Java
RongPushPlugin.init(getContext());

如果找不到 RongPushPlugin 模块，请检查是否已经集成融云自建推送通道。

混淆配置​

请在混淆文件中添加以下说明，防止 SDK 内容被二次混淆，自定义回调类切勿混淆。

-dontwarn com.vivo.push.**
-keep class com.vivo.push.**{*; }
-keep class com.vivo.vms.**{*; }
-keep class   xxx.xxx.xxx.PushMessageReceiverImpl{*;}

处理推送通知的点击事件​

  • 自定义推送通知点击事件：介绍如何实现 SDK 的默认跳转行为，以及如何自定义处理点击事件。详见自定义推送通知点击事件。

  • 自定义推送通知样式：SDK 接收到其他第三方厂商的推送后，弹出的通知是系统通知，由手机系统底层直接弹出通知，所以不支持自定义。