跳到主要内容

开始集成推送 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());
提示

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