跳到主要内容

版本:5.X

黑名单管理(Electron)

本功能暂仅限于在 Electron 解决方案中使用。

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

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

加入黑名单

调用 addToBlacklist 将某个用户加入黑名单。

提示

从 SDK 5.4.0 开始支持该接口。本功能暂仅限于在Electron 解决方案中使用。

RongIMLib.addToBlacklist('<userId>').then(res => {
console.log(res.code)
})
参数类型说明
userIdstring用户 ID

移出黑名单

调用 removeFromBlacklist 将某个用户移除黑名单。

提示

从 SDK 5.4.0 开始支持该接口。本功能暂仅限于在Electron 解决方案中使用。

RongIMLib.removeFromBlacklist('<userId>').then(res => {
console.log(res.code)
})
参数类型说明
userIdstring用户 Id

获取黑名单列表

调用 getBlacklist 获取黑名单列表。

提示

从 SDK 5.4.0 开始支持该接口。本功能暂仅限于在Electron 解决方案中使用。

RongIMLib.getBlacklist().then(res => {
console.log(res)
})

查询用户是否在黑名单中

调用 getBlacklistStatus 获取指定人员是否在黑名单中。

提示

从 SDK 5.4.0 开始支持该接口。本功能暂仅限于在Electron 解决方案中使用。

RongIMLib.getBlacklistStatus('<userId>').then(res => {
console.log(res)
})
参数类型说明
userIdstring用户 Id