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

QGGroupBotMember

@JvmExposeBoxed

abstract class QGGroupBotMember : QGGroupMember(source)

机器人在指定 QQ 群内作为成员的表现，包含一次查询得到的 botState 信息。

Since

5.0

Properties

allowProactiveMsg

val allowProactiveMsg: Boolean

机器人是否接收主动推送。

botState

abstract val botState: GroupBotState

机器人在 groupId 所属群内的原始状态。

open override val id: ID

机器人在群内作为的成员 OpenID。

joinTime

val joinTime: Timestamp

机器人加入此群的时间。

memberRole

val memberRole: QGGroupRole

机器人在群内的角色。

recvMsgSetting

val recvMsgSetting: GroupBotReceiveMessageSetting

机器人的消息接收设置。

Inherited properties

avatar

open override val avatar: String?

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

coroutineContext

abstract val coroutineContext: CoroutineContext

groupId

abstract val groupId: ID

此成员所属群的 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())

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