子频道对象(Channel)

子频道对象中所涉及的 ID 类数据,都仅在机器人场景流通,与真实的 ID 无关,请不要理解为真实的 ID。

Channel

字段名 类型 描述
ID string 子频道id
GuildID string 频道id
Name string 子频道名
Type int 子频道类型 ChannelType
SubType int 子频道子类型 ChannelSubType
Position int64 排序,必填,而且不能够和其他子频道的值重复
ParentID string 分组 id
OwnerID string 创建人 id
PrivateType int 子频道的可见类型 ChannelPrivateType
SpeakPermission int 子频道发言权限 SpeakPermissionType
ApplicationID string 应用子频道的应用ID,仅应用子频道有效
Permissions string 用户拥有的子频道权限

有关 position 的说明

  • postiton 从 1 开始。
  • 当子频道类型为 子频道分组(ChannelType=4)时,由于 position 1未分组占用,所以 position 只能从 2 开始。
  • 如果不传默认追加到分组下最后一个。
  • 如果填写一个已经存在的值,那么会插入在原来的元素之前。
  • 如果填写一个较大值,与不填是相同的表现,同时存储的值会根据真实的 position 进行重新计算,并不会直接使用传入的值。

ChannelType

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

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

ChannelSubType

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

SpeakPermissionType

描述
0 公开发言权限
1 指定成员可发言

ChannelPrivateType

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

应用子频道的应用类型

以下列表用于说明应用子频道的application_id含义。

描述
1000000 王者开黑大厅
1000001 互动小游戏
1000010 腾讯投票
1000051 飞车开黑大厅
1000050 日程提醒
1000070 CoDM 开黑大厅
1010000 和平精英开黑大厅

注:由于 QQ 频道还在持续的迭代中,应用子频道的 application_id 还会持续新增,后续会不定期补充到文档中。