MessageSource

消息源. 消息源存在于 MessageChain 中, 用于表示这个消息的来源, 也可以用来分辨 MessageChain.

组成

MessageSource 由以下属性组成:

• 三个定位属性ids, internalId, time

• 发送人 ID fromId

• 收信人 ID targetId

• 原消息内容 originalMessage

官方客户端通过这三个定位属性来准确定位消息, 撤回和引用回复都是如此 (有这三个属性才可以精确撤回和引用某个消息).

即使三个定位属性就可以知道原消息是哪一条, 但服务器和官方客户端都实现为读取 originalMessage 的内容. 也就是说, 如果引用一个 MessageSource, 定位属性只会被用来支持跳转到原消息, 引用中显示的被引用消息内容只取决于 originalMessage. 可以通过修改 originalMessage 来达到显示的内容与跳转内容不符合的效果. 但一般没有必要这么做.

获取

• 来自 MessageEvent.message 的 MessageChain 总是包含 MessageSource. 可通过 MessageChain.get 获取 MessageSource:

    // Kotlin
      val source: MessageSource? = chain[MessageSource]
      val notNull: MessageSource = chain.source // 可能抛出 NoSuchElementException

  Content copied to clipboard

    // Java
      MessageSource source = chain.get(MessageSource.Key);

  Content copied to clipboard

• 构造离线消息源: IMirai.constructMessageSource

• 使用构建器构造: MessageSourceBuilder

"修改" 一个 MessageSource

MessageSource 是不可变的. 因此不能修改其中属性, 但可以通过 MessageSource.copyAmend 或者 MessageSourceBuilder.allFrom 来复制一个.

MessageSource newSource = new MessageSourceBuilder()
    .allFrom(source) // 从 source 继承所有数据
    .message(new PlainText("aaa")) // 覆盖消息
    .build();

使用

消息源可用于 引用回复 或 撤回.

对于来自 MessageEvent.message 的 MessageChain, 总是包含 MessageSource. 因此也可以对这样的 MessageChain 进行 引用回复 或 撤回.

Kotlin 示例

val source: MessageSource = ...
source.recall() // 通过 MessageSource 撤回

val event: MessageEvent = ...
event.message.recall() // 也可以通过来自服务器的 [MessageChain] 撤回, 因为这些 chain 包含 [MessageSource]

Java 示例

MessageSource source = ...
MessageSource.recall(source); // 通过 MessageSource 撤回

MessageEvent event = ...
MessageSource.recall(event.message); // 也可以通过来自服务器的 [MessageChain] 撤回, 因为这些 chain 包含 [MessageSource]