创建子频道

创建一个子频道。

使用示例

  1. async function demo() {
  2. let { data } = await client.channelApi.postChannel(guildId, channel);
  3. }

::: warning 注意

  • 要求操作人具有管理频道的权限,如果是机器人,则需要将机器人设置为管理员。
  • 创建成功后,返回创建成功的子频道对象,同时会触发一个频道创建的事件通知。
  • 目前不支持创建的子频道类型
    • 子频道分组

:::

参数说明

字段名 必填 类型 描述
guildId string 频道 ID
channel Channel 子频道对象

Channel

字段名 类型 必填 描述
name string 子频道名
type number 子频道类型 ChannelType
sub_type number 子频道子类型 ChannelSubType
position number 排序,非必填
parent_id string 分组 ID
private_type number 子频道私密类型 PrivateType
private_user_ids string[] 私密子频道成员 ID

ChannelType

描述
0 文字子频道
1 保留,不可用
2 语音子频道
3 保留,不可用
4 子频道分组
10005 直播子频道
10006 应用子频道
10007 论坛子频道

注:由于 QQ 频道还在持续的迭代中,经常会有新的子频道类型增加,文档更新不一定及时,开发者识别 ChannelType 时,请注意相关的未知 ID 的处理。

ChannelSubType

描述
0 闲聊
1 公告
2 攻略
3 开黑

PrivateType

描述
0 公开频道
1 群主管理员可见
2 群主管理员 + 指定成员

返回说明

返回 ChannelRes 对象。

ChannelRes

字段名 类型 描述
id string 子频道 ID
guild_id string 频道 ID
name string 子频道名
type number 子频道类型 ChannelType
sub_type number 子频道子类型 ChannelSubType
position number 排序,非必填
owner_id string 创建人用户 ID

返回示例

data

  1. {
  2. id: 'CHANNEL_ID',
  3. guild_id: 'GUILD_ID',
  4. name: 'ostwindli的子频道',
  5. type: 1,
  6. position: 1638519748,
  7. owner_id: '2854209121',
  8. sub_type: 0
  9. }