离线推送概述

即时通讯 IM 支持集成 APNs 消息推送服务，为 iOS 开发者提供低延时、高送达、高并发、不侵犯用户个人数据的离线消息推送服务。

要体验离线推送功能，请点击这里下载即时通讯 IM 的 demo。

离线推送过程

客户端断开连接或应用进程被关闭等原因导致用户离线时，即时通讯 IM 会通过 APNs 消息推送服务向该离线用户的设备推送消息通知，暂时保存这些消息。当用户再次上线时，服务器会将离线期间的消息发送给用户（这里角标表示的是离线消息数，并不是实际的未读消息数）。例如，当你离线时，有用户向你发送了消息，你的手机的通知中心会弹出消息通知，当你再次打开 app 并登录成功，即时通讯 IM SDK 会主动拉取你不在线时的消息。

除了满足用户离线条件外，要使用第三方离线推送，你还需在环信即时通讯云控制台配置推送证书信息，例如，对于华为推送，需配置证书名称和推送密钥，并调用客户端 SDK 提供的 API 向环信服务器上传 device token。

以下两种情况，即时通讯 IM 不会发送离线推送通知：

1. 若应用在后台运行，则用户仍为在线状态，即时通讯 IM 不会向用户推送消息通知。

2. 应用在后台运行或手机锁屏等情况，若客户端未断开与服务器的连接，则即时通讯 IM 不会收到离线推送通知。

离线推送高级功能

如果需要离线推送的高级功能，需在环信即时通讯控制台的即时通讯 > 功能配置 > 功能配置总览页面激活。高级功能包括推送通知方式、免打扰模式和推送模板。如需关闭推送高级功能必须联系商务，因为该操作会删除所有相关配置。

多设备离线推送策略

多设备登录时，可在环信即时通讯控制台的证书管理页面配置推送策略，该策略配置对所有推送通道生效：

• 所有设备离线时，才发送推送消息；
• 任一设备离线时，都发送推送消息。

注意：多端登录时若有设备被踢下线，即使接入了 IM 离线推送，也收不到离线推送消息。

技术原理

消息推送流程如下：

1. 用户 B 向 APNs 推送服务注册，获取推送 token。
2. APNs 返回推送 token。
3. 用户 B 向环信服务器上传推送证书名称和推送 token。
4. 用户 A 向 用户 B 发送消息。
5. 环信服务器检查用户 B 是否在线。若在线，环信服务器直接将消息发送给用户 B。
6. 若用户 B 离线，环信服务器判断该用户是否使用了 APNs 推送。
7. 环信服务器将消息发送给 APNs 推送服务器。
8. APNs 推送服务器将消息发送给用户 B。

提示

推送 token（device token）是 APNs 推送提供的推送 token，即初次启动你的应用时，APNs SDK 为客户端应用实例生成的推送 token。该 token 用于标识每台设备上的每个应用，APNs 通过该 token 明确消息是发送给哪个设备的，然后将消息转发给设备，设备再通知应用程序。你可以调用 registerForRemoteNotifications 方法获得 token。另外，如果退出即时通讯 IM 登录时不解绑 device token（调用 logout 方法时对 aIsUnbindDeviceToken 参数传 NO 表示不解绑 device token，传 YES 表示解绑 token），用户在推送证书有效期和 token 有效期内仍会接收到离线推送通知。

前提条件

使用 APNs 推送前，确保满足以下条件：

• 完成 SDK 初始化，并连接到服务器，详见 快速开始。
• 了解环信即时通讯 IM API 的使用限制，详见 使用限制。
• 若使用推送高级功能，需在环信即时通讯控制台上激活。