浏览 SDKs · uni-app / uni-app x
平台
SDKsuni-app / uni-app x

移除群成员

从指定群组移除一个或多个成员。

复制

具备管理权限的群主或管理员可以调用移除群成员接口。该方法不能用于移除群主;如需更换群主,应先调用转让群主。

参数说明

参数类型是否必填说明
groupIDstring是目标群组 ID。
reasonstring是移除说明;没有说明时传空字符串。
userIDListstring[]是待移除的成员用户 ID;调用前应去重。
import { kickGroupMember } from '@/uni_modules/unix-openim-sdk'

await kickGroupMember({
  groupID: groupID,
  reason: '已离开项目',
  userIDList: [targetUserID],
})

Promise 成功表示 SDK 已完成移除请求。收到群成员退出或被踢事件后,再按 groupID:userID 从本地列表移除对应成员;完整事件监听与处理逻辑请参考分页查询群成员。