QGCategory

interface QGCategory : Category(source)

当一个频道的 QGSourceChannel.type 的值等于 ChannelType.CATEGORY 时, 此频道代表为一个分组。

QGCategory 是一个仅存在ID的 QQ频道子频道分组实现。QQ频道对于子频道分组类型的变更不会推送事件, 因此无法内建缓存,而如果每次事件都要实时查询channel的分组则可能有些多余 —— 毕竟分组可能并不是一个高频使用的对象。

因此在 QGTextChannel.category 中我们仅提供 QGCategory 类型来直接提供分组ID, 并在有需要的时候通过 resolveToChannel 查询并获取真正的对象实例。

QGCategory 中 id 为子频道分组的ID,name 由于需要通过API查询, 此处将直接返回 id 的字符串值。

通过 QGGuild.categories 或 QGGuild.category 获取的结果均为实时查询结果, 它们是具体的 QGCategory 类型,其中已经包含了具体信息。

See also

Properties

Link copied to clipboard
abstract override val id: ID

当前子频道分组ID

Functions

Link copied to clipboard
abstract suspend override fun name(): String?

当前子频道分组的名称。会通过 resolveToChannel 获取子频道信息后返回名称。

Link copied to clipboard
abstract suspend fun resolveToChannel(): QGCategoryChannel

根据当前ID初始化并得到一个具体的分组频道 QGNonTextChannel 对象实例。