跳到主要内容

全局免打扰

SDK 支持为当前用户设置全局免打扰时段与免打扰级别。

  • 该功能可设置一个从任意时间点(HH:MM:SS)开始的免打扰时间窗口。在再次设置或删除用户免打扰时间段之前,当次设置的免打扰时间窗口会每日重复生效。例如,App 用户希望设置永久全天免打扰,可设置 startTime00:00:00period1439
  • 单个用户仅支持设置一个时间段,重复设置会覆盖该用户之前设置的时间窗口。
  • 如果 SDK 版本 < 5.2.2,仅支持设置免打扰时段,不支持同时设置免打扰级别。
提示

在经 SDK 设置的全局免打扰时段内:

  • 如果客户端处于离线状态,融云服务端将不会进行推送通知。
  • 「全局免打扰时段」为用户级别的免打扰设置,且具有最高优先级。在用户设置了「全局免打扰时段」时,均以此设置的免打扰级别为准。

(推荐)在 App 自行实现本地通知处理时,如果检测到客户端 App 已转至后台运行,可通过 SDK 提供的全局免打扰接口决定是否弹出本地通知,以实现全局免打扰的效果。

设置免打扰时段与级别(SDK >= 5.2.2)

从 SDK 5.2.2 开始,为当前用户设置免打扰时间段时,可使用以下免打扰级别:

枚举值数值说明
RCPushNotificationQuietHoursLevelDefault0未设置。如未设置,SDK 会依次查询消息所属群的用户级别免打扰设置及其他非用户级别设置,再判断是否需要推送通知。
RCPushNotificationQuietHoursLevelMention1仅针对 @ 消息进行通知,包括 @指定用户 和 @所有人的消息。
RCPushNotificationQuietHoursLevelBlocked5不接收通知,即使为 @ 消息也不推送通知。

早于 5.2.2 的 SDK 版本仅支持设置为接收或不接收推送通知。

设置免打扰时段与级别

提示

该接口在 RCChannelClient 中,从 5.2.2 版本开始支持。

设置消息通知免打扰时间。在免打扰时间内接收到消息时,会根据该接口设置的免打扰级别判断是否需要推送消息通知。

 [[RCChannelClient sharedChannelManager] setNotificationQuietHoursLevel:@"00:00:00"
spanMins:1439
level:(RCPushNotificationQuietHoursLevel)level
success:^() {} error:^(RCErrorCode status) {}];

参数类型说明
startTimeNSString开始时间,精确到秒。格式为 HH:MM:SS,例如 01:31:17
spanMinsint免打扰时间窗口大小,单位为分钟。支持范围为 [1-1439]。
levelRCPushNotificationQuietHoursLevel
  • 1: 仅针对 @ 消息进行通知,包括 @指定用户 和 @所有人的消息。如果消息所属会话类型为单聊,则代表不通知。
  • 0: 未设置。如未设置,SDK 会依次查询消息所属群的用户级别免打扰设置及其他非用户级别设置,再判断是否需要推送通知。
  • 5:不接收通知,即使为 @ 消息也不推送通知。
successBlockBlock成功回调
errorBlockBlock失败回调。回调参数 status 包含错误码,参见 RCErrorCode

移除免打扰时段与级别

提示

该接口在 RCChannelClient 中,从 5.2.2 版本开始支持。

您可以调用以下方法,将 level 设置为 RCPushNotificationQuietHoursLevelDefault 将免打扰时间段设置移除。

[[RCChannelClient sharedChannelManager] setNotificationQuietHoursLevel:@"00:00:00"
spanMins:1439
level:(RCPushNotificationQuietHoursLevel)level
success:^() {} error:^(RCErrorCode status)

获取免打扰时段与级别

提示

该接口在 RCChannelClient 中,从 5.2.2 版本开始支持。

您可以通过以下方法获取免打扰时间段设置。在免打扰时间内接收到消息时,会根据当前免打扰级别判断是否需要推送消息通知。

[[RCChannelClient sharedChannelManager] getNotificationQuietHoursLevel:^(NSString *startTime, int spanMins, RCPushNotificationQuietHoursLevel level) {

} error:^(RCErrorCode status) {

}];
参数类型说明
successBlockBOOL成功的回调。startTime 为全局免打扰起始时间(格式为 HH:MM:SS)。spanMins 为全局免打扰持续时长(分钟)。level 为设置时传入的 RCPushNotificationQuietHoursLevel
errorBlockBOOL失败的回调。 status 为错误码,参见 RCErrorCode

设置全局免打扰时段(< 5.2.2)

早于 5.2.2 的 SDK 版本仅支持设置免打扰时段。在全局免打扰时间段内接收到消息时,不会有消息提醒。

例外情况:@ 消息为高优先级消息,会跳过全局免打扰逻辑,仍然进行推送通知。

设置全局免打扰时段

提示

该接口在 RCIMClient 中,从 5.2.2 版本开始废弃。

设置全局免打扰时段,以屏蔽所有通知,包括本地通知以及远程推送通知。

[[RCIMClient sharedRCIMClient] setNotificationQuietHours:@"00:00:00"
spanMins:1439
success:^{}
error:^(RCErrorCode status) {}];
参数类型说明
startTimeNSString开始时间,精确到秒。格式为 HH:MM:SS,例如 01:31:17
spanMinsint免打扰时间窗口大小,单位为分钟。支持范围为 [1-1439]。
successBlockBOOL成功的回调
errorBlockBOOL失败的回调。回调参数 status 包含错误码,参见 RCErrorCode

获取全局免打扰时段

提示

该接口在 RCIMClient 中,从 5.2.2 版本开始废弃。

通过以下方法,可以获取当前应用设置的静默时间。

[[RCIMClient sharedRCIMClient] getNotificationQuietHours:^(NSString *startTime, int spanMins) {

} error:^(RCErrorCode status) {

}];
参数类型说明
successBlockBOOL成功的回调。startTime 为全局免打扰开始时间(格式为 HH:MM:SS)。spanMins 为全局免打扰持续时长(分钟)。
errorBlockBOOL失败的回调。 status 为错误码,参见 RCErrorCode

取消全局免打扰时段

提示

该接口在 RCIMClient 中,从 5.2.2 版本开始废弃。

通过以下方法移除之前设置的通知静默时间,移除成功后,会正常收到本地通知或推送通知。

[[RCIMClient sharedRCIMClient] removeNotificationQuietHours:^{

} error:^(RCErrorCode status) {

}];
参数类型说明
successBlockBOOL成功的回调。
errorBlockBOOL失败的回调。 status 为错误码,参见 RCErrorCode