设置会话免打扰
- 本文仅描述了 SDK 版本 < 5.2.2 时,使用
RCIMClient
下接口设置免打扰的方法。- 如果 SDK 版本 ≧ 5.2.2,推荐使用
RCChannelClient
下支持设置免打扰级别的全局免打扰接口。请移步至 IMLib 文档按会话设置免打扰。
即时通讯服务支持会话免打扰设置。IMKit SDK 可根 据会话类型、会话 ID 设置消息提醒状态为「免打扰」。设置后如果客户端在后台运行时,会话中有新的消息,将不会进行通知提醒,可以收到消息内容。如果客户端为离线状态,将不会收到远程通知提醒。
会话的免打扰状态将会被同步到服务端。融云会为用户自动在设备间同步会话免打扰状态数据。客户端可以通过监听器获取同步通知,也可以主动获取最新数据。
设置会话的免打扰状态(< 5.2.2)
RCIMClient
类提供 setConversationNotificationStatus
方法,可根据会话类型、会话 ID 设置消息提醒状态为「免打扰」。设置成功后,客户端在后台运行时或处于用户离线状态时,均不会收到该会话的新消息通知。修改完成后,您可以主动重新获取数据源刷新 UI。
IMKit SDK 未直接提供该方法,您需要使用 IMLib 中获取会话免打扰状态的方法。
[[RCIMClient sharedRCIMClient] setConversationNotificationStatus:ConversationType_PRIVATE
targetId:self.userId
isBlocked:YES
success:^(RCConversationNotificationStatus nStatus) {}
error:^(RCErrorCode status){}];
参数 | 类型 | 说明 |
---|---|---|
conversationType | RCConversationType | 会话类型,单聊传入 ConversationType_PRIVATE |
targetId | NSString | 会话 ID |
isBlocked | BOOL | 是否屏蔽消息提醒 |
successBlock | BOOL | 设置成功的回调 |
errorBlock | BOOL | 设置失败的回调。回调参数 status 包含错误码,参见 RCErrorCode。 |