开始集成推送(旧版)
融云 SDK 支持集成三方推送通道与融云自建推送通道(RongPush)。
注意
本文适用于 5.6.0 版本之前的 IMLib、IMKit 或其他依赖 IMLib 的融云客户端 SDK。从 5.6.0 版本开始,融云推出集成方式更简单的 Push 2.0 集成方案,欢迎 使用。
推送服务能力
推送支持「离线消息推送」和「不落地通知」两种场景。
离线消息推送通知
假设用户仅在一台设备上登录,如果主动断开连接(disconnect()
)或者应用程序已被用户或系统杀死,融云会认为用户在该客户端离线。用户离线状态下,支持将收到的单聊消息、群聊消息、系统消息、超级群消息通过第三方推送厂商或融云自建的推送服务通知客户端。
- 如果由第三方厂商推送服务发送提醒,该提醒一般由系统直接弹出,以通知形式展示在通知面板,提示用户收到消息。
- 如果由融云自建推送通道(RongPush)发送提醒,该提醒一般由 SDK 调用系统 API 构建通知后弹出。注意,RongPush 在国内大部分机型上无法存活。建议应用程序集成第三方厂商的推送服务。
用户点击推送通知后再次与融云服务端建立 IM 连接后,SDK 会有如下行为:
- 自动收到离线期间的单聊、群聊离线消息?。服务端默认缓存 7 天未收取的离线消息。
- 自动收到离线期间超级群会话中最后一条消息,应用程序需要自行拉取离线期间的历史消息。
注意
应用程序处于后台且活跃时,用户仍处于在线状态,SDK 仍可实时收到会话消息,消息送达过程中不会 使用任何推送服务,因此用户设备不会收到来自任何推送服务的通知。如果使用 IMLib,应用程序需要自行调用系统 API 创建并弹出本地通知。如果使用 IMKit,SDK 默认会调用系统 API 创建并弹出本地通知。
不落地通知
融云支持直接通过服务端 API 向客户端发送远程推送通知,称为不落地通知?。不落地通知中不包含任何会话消息,无论客户端 App 是否在前台,所有通知内容始终仅会以通知形式展示在系统通知栏中,用户无法在任何聊天会话中看到不落地通知的内容。
不落地通知始终通过推送通道下发数据,因此依赖应用程序集成第三方厂商推送服务,或者在客户端启用 RongPush。
- 如果由第三方厂商推送服务发送提醒,该提醒一般由系统直接弹出,以通知形式展示在通知面板,提示用户收到消息。
- 如果由融云自建推送通道(RongPush)发送提醒,该提醒一般由 SDK 调用系统 API 构建通知后弹出。注意,RongPush 在国内大部分机型上无法存活。建议应用程序集成第三方厂商的推送服务。
不落地通知仅支持通过服务端 API 发送,例如:
目前不支持通过控制台发送不落地通知(仅部分旧账号仍保留该能力)。