跳到主要内容

开始集成推送 2.0

融云 Push 2.0 推送集成方案（要求 IMLib SDK ≧ 5.6.0）将第三方厂商推送通道的 SDK 封装成插件，方便开发者快速集成与配置，适用于 IMLib、IMKit 或其他依赖 IMLib 的融云 Android 客户端 SDK。

提示

如果您的应用需要自行集成第三方厂商推送客户端，或需要使用推送集成商的 SDK（例如个推、极光等），则本集成方案不适用。详见解决推送客户端冲突。

集成第三方推送​

目前融云 Push 2.0 集成方案（要求 IMLib SDK ≧ 5.6.0）已适配了小米、华为、荣耀、魅族、OPPO、vivo、FCM 推送服务。由于国内手机厂商的限制，融云自建推送通道（RongPush）在国内大部分机型上无法存活。您可以优先选择集成第三方推送。

解决第三方推送客户端冲突​

如果您的应用或应用依赖的其他 SDK 已集成第三方推送客户端，此时无法再按上述步骤集成融云 Push 2.0 SDK，否则会发生冲突。

在参照集成第三方推送完成融云控制台的的配置后，您需要自行将第三方厂商推送服务的 Token 上报给融云服务端。详细步骤参见解决推送客户端冲突。

集成融云自建推送通道​

融云自建推送通道（RongPush）是融云客户端 SDK 与融云推送服务之间维护的一条稳定可靠的长连接通道。属于 SDK 默认推送，不需要额外集成其它三方库即可拥有的基础推送能力。

SDK 初始化启用推送功能后，则自动启用融云自建推送通道（RongPush），App 即具备了基本推送能力，由于国内手机厂商的限制，RongPush 在国内大部分机型上无法存活。建议同时集成第三方推送通道。

配置 build.gradle。

android {
 defaultConfig {
    //...
    manifestPlaceholders = [
        //启用 rongpush，如不需要 RongPush 也可以禁用
        RONG_PUSH_ENABLE : "true"
    ]
 }
}
dependencies {
    // x.y.z 为当前 IM SDK 版本号
    implementation 'cn.rongcloud.sdk.push:rong:x.y.z'
}

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

RongPushPlugin.init(getContext());
提示

由于融云默认推送通道属于应用级别的推送，会受系统各种权限限制，建议提示用户打开对应权限，以提高推送到达率。