simbot-component-qq-core/love.forte.simbot.component.qguild.group/QGGroupAuthor

QGGroupAuthor

@SubclassOptInRequired(markerClass = [QGInternalInheritanceApi::class])

interface QGGroupAuthor : QGGroupMember(source)

一个通过群消息事件得到的群成员信息。

Since

4.4.0

Properties

isBot

abstract val isBot: Boolean

是否为机器人

memberRole

abstract val memberRole: QGGroupRole

消息发送者在群内的身份

Inherited properties

avatar

open override val avatar: String?

无法得知头像，始终得到 null。

coroutineContext

abstract val coroutineContext: CoroutineContext

groupId

abstract val groupId: ID

此成员所属群的 OpenID。

abstract override val id: ID

此成员在 groupId 所属群中的成员 OpenID。

name

abstract override val name: String

群成员的用户昵称。在一些无法得知对方的用户名的场景下（例如某些群操作事件）会始终得到空字符串。

nick

open override val nick: String?

QQ 中无法区分群成员的 QQ 名称与群昵称。因此只有 name，nick 始终为 null。

Inherited functions

addMute

abstract suspend fun addMute(expireAt: Instant)

增加/设置此成员的单独禁言。

addMuteAtMilliseconds

open suspend fun addMuteAtMilliseconds(expireAtMilliseconds: Long)

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

addMuteFor

suspend fun QGGroupMember.addMuteFor(duration: Duration, now: Instant = Clock.System.now())

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

muteState

abstract suspend fun muteState(): GroupMemberMuteState?

查询当前成员在所属群的禁言情况。 null 仅表示记录缺失，这可能表示未被直接禁言，但是不保证是否处于全员禁言之类的非针对性状态。

send

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

open suspend override fun send(text: String): MessageReceipt

open suspend override fun send(message: Message): MessageReceipt

open suspend override fun send(messageContent: MessageContent): MessageReceipt

不支持主动向群成员发送消息，将会抛出 UnsupportedOperationException

unmute

abstract suspend fun unmute()

解除此成员的单独禁言。

updateMute

abstract suspend fun updateMute(expireAt: Instant)

更新此成员已有禁言的到期时间。

updateMuteAtMilliseconds

open suspend fun updateMuteAtMilliseconds(expireAtMilliseconds: Long)

使用自 Unix epoch 起的毫秒数更新此成员已有禁言的到期时间。

updateMuteFor

suspend fun QGGroupMember.updateMuteFor(duration: Duration, now: Instant = Clock.System.now())

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