超级群免打扰功能概述
「免打扰功能」用于控制用户在客户端设备离线时,是否可针对离线消息接收推送通知。
- 客户端为离线状态:会话中有新离线消息时,用户默认通过推送通道收到消息且默认弹出通知。设置免打扰后,融云服务端不会为相关消息触发推送。
- 客户端在后台运行:会话中有新消息时,用户直接收到消息。如果使用 IMLib,您需要自行判断 App 是否在后台运行,并根据业务需求自行实现本地通知弹窗。
前提条件
请在使用「免打扰功能」前检查是否已集成第三方推送,是否已为用户启用了推送服务。
免打扰设置维度
客户端 SDK 支持超级群业务进行以下多个维度的免打扰设置:
- App 的免打扰设置
- 按超级群或频道设置默认免打扰级别
- 按指定会话类型设置免打扰级别
- 按会话设置免打扰级别
- 按超级群频道设置免打扰级别
- 全局免打扰
注意
超级群离线消息推送通知还会收到控制台超级群默认推送频率设置影响。详见开通超级群服务。
App 的免打扰设置
以 App Key 为单位,设置整个应用所有用户的默认免打扰级别。默认未设置,等同于全部消息都接收通知。该级别的配置暂未在控制台开放,如有需要,请提交工单。
- 全部消息均通知:当前 App 下的用户可针对任何消息接收推送通知。
- 未设置:默认全部消息都通知。
- 仅 @ 消息通知:当前 App 下的用户仅针对提及(@)当前用户和提及所在群组全体成员的消息接收推送通知。
- 仅 @ 指定用户通知:当前 App 下,用户仅针对提及(@)当前用户的消息接收推送通知。例如:仅张三会接收且仅接收 “@张三 Hello” 的消息的通知。
- 仅 @群全员通知:当前 App 下,用户仅针对提及(@)群组全体成员的消息接收推送通知。
- 都不接收通知:当前 App 下,用户不针对任何消息接收推送通知,即任何离线消息都不会触发推送通知。
- 除 @ 消息外群聊消息不发推送:当前 App 下,用户针对单聊消息、提及(@)指定用户的消息、和提及(@)群组全体成员的消息接收推送通知。
融云服务端判断是否需要推送时,如果存在以下任何一种用户级别的免打扰配置,以用户级别配置为准:
- 按指定会话类型设置免打扰级别
- 按会话设置免打扰级别
- 全局免打扰
如果不存在用户级别配置,则以消息所属超级群/频道的默认免打扰级别为准。App 级别的免打扰配置的优先级最低。