跳到主要内容

黑名单管理

将用户加入黑名单之后,将不再收到对方发来的任何单聊消息。

  • 加入黑名单为单向操作,例如:用户 A 拉黑用户 B,代表 B 无法给 A 发消息(错误码 405)。但 A 向 B 发消息,B 仍然能正常接收。
  • 单个用户的黑名单总人数存在上限,具体与计费套餐有关。IM 旗舰版与 IM 尊享版上限为 3000 人,其他套餐详见功能对照表中的服务限制
  • 调用服务端 API 发送单聊消息默认不受黑名单限制。如需启用限制,请在调用 API 时设置 verifyBlacklist1

加入黑名单

将指定用户(userId)加入当前用户的黑名单。操作成功后,当前用户仍可向被拉黑的用户发送消息,但被拉黑的用户无法给当前用户发送单聊消息。

[[RCIMClient sharedRCIMClient] addToBlacklist:@"userId" success:^{

} error:^(RCErrorCode status) {

}];
参数类型说明
userIdNSString用户 id
successBlockBlock添加成功的回调
errorBlockBlock添加失败的回调。status 中返回错误码 RCErrorCode

移出黑名单

将指定用户(userId)从当前用户的黑名单中移出。

[[RCIMClient sharedRCIMClient] removeFromBlacklist:@"userId" success:^{

} error:^(RCErrorCode status) {

}];
参数类型说明
userIdNSString用户 id
successBlockBlock移除成功的回调
errorBlockBlock移除失败的回调。status 中返回错误码 RCErrorCode

查询用户是否在黑名单中

根据用户 ID(userId)查询指定用户是否在当前用户的黑名单中。

[[RCIMClient sharedRCIMClient] getBlacklistStatus:@"userId"  success:^(int bizStatus) {

} error:^(RCErrorCode status) {

}];
参数类型说明
userIdNSString用户 id
successBlockBlock查询成功的回调。bizStatus 表示该用户是否在黑名单中。0 表示已经在黑名单中,101 表示不在黑名单中。
errorBlockBlock查询失败的回调。status 中返回错误码 RCErrorCode

查询黑名单列表

获取当前用户的黑名单列表。

[[RCIMClient sharedRCIMClient] getBlacklist:^(NSArray *blockUserIds) {

} error:^(RCErrorCode status) {

}];
参数类型说明
successBlockBlock查询成功的回调。blockUserIds 返回 NSArray 类型数据,为已经设置的黑名单中的用户 ID 列表
errorBlockBlock查询失败的回调。status 中返回错误码 RCErrorCode