SDKsuni-app / uni-app x

Set group member role level

Promote a regular group member to administrator or demote an administrator to regular member.

Invoke setGroupMemberInfo() to promote a regular member to administrator or demote an administrator to regular status. Only the group owner has permission to perform role adjustments.

Parameters

The roleLevel property accepts values of type OpenIMGroupMemberRole:

Enum constant	Numeric value	Description
`OpenIMGroupMemberRoleNormal`	`20`	Regular member (used to demote an administrator).
`OpenIMGroupMemberRoleAdmin`	`60`	Administrator (used to promote a member).
`OpenIMGroupMemberRoleOwner`	`100`	Group owner (used for role identification only; cannot be passed to this API).

Do not attempt to transfer group ownership by passing OpenIMGroupMemberRoleOwner; invoke Transfer group ownership instead.

Code example

import {
  OpenIMGroupMemberRoleAdmin,
  setGroupMemberInfo,
} from '@/uni_modules/unix-openim-sdk'

await setGroupMemberInfo({
  groupID: groupID,
  userID: targetUserID,
  roleLevel: OpenIMGroupMemberRoleAdmin,
})

Return value

The Promise resolves with void once OpenIMServer updates the member role.

A resolved Promise confirms that the role update completed. Connected clients receive onGroupMemberInfoChanged, at which point the UI updates the member's roleLevel matching groupID:userID. For complete member event handling, see Get group member list.

Was this page helpful?

Parameters

Code example

Return value

State changes after the call