跳到主要内容

黑名单管理

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

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

加入黑名单

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

RongIMClient.getInstance().addToBlacklist(userId, callback);
参数类型说明
userIdString用户 ID
callbackOperationCallback回调接口

移出黑名单

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

RongIMClient.getInstance().removeFromBlacklist(userId, callback);
参数类型说明
userIdString用户 ID
callbackOperationCallback回调接口

查询用户是否在黑名单中

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

RongIMClient.getInstance().getBlacklistStatus(userId,
new ResultCallback<BlacklistStatus>() {
@Override
public void onSuccess(BlacklistStatus blacklistStatus) {
}

@Override
public void onError(ErrorCode e) {
}
});

BlacklistStatus 枚举值:

  • 在黑名单中:IN_BLACK_LIST(0)
  • 不在黑名单中:NOT_IN_BLACK_LIST(1)

获取黑名单列表

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

RongIMClient.getInstance()
.getBlacklist(
new GetBlacklistCallback() {
@Override
public void onSuccess(String[] strings) {
}

@Override
public void onError(ErrorCode e) {
}
});