跳到主要内容

推送服务概述

融云的推送服务是其即时通讯解决方案的一部分，支持多种远程推送功能。

注意

推送功能仅 Android 和 iOS 平台支持，小程序、H5 平台不支持。

推送服务能力​

推送服务的主要能力包括：

  1. 多厂商适配：推送服务已对接小米推送、华为推送、荣耀推送、魅族推送、OPPO 推送、vivo 推送、FCM 推送，支持向各个推送渠道发起远程推送通知。
  2. 离线消息推送：当用户不在线时，服务端能够触发远程推送通知，通过第三方厂商的推送通道将通知递送到用户的设备上，可以保证即时通讯的消息即使在应用关闭的情况下也能及时通知到用户。详见下文离线消息推送通知。
  3. 不落地通知：直接通过服务端 API 向客户端发送远程推送通知，称为不落地通知。不落地通知中不包含任何会话消息，无论客户端 App 是否在前台，所有通知内容始终仅会以通知形式展示在系统通知栏中，用户无法在任何聊天会话中看到不落地通知的内容。详见下文不落地通知。
  4. 自定义推送通知：开发者可以自定义推送通知的内容，包括推送消息的标题、图标、描述等，以适应不同的应用场景。
  5. 多语言适配：支持通过推送模板功能实现多语言推送。服务端会根据 App 用户通过客户端上报的推送语言，从指定推送模板中匹配对应语言的推送内容进行远程推送。
  6. 推送通知的统计和分析：融云可能提供了推送通知的统计和分析工具，帮助开发者了解推送效果，优化推送策略。

离线消息推送通知​

假设用户仅在一台设备上登录，如果主动断开连接（disconnect()）或者应用程序已被用户或系统杀死，融云会认为用户在该客户端离线。用户离线状态下，支持将收到的单聊消息、群聊消息、系统消息、超级群消息通过第三方厂商推送服务发送提醒，该提醒由系统直接弹出，以通知形式展示在通知面板，提示用户收到消息。

用户点击推送通知后再次与融云服务端建立 IM 连接后，SDK 会有如下行为：

  • 自动收到离线期间的单聊、群聊离线消息?。服务端默认缓存 7 天未收取的离线消息。
  • 自动收到离线期间超级群会话中最后一条消息，应用程序需要自行拉取离线期间的历史消息。
提示

应用程序处于后台且活跃时，用户仍处于在线状态，SDK 仍可实时收到会话消息，消息送达过程中不会使用任何推送服务，因此用户设备不会收到来自任何推送服务的通知。如果使用 IMLib，应用程序需要自行调用系统 API 创建并弹出本地通知。如果使用 IMKit，可参考本地通知文档?进行设置。

不落地通知​

融云支持直接通过服务端 API 向客户端发送远程推送通知，称为不落地通知?。不落地通知中不包含任何会话消息，无论客户端 App 是否在前台，所有通知内容始终仅会以通知形式展示在系统通知栏中，用户无法在任何聊天会话中看到不落地通知的内容。

不落地通知始终通过推送通道下发数据，因此依赖应用程序集成第三方厂商推送服务，或者在客户端启用 RongPush。

  • 如果由第三方厂商推送服务发送提醒，该提醒一般由系统直接弹出，以通知形式展示在通知面板，提示用户收到消息。
  • 如果由融云自建推送通道（RongPush）发送提醒，该提醒一般由 SDK 调用系统 API 构建通知后弹出。注意，RongPush 在国内大部分机型上无法存活。建议应用程序集成第三方厂商的推送服务。

不落地通知仅支持通过服务端 API 发送，例如：

目前不支持通过控制台发送不落地通知（仅部分旧账号仍保留该能力）。

