黑名单管理(Electron)
本功能暂仅限于在 Electron 解决方案中使用。
将用户加入黑名单之后,将不再收到对方发来的任何单聊消息。
- 加入黑名单为单向操作,例如:用户 A 拉黑用户 B,代表 B 无法给 A 发消息(错误码
405
)。但 A 向 B 发消息,B 仍然能正常接收。 - 单个用户的黑名单总人数存在上限,具体与计费套餐有关。IM 旗舰版与 IM 尊享版上限为 3000 人,其他套餐详见功能对照表中的服务限制。
- 调用服务端 API 发送单聊消息默认不受黑名单限制。如需启用限制,请在调用 API 时设置
verifyBlacklist
为1
。
加入黑名单
调用 addToBlacklist 将某个用户加入黑名单。
提示
从 SDK 5.4.0 开始支持该接口。本功能暂仅限于在Electron 解决方案中使用。
RongIMLib.addToBlacklist('<userId>').then(res => {
console.log(res.code)
})
参数 | 类型 | 说明 |
---|---|---|
userId | string | 用户 ID |
移出黑名单
调用 removeFromBlacklist 将某个用户移除黑名单。
提示
从 SDK 5.4.0 开始支持该接口。本功能暂仅限于在Electron 解决方案中使用。
RongIMLib.removeFromBlacklist('<userId>').then(res => {
console.log(res.code)
})
参数 | 类型 | 说明 |
---|---|---|
userId | string | 用户 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)
})
参数 | 类型 | 说明 |
---|---|---|
userId | string | 用户 Id |