离线推送概述
离线推送概述
即时通讯 IM 支持集成第三方消息推送服务，用于在用户离线时向移动端设备发送消息通知。即时通讯 IM Web SDK 本身不支持离线推送，只支持对移动端离线推送进行配置，例如上传推送 Token、设置全局或会话级免打扰、查询推送配置以及设置推送语言。
离线推送过程
当客户端断开连接、应用进程关闭，或其他原因导致用户离线时，即时通讯 IM 会通过已接入的第三方推送通道向该离线用户的设备发送通知。用户重新上线后，SDK 会从服务端同步离线期间产生的消息。通知栏角标通常表示离线期间累计的通知数量，并不等同于应用内实际未读消息数。详情请参见 Android 和 iOS 平台的离线推送文档。
以下两种情况，即时通讯 IM 不会发送离线推送通知：
- 应用处于前台或虽在后台但客户端仍保持在线连接时，用户仍被视为在线，不触发离线推送。
- 应用在后台运行、锁屏或进入挂起状态，但客户端尚未与服务器断开连接时，也不会触发离线推送。
上传推送证书
除了满足用户离线条件外，要使用第三方离线推送，还需要在环信控制台中完成推送证书或通道参数配置，详见 Android 推送 和 APNs 推送 文档中各厂商证书配置说明。
在 SDK 中，推送 Token 的上传由 client.pushManager.uploadPushToken 完成。调用前应先完成 SDK 初始化和登录，并确保已经拿到厂商推送通道分配的 deviceToken。deviceId 用于标识当前设备，notifierName 对应控制台中配置的推送证书名称或通道标识。
await client.pushManager.uploadPushToken({
deviceId: 'device-id', // 设备 ID，用于标识设备。
deviceToken: 'push-token-from-fcm-or-apns', // 推送 token，用于标识每台设备上的每个应用。
notifierName: 'your-push-certificate-name', // 推送服务的证书名称。
});
推送高级功能
开通功能
推送通知方式、免打扰模式 和 推送模板 属于推送相关的高级功能。使用前，你需要在 环信控制台 免费开通。激活后，如需关闭推送高级功能，必须联系商务，因为该操作会删除高级功能相关的所有配置。
- 登录 环信控制台。
- 选择页面上方的 应用管理。在弹出的应用列表页面，单击你的应用的 操作 栏中的 管理。
- 选择 增值服务 > 消息推送 > 离线推送。
- 点击 免费开通。
推送通知方式
推送通知方式包含以下三种类型：
ALL：接收所有离线消息的推送通知。AT：仅接收提及当前用户的消息的推送通知。NONE：不接收离线消息的推送通知。
你可以设置全局或单聊/群聊会话级别的推送通知方式。会话级别的设置优先于全局级别设置；如果清除会话级设置，该会话会恢复继承全局设置。
更多详情，请参见 推送通知方式介绍。
免打扰模式
完成 SDK 初始化并成功登录后，你可以对全局以及单聊/群聊会话设置免打扰模式。
- 支持设置一次性免打扰时长（例如，30 分钟）。
- 支持设置每日循环生效的免打扰时间段（例如，8:0-10:0）。
- 支持设置全局级别和单聊/群聊会话级别的免打扰模式。
- 若在免打扰模式下需要对指定用户推送消息，需设置强制推送。
更多详情，请参见 免打扰模式介绍。
推送模板
推送模板主要用于当服务端提供的默认离线推送内容不满足需求时，配置全局范围的推送标题和推送内容。推送模板包括默认模板 default、detail 和自定义模板，你可以在 环信控制台 中进行配置。
推送模板的配置和使用，详见 相关文档介绍。
多设备离线推送策略
多设备登录时，可在 环信控制台 的 证书管理 页面配置推送策略，该策略对所有推送通道生效：
- 所有设备离线时，才发送推送消息；
- 任一设备离线时，都发送推送消息。
多端登录时若有设备被踢下线，即使已接入 IM 离线推送，也收不到离线推送消息。
Web 端可设置的功能
环信 IM Web SDK 主要支持对移动端离线推送进行如下配置：
- 上传推送 Token：
- 设置推送通知，包括推送通知方式和免打扰模式：
- 设置全局推送通知；
- 获取全局推送通知设置；
- 设置会话推送通知；
- 获取单个或多个会话的推送通知设置；
- 清除会话推送通知方式的设置，使其恢复继承全局配置。
- 查询已设置推送通知方式的会话列表。
- 设置推送语言。
- 设置推送模板。
- 设置推送扩展功能：包括强制推送和发送静默消息。