无法推送以及推送受限的情况​

  • 因聊天室业务设计特点，仅当聊天室中的用户在线时才会收到聊天室会话中的消息，因此聊天室消息不支持离线消息推送。
  • 客户端在 disconnect 时设置了不允许推送，导致彻底注销用户在融云服务端的登录信息。这种情况下，用户无法通过任何推送通道收到通知。
  • 即使用户的所有移动端设备均已离线，只要用户仍在 Web/PC 端在线，此时融云认为用户在线，默认不会给移动端发送推送通知。如有需要，您可以在控制台免费基础功能页面调整 Web/PC 在线手机端接收 Push 开关设置。
  • 即使用户的移动端应收到推送通知，融云服务端不会向所有已登录过移动端设备均发送推送，仅会向最后一个登录的设备发送推送通知。
  • 已触发第三方厂商推送服务的频率、数量限制。为改善终端用户推送体验，部分第三方推送服务（例如华为、vivo）已对推送消息的分类进行数量和频率管控。建议您充分了解第三方的管理细则。
  • 因超级群业务中普通消息的数量较大，为控制离线推送频率，默认每分钟针对单个用户的单个超级群，每个频道最多产生 1 条推送。默认普通消息累计 2 条时才会触发推送。@ 消息不受此限制。如需调整，详见开通超级群服务。
提示

用户必须至少在设备上连接成功过一次，该设备才能接收推送。

使用推送服务​

如需使用融云的推送服务，应用程序需要完成集成融云推送插件，并在融云控制台配置 Android ApplicationId、iOS Bundle Identifier，和第三方厂商推送通道的各项配置。

在融云控制台配置 Android ApplicationId 和 iOS Bundle Identifier​

融云服务端在向第三方推送通道发送推送数据时，需要使用 App 的应用标识?（Android 应用 ID）。您需要在融云控制台进行配置。

  1. 访问融云控制台应用标识页面（也可从服务管理页面左侧 IM 服务下访问）。

    1. 如您有多个融云应用，请确保在页面顶部应用一栏切换到正确的应用。
    2. 新建的应用默认拥有一个应用标识，您可以创建更多应用表示，最多 5 个。每个应用标识均可设置推送，应用标识之间不共享推送配置。
    3. 在应用标识旁点击设置推送，即可配置 Android 和 iOS 推送。

  2. 在 Android > ApplicationId 一栏填写您的 Android 应用 ID。

    每个 Android 应用均有一个唯一的应用 ID（applicationId），像 Java 软件包名称一样，例如 com.example.myapp。此 ID 可以作为您的应用在设备上和 Google Play 商店中的唯一标识。

    应用 ID 是您在使用 uni-app 云打包 Android 应用时填写的Android 包名。

    如果您有更多关于应用 ID 与包名的疑问，可参见 Android 官方文档。

  3. 在 iOS > Bundle Identifier 一栏填写您的 iOS Bundle Identifier。

    每个 iOS 应用均有一个唯一的 Bundle Identifier，用于标识应用的唯一性。Bundle Identifier 是您在使用 uni-app 云打包 iOS 应用时填写的Bundle ID。

    如果您有更多关于 Bundle Identifier 的疑问，可参见 iOS 创建 AppID。

您还需要在控制台提供调用第三方推送服务端 API 的凭证、第三方厂商推送通道支持的其他个性化配置。具体配置方式详见集成融云推送插件中配置 Android 或 iOS 推送的介绍。

客户端集成方案​

为了使用融云推送功能，您必须集成融云推送插件。请参考集成融云推送插件。

禁用当前设备的推送功能​

IM SDK 默认启用推送功能。如需在当前设备上彻底禁用推送，可以在断开连接时调用 disconnect 方法，参数 disablePush 设置为 true，向融云服务申请禁用推送服务（当前设备），彻底注销用户在融云服务端的登录信息。这种情况下，当前设备将无法通过任何推送通道收到通知。

JavaScript
// 断开连接时禁用推送，disablePush 在第二个参数，第一个参数传 null 即可。
imlib.disconnect(null, true);
最后于 更新