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

移除群成员

把一个或多个成员移出指定群。

复制

有权限的群主或管理员可以调用 kickGroupMember()

参数说明

参数类型是否必填说明
groupIDstring要移除成员的群组 ID。
reasonstring移除原因;没有补充说明时传空字符串。
userIDListstring[]要移除的成员用户 ID 列表。
import { kickGroupMember } from '@/uni_modules/unix-openim-sdk'

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

不能用该方法移除群主;应先转让群主身份。服务端会校验管理员能否操作目标成员。

Promise 成功表示移除请求已经完成。onGroupMemberDeleted 随后可能到达,应按 groupID:userID 移除成员;完整监听见分页查询群成员