浏览 SDKs · Flutter
平台
SDKsFlutter

取消拉黑用户

使用 Flutter SDK 将指定用户移出当前账号黑名单。

复制

将指定用户从当前登录用户的黑名单列表中移除:

参数说明

参数类型是否必填说明
userIDString是待移出黑名单的目标用户 ID。
await OpenIM.iMManager.friendshipManager.removeBlacklist(
  userID: 'user_123',
);

返回结果

Future 成功返回 void,表示解除黑名单请求已成功提交至服务端并在本地同步删除该条记录。

该操作为状态变更接口。解除拉黑生效后,目标用户将恢复向当前用户发送单聊消息的权限。

监听解除拉黑事件

取消拉黑事件在此集中监听与处理。服务端移除生效后,当前端与其他在线端会触发 onBlackDeleted 事件通知。客户端应以 userID 为合并标识,从本地黑名单状态中移除对应记录:

void handleBlackDeleted(BlacklistInfo info) {
  final userID = info.userID;
  if (userID != null) removeBlockedUser(userID);
}

Flutter SDK 在 FriendshipManager 中维护单个 OnFriendshipListener 实例。请将上述处理函数统一交由事件概览的应用级集中入口进行注册。若需校准本地黑名单数据,请参考获取黑名单列表。