tencent cloud

即时通信 IM

Unity

Download
聚焦模式
字号
最后更新时间: 2026-08-06 17:28:59

Chat 功能描述

如果您需屏蔽某人的消息,可以把该用户拉入黑名单。

黑名单

拉黑某人

您可以调用 FriendshipAddToBlackList (Details) 接口把该用户加入黑名单,即拉黑该用户。
被拉黑的用户默认不会感知到被拉黑的状态,消息发送后不会返回已被对方拉黑的错误码。
如果您希望被拉黑的用户在发消息时返回已被对方拉黑的发送失败提示,可以登录 控制台 > Chat > 功能配置 > 好友,设置黑名单用户消息发送展示。选择展示发送失败,被拉黑用户发消息后会提示失败,SDK 会报 错误码 20007
// 将用户添加到黑名单
List<string> param = new List<string>
{
"user_id"
};
TIMResult res = TencentIMSDK.FriendshipAddToBlackList(param, (int code, string desc, List<FriendResult> result, string user_data)=>{
// 处理异步逻辑
});

解除拉黑

从黑名单中移除对方后可再次接收对方的消息,可调用 FriendshipDeleteFromBlackList (Details)。

// 将用户从黑名单中移除
List<string> param = new List<string>
{
"user_id"
};
TIMResult res = TencentIMSDK.FriendshipDeleteFromBlackList(param, (int code, string desc, List<FriendResult> result, string user_data)=>{
// 处理异步逻辑
});

获取黑名单列表

您可以通过 FriendshipGetBlackList (Details) 查看已拉黑多少用户,并对黑名单人员进行管理。
// 获取黑名单列表
TIMResult res = TencentIMSDK.FriendshipGetBlackList((int code, string desc, List<FriendProfile> result, string user_data)=>{
// 处理异步逻辑
});


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