免打扰功能概述
即时通讯客户端 SDK 支持多维度、多级别精细化的免打扰设置。
IM 的免打扰设置维度
即时通讯业务支持对免打扰功能进行多维度地控制。开发者可从 App Key、指定细分业务(仅超级群)、用户级别进行免打扰功能配置。
融云服务端会遵照以下优先级搜索免打扰配置,判断当前消息是否需要触发推送:用户级别设置 > 指定超级群频道的默认配置 > 指定超级群会话的默认配置 > App Key 级设置。
提示
客户端 SDK 从 5.3.0 开始提供对以下维度免打扰设置的完整支持。
免打扰配置的维度 | 适用场景 | 说明 | 客户端 API | 服务端 API |
---|---|---|---|---|
App Key 级设置 | 单聊、群聊、超级群 | 以 App Key 为单位,设置整个应用的默认免打扰级别。默认未设置,等同于全部消息都接收通知。该级别的配置暂未在控制台开放,如有需要,请提交工单。 | 客户端 SDK 不提供 API。 | 服务端不提供该 API。 |
指定超级群默认设置 | 仅限超级群业务 | 可为指定的超级群设置默认的免打扰级别。 | 详见「超级群管理」下的设置群/频道默认免打扰。 | 详见「超级群管理」下的设置群/频道默认免打扰 |
指定超级群频道的默认设置 | 仅限超级群业务 | 可为指定的超级群设置默认的免打扰级别。 | 详见「超级群管理」下的设置群/频道默认免打扰。 | 详见「超级群管理」下的设置群/频道默认免打扰 |
用户级设置 | 单聊、群聊、超级群 | 用户级别免打扰设置如下(优先级从高到低):
在融云服务端判断是否需要推送通知时,如存在用户级别免打扰配置,则遵照以上优先级判断是否需要推送。 |