">获取子频道身份组权限

获取子频道身份组权限

获取指定子频道身份组的权限。

使用示例

async function demo() {
  let { data } = await client.channelPermissionsApi.channelRolePermissions(channelId, roleId);
}

参数说明

字段名	必填	类型	描述
channelId	是	string	子频道 ID
roleId	是	string	身份组 ID ，参考 Role

返回说明

返回 ChannelPermissions 对象。

ChannelPermissions

字段名	类型	描述
channel_id	string	子频道 ID
role_id	string	身份组 ID，参考 Role
permissions	string	用户拥有的子频道权限，参考 Permissions

Permissions

权限是 QQ 频道管理频道成员的一种方式，管理员可以对不同的人、不同的子频道设置特定的权限。用户的权限包括个人权限和身份组权限两部分，最终生效是取两种权限的并集。

权限在服务端使用十六进制方式描述，现有权限类型如下：

权限	值	描述
可查看子频道	0x0000000001(1 << 0)	支持`指定成员`可见类型，支持`身份组`可见类型
可管理子频道	0x0000000002(1 << 1)	创建者、管理员、子频道管理员都具有此权限
可发言子频道	0x0000000004(1 << 2)	支持`指定成员`发言类型，支持`身份组`发言类型

::: tip 提示

对位运算和移位操作符不熟悉的可参考相关文档。以上述可发言子频道权限为例，操作数1经1<<2移位操作后，对应的二进制数为100，对应的16进制数为0x4。同理如果要表示权限可发言 + 可查看，将两种权限做加法即可，即：0x0000000002+0x0000000004=0x0000000006。

:::

SDK中权限用十进制字符串描述，以下面返回示例为例，permissions是'1'，表示拥有可查看子频道(1)权限。

返回示例

data：

{
    channel_id: 'CHANNEL_ID',
    role_id: 'ROLE_ID',
    permissions: '1'
}