黑名单管理
将用户加入黑名单之后,将不再收到对方发来的任何单聊消息。
- 加入黑名单为单向操作,例如:用户 A 拉黑用户 B,代表 B 无法给 A 发消息(错误码
405
)。但 A 向 B 发消息,B 仍然能正常接收。 - 单个用户的黑名单总人数存在上限,具体与计费套餐有关。IM 旗舰版与 IM 尊享版上限为 3000 人,其他套餐详见功能对照表中的服务限制。
- 调用服务端 API 发送单聊消息默认不受黑名单限制。如需启用限制,请在调用 API 时设置
verifyBlacklist
为1
。
加入黑名单
将指定用户(userId
)加入当前用户的黑名单。操作成功后,当前用户仍可向被拉黑的用户发送消息,但被拉黑的用户无法给当前用户发送单聊消息。
RongIMClient.getInstance().addToBlacklist(userId, callback);
参数 | 类型 | 说明 |
---|---|---|
userId | String | 用户 ID |
callback | OperationCallback | 回调接口 |
移出黑名单
将指定用户(userId
)从当前用户的黑名单中移出。
RongIMClient.getInstance().removeFromBlacklist(userId, callback);
参数 | 类型 | 说明 |
---|---|---|
userId | String | 用户 ID |
callback | OperationCallback | 回调接口 |
查询用户是否在黑名单中
根据用户 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) {
}
});