QGGroupWithInfo

Properties

Link copied to clipboard

群分类。

Link copied to clipboard

群简介。

Link copied to clipboard
abstract val groupInfo: GroupInfo

群基本信息原始快照。

Link copied to clipboard

群成员人数。

Link copied to clipboard
open val groupTags: List<String>

群标签列表。

Link copied to clipboard
open override val name: String

查询时的群名称。

Inherited properties

Link copied to clipboard
Link copied to clipboard
abstract override val id: ID

这个群的openid。

Link copied to clipboard

得到当前群的入群申请列表的收集器。收集时才请求,并按平台游标自动翻页。

Link copied to clipboard
open override val members: Collectable<QGGroupMember>

无法查询群成员列表,将始终得到空结果。

Link copied to clipboard
open override val ownerId: ID?

无法得知群主ID,始终得到 null

Link copied to clipboard
open override val roles: Collectable<QGGroupRole>

得到 QGGroupRole 的元素集。

Inherited functions

Link copied to clipboard
open suspend fun addMemberMute(memberId: ID, expireAt: Instant)

明确增加指定成员的单独禁言,委托 setMemberMutes 提交单元素批次。

Link copied to clipboard
open suspend fun addMemberMuteAtMilliseconds(memberId: ID, expireAtMilliseconds: Long)

使用自 Unix epoch 起的毫秒数增加指定成员的单独禁言。

Link copied to clipboard
suspend fun QGGroup.addMemberMuteFor(memberId: ID, duration: Duration, now: Instant = Clock.System.now())

为指定成员增加指定时长的禁言。

Link copied to clipboard
open suspend override fun botAsMember(): QGGroupMember

查询机器人在本群中的状态,并作为成员对象返回。 成员 QGGroupMember.id 使用群成员 OpenID,而不是 Bot 的 AppID。 需要读取原始状态和角色等属性时,使用 botAsMemberWithState。

Link copied to clipboard
abstract suspend fun botAsMemberWithState(): QGGroupBotMember

查询机器人在本群中的成员身份及原始状态快照。 每次调用都请求平台,成员 ID 使用群成员 OpenID。

Link copied to clipboard
abstract suspend fun botState(): GroupBotState

通过 API 查询机器人在当前 QQ 群内的原始状态快照。 查询失败时透传平台或网络异常,不缓存查询结果。

Link copied to clipboard
abstract suspend fun groupInfo(): GroupInfo

通过 API 查询当前 QQ 群的基本信息,返回本次查询的快照结果。

Link copied to clipboard
open suspend fun groupInfoOrQuery(): GroupInfo

如果当前对象已经是 QGGroupWithInfo,返回其已有的 GroupInfo; 否则调用 groupInfo 查询。

Link copied to clipboard
abstract suspend fun includeInfo(): QGGroupWithInfo

通过 API 查询群基本信息并基于此得到存在更详细信息的 QGGroupWithInfo。

Link copied to clipboard

如果当前对象已经是 QGGroupWithInfo,返回自身;否则调用 includeInfo 查询。

Link copied to clipboard
open suspend override fun member(id: ID): QGGroupMember?

无法查询群成员,将始终得到 null。

Link copied to clipboard
abstract suspend fun muteSetting(): GroupMuteSetting

查询当前群的完整禁言信息。

Link copied to clipboard
abstract suspend fun send(text: String): MessageReceipt
abstract suspend fun send(message: Message): MessageReceipt
abstract suspend fun send(messageContent: MessageContent): MessageReceipt
open suspend fun send(text: String, vararg options: SendOption): MessageReceipt
open suspend fun send(message: Message, vararg options: SendOption): MessageReceipt
open suspend fun send(messageContent: MessageContent, vararg options: SendOption): MessageReceipt
Link copied to clipboard
abstract suspend fun setMemberMutes(changes: List<QGGroupMemberMuteChange>)

提交成员禁言变更请求。一次提交的数量应当在 1~20 项之内。

Link copied to clipboard
open suspend fun unmuteMember(memberId: ID)

解除指定成员的单独禁言,不修改全员禁言规则。 委托 setMemberMutes 提交单元素批次,失败时透传异常。

Link copied to clipboard
open suspend fun updateMemberMute(memberId: ID, expireAt: Instant)

明确更新指定成员的单独禁言,委托 setMemberMutes 提交单元素批次。

Link copied to clipboard
open suspend fun updateMemberMuteAtMilliseconds(memberId: ID, expireAtMilliseconds: Long)

使用自 Unix epoch 起的毫秒数更新指定成员的单独禁言。

Link copied to clipboard
suspend fun QGGroup.updateMemberMuteFor(memberId: ID, duration: Duration, now: Instant = Clock.System.now())

更新指定成员已有禁言的时长。

Link copied to clipboard
abstract suspend fun uploadMedia(url: String, type: Int): QGMedia
abstract suspend fun uploadMedia(resource: Resource, type: Int): QGMedia

上传一个资源为用于向QQ群发送的 QGMedia, 可用于后续的发送。