跳到主要内容

黑名单管理

融云的黑名单功能是指如果您将其他用户的 userId 加入黑名单之后，将不再收到此用户发送给您的任何单聊消息。您需要注意的是：

  • 您将其他用户加入黑名单的操作为单向操作，例如：您通过调用融云 SDK 对应的方法拉黑了用户 A，那么用户 A 就无法给您发送单聊消息，并且用户 A 会收到 405 的错误码提示。但您仍然可以向用户 A 发送消息，用户 A 也可以正常接收。
  • 每个用户的黑名单总人数存在上限，具体的限制与计费套餐有关。IM 旗舰版与 IM 尊享版上限为 3000 人，其他套餐详见功能对照表中的服务限制。
  • 如果您调用服务端 API 发送单聊消息，消息能否送达默认是不受黑名单限制。如需服务端 API 发送单聊消息也要受到黑名单的限制，请您在调用 API 时设置参数 verifyBlacklist 为 1。

加入黑名单​

您可以通过调用 addToBlacklist: 方法将指定用户（userId）加入到您的黑名单中。添加成功后，您仍然可以向被拉黑的用户发送消息，但被拉黑的用户无法给您发送单聊消息。

Objective C
[[RCCoreClient sharedCoreClient] addToBlacklist:@"userId" success:^{

} error:^(RCErrorCode status) {

}];
参数类型说明
userIdNSString需要加入黑名单的用户的 userId
successBlockBlock添加黑名单成功的回调
errorBlockBlock添加黑名单失败的回调。status 中返回错误码 RCErrorCode。

移出黑名单​

您可以通过调用 removeFromBlacklist: 方法将指定用户（userId）从您的黑名单中移出。

接口原型​

Objective C
- (void)removeFromBlacklist:(NSString *)userId
                    success:(nullable void (^)(void))successBlock
                      error:(nullable void (^)(RCErrorCode status))errorBlock NS_SWIFT_NAME(removeFromBlacklist(_:success:error:));

参数说明​

参数类型说明
userIdNSString需要移出黑名单的用户的 userId
successBlockBlock移除黑名单成功的回调
errorBlockBlock移除黑名单失败的回调。status 中返回错误码 RCErrorCode。

示例代码​

Objective C
[[RCCoreClient sharedCoreClient] removeFromBlacklist:@"userId" success:^{

} error:^(RCErrorCode status) {

}];

查询用户是否在黑名单中​

您可以通过调用 getBlacklistStatus: 方法，查询指定的用户 ID（userId）是否在您的黑名单中。

接口原型​

Objective C
- (void)getBlacklistStatus:(NSString *)userId
                   success:(nullable void (^)(int bizStatus))successBlock
                     error:(nullable void (^)(RCErrorCode status))errorBlock;

参数说明​

参数类型说明
userIdNSString需要查询是否在黑名单的用户的 userId
successBlockBlock查询成功的回调。bizStatus 表示被查询的用户是否在黑名单中。0 表示被查询用户已经在黑名单中，101 表示不在黑名单中。
errorBlockBlock查询失败的回调。status 中返回错误码 RCErrorCode。

示例代码​

Objective C
[[RCCoreClient sharedCoreClient] getBlacklistStatus:@"userId"  success:^(int bizStatus) {

} error:^(RCErrorCode status) {

}];

查询黑名单列表​

您可以通过调用 getBlacklist: 方法获取您的黑名单列表。

示例代码​

Objective C
[[RCCoreClient sharedCoreClient] getBlacklist:^(NSArray *blockUserIds) {

} error:^(RCErrorCode status) {

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