免打扰

免打扰控制“这条会话要不要提醒”。IMLib 提供三级设置:单会话级别、会话类型默认级别、全局通知开关;优先级为 单会话 > 会话类型 > 全局。设置保存在服务端,多端同步。

三个级别​

级别值行为设置入口
全部提醒0新消息展示通知、红点与角标默认
仅 @ 提醒1仅被 @ 时提醒;红点保留按会话设置 / 按类型设置
免打扰2不展示通知与红点,保留数字同上

优先级​

Text
单会话设置(setConversationNotificationLevel)
  └─ 覆盖 会话类型默认(setConversationTypeNotification)
        └─ 覆盖 全局默认(客户端本地通知开关)

多端与本地​

  • 单会话级别与会话类型级别保存在服务端,多端同步;本端修改后其它端收到 `CONVERSATION` 事件并刷新。
  • 全局通知开关是设备级设置(系统通知权限 + 应用内开关),不上传服务端。
  • IMKit 组件通过 `muted` 属性渲染静音图标与灰点;未读数仍保留。
  • 聊天室消息通常不进入会话列表,免打扰策略由聊天室场景单独配置。

拆分页:按会话设置、按会话类型设置、多端同步与冲突。