tencent cloud

文档反馈

Android & iOS & Mac

最后更新时间:2022-11-28 16:40:30

    功能描述

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

    黑名单

    拉黑某人

    您可以调用 addToBlackList (Android / iOS & Mac / Windows) 接口把某用户加入黑名单,即拉黑该用户。
    如果您事先调用 addFriendListener 添加了监听器,拉黑后会触发 onBlackListAdded 回调。

    说明:

    如果用户 A 与用户 B 之间存在好友关系,拉黑后会解除双向好友关系,二者之间无法发起会话、无法发起加好友请求。

    被拉黑的用户默认不会感知到 “被拉黑” 的状态,消息发送后不会返回已被对方拉黑的错误码。
    如果您希望被拉黑的用户在发消息时返回 ”已被对方拉黑“ 的错误提示,可以登录 即时通信 IM 控制台 关闭 “黑名单检查”。关闭后,被拉黑的用户在发送消息时,SDK 会报 20007 错误码。配置页面路径为:

    示例代码如下:

    List<String> userIDList = new ArrayList<>();
    userIDList.add("user1");
    userIDList.add("user2");
    V2TIMManager.getFriendshipManager().addToBlackList(userIDList, new V2TIMValueCallback<List<V2TIMFriendOperationResult>>() {
     @Override
     public void onSuccess(List<V2TIMFriendOperationResult> v2TIMFriendOperationResults) {
       // 拉黑成功
     }
      @Override
     public void onError(int code, String desc) {
       // 拉黑失败
     }
    });
    // 监听黑名单列表新增通知
    V2TIMManager.getFriendshipManager().addFriendListener(new V2TIMFriendshipListener() {
     @Override
     public void onBlackListAdd(List<V2TIMFriendInfo> infoList) {
       // 黑名单列表新增通知
     }
    });
    

    解除拉黑

    您可以调用 deleteFromBlackList (Android / iOS & Mac / Windows) 将某用户从黑名单中移除,移除后可正常发起加好友请求、发起会话。
    如果您事先调用 addFriendListener 添加了监听器,解除拉黑后会触发 onBlackListDeleted 回调。

    示例代码如下:

    List<String> userIDList = new ArrayList<>();
    userIDList.add("user1");
    userIDList.add("user2");
    V2TIMManager.getFriendshipManager().deleteFromBlackList(userIDList, new V2TIMValueCallback<List<V2TIMFriendOperationResult>>() {
     @Override
     public void onSuccess(List<V2TIMFriendOperationResult> v2TIMFriendOperationResults) {
       // 解除拉黑成功
     }
      @Override
     public void onError(int code, String desc) {
       // 解除拉黑失败
     }
    });
    // 监听黑名单列表删除通知
    V2TIMManager.getFriendshipManager().addFriendListener(new V2TIMFriendshipListener() {
     @Override
     public void onBlackListDeleted(List<String> userList) {
       // 黑名单列表删除通知
     }
    });
    

    获取黑名单列表

    您可以通过 getBlackList (Android / iOS & Mac / Windows) 查看已拉黑多少用户,并对黑名单人员进行管理。

    示例代码如下:

    V2TIMManager.getFriendshipManager().getBlackList(new V2TIMValueCallback<List<V2TIMFriendInfo>>() {
     @Override
     public void onSuccess(List<V2TIMFriendInfo> v2TIMFriendInfos) {
       // 获取黑名单列表成功
     }
      @Override
     public void onError(int code, String desc) {
       // 获取黑名单列表失败
     }
    });
    

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持