mirai-core-api/net.mamoe.mirai.event.events/MessagePostSendEvent

MessagePostSendEvent

sealed class MessagePostSendEvent<C : Contact> : AbstractEvent, BotEvent, BotActiveEvent, VerboseEvent

在发送消息后广播的事件, 总是在 MessagePreSendEvent 之后广播.

只要 MessagePreSendEvent 未被取消, MessagePostSendEvent 就一定会被广播, 并携带发送时产生的异常 (如果有).

在此事件广播前, 消息一定已经发送成功, 或产生一个异常.

See also

net.mamoe.mirai.contact.Contact

发送消息. 为广播这个事件的唯一途径

net.mamoe.mirai.event.events.MessagePreSendEvent

Functions

fun cancel()

abstract fun intercept()

拦截这个事件

Properties

@MiraiInternalApi

var _intercepted: Boolean = false

override val bot: Bot

@MiraiInternalApi

val broadCastLock: Mutex

限制一个事件实例不能并行广播. (适用于 object 广播的情况)

abstract val exception: Throwable?

发送消息时抛出的异常. null 表示消息成功发送.

val isCancelled: Boolean

abstract val isIntercepted: Boolean

事件是否已被拦截.

abstract val message: MessageChain

待发送的消息. 此为 MessagePreSendEvent.message 的最终值.

abstract val receipt: MessageReceipt<C>?

发送消息成功时的回执. null 表示消息发送失败.

abstract val target: C

发信目标.

Inheritors

GroupMessagePostSendEvent

UserMessagePostSendEvent

Extensions

val MessagePostSendEvent<*>.isFailure: Boolean

在此消息发送失败时返回 true.

val MessagePostSendEvent<*>.isSuccess: Boolean

在此消息发送成功时返回 true.

val <C : Contact> MessagePostSendEvent<C>.result: Result<MessageReceipt<C>>

将 MessagePostSendEvent.exception 与 MessagePostSendEvent.receipt 表示为 Result

val MessagePostSendEvent<*>.source: MessageSource?

获取指代这条已经发送的消息的 MessageSource. 若消息发送失败, 返回 null

val MessagePostSendEvent<*>.sourceResult: Result<MessageSource>

获取指代这条已经发送的消息的 MessageSource, 并包装为 kotlin.Result