黑名单管理
将用户加入黑名单之后，将不再收到对方发来的任何单聊消息。
- 加入黑名单为单向操作，例如：用户 A 拉黑用户 B，代表 B 无法给 A 发消息（错误码
405）。但 A 向 B 发消息，B 仍然能正常接收。 - 单个用户的黑名单总人数存在上限，具体与计费套餐有关。IM 旗舰版与 IM 尊享版上限为 3000 人，其他套餐详见功能对照表中的服务限制。
- 调用服务端 API 发送单聊消息默认不受黑名单限制。如需启用限制，请在调用 API 时设置
verifyBlacklist为1。
加入黑名单
将指定用户（userId）加入当前用户的黑名单。操作成功后，当前用户仍可向被拉黑的用户发送消息，但被拉黑的用户无法给当前用户发送单聊消息。
[[RCIMClient sharedRCIMClient] addToBlacklist:@"userId" success:^{
} error:^(RCErrorCode status) {
}];
| 参数 | 类型 | 说明 |
|---|---|---|
| userId | NSString | 用户 id |
| successBlock | Block | 添加成功的回调 |
| errorBlock | Block | 添加失败的回调。status 中返回错误码 RCErrorCode。 |
移出黑名单
将指定用户（userId）从当前用户的黑名单中移出。
[[RCIMClient sharedRCIMClient] removeFromBlacklist:@"userId" success:^{
} error:^(RCErrorCode status) {
}];
| 参数 | 类型 | 说明 |
|---|---|---|
| userId | NSString | 用户 id |
| successBlock | Block | 移除成功的回调 |
| errorBlock | Block | 移除失败的回调。status 中返回错误码 RCErrorCode。 |
查询用户是否在黑名单中
根据用户 ID（userId）查询指定用户是否在当前用户的黑名单中。
[[RCIMClient sharedRCIMClient] getBlacklistStatus:@"userId" success:^(int bizStatus) {
} error:^(RCErrorCode status) {
}];
| 参数 | 类型 | 说明 |
|---|---|---|
| userId | NSString | 用户 id |
| successBlock | Block | 查询成功的回调。bizStatus 表示该用户是否在黑名单中。0 表示已经在黑名单中，101 表示不在黑名单中。 |
| errorBlock | Block | 查询失败的回调。status 中返回错误码 RCErrorCode。 |
查询黑名单列表
获取当前用户的黑名单列表。
[[RCIMClient sharedRCIMClient] getBlacklist:^(NSArray *blockUserIds) {
} error:^(RCErrorCode status) {
}];
| 参数 | 类型 | 说明 |
|---|---|---|
| successBlock | Block | 查询成功的回调。blockUserIds 返回 NSArray 类型数据，为已经设置的黑名单中的用户 ID 列表 |
| errorBlock | Block | 查询失败的回调。status 中返回错误码 RCErrorCode。 |