Struct miraie::messages::MessageChain

pub struct MessageChain(pub Vec<MessageBlock>);

一条接受或者发送的消息，可能由一个或几个 MessageBlock 构成。

如果是接受到的消息，第一个 Block 一定是 Source。

Example

use miraie::prelude::*;
let chain = MessageChain::new()
    .text("text")
    .image_path("a.jpg")
    .at(QQ(12345));

Implementations

impl MessageChain

pub fn new() -> Self

新建一条消息，通常用来回复

pub fn at(self, qq: QQ) -> Self

在消息里增加一个 at 人

pub fn at_all(self) -> Self

在消息里增加一个 at 所有人

pub fn text(self, text: impl Into<String>) -> Self

在消息里增加一些文字

pub fn image_url(self, url: impl Into<String>) -> Self

在消息里增加一张图片，其来自 url

pub fn image_path(self, path: impl AsRef<str>) -> Self

在消息里增加一张图片，发送本地图片，相对路径于 env:MIRAIE_RESOURCE_ROOT/images。

注意这里的路径是相对于 mirai 运行环境的路径，并不一定是机器人所在机器的路径。

pub fn voice_url(self, url: impl Into<String>) -> Self

在消息里增加一段语音

pub fn voice_path(self, path: impl AsRef<str>) -> Self

在消息里增加一段语音，发送本地语音，相对路径于 env:MIRAIE_RESOURCE_ROOT/voices

注意这里的路径是相对于 mirai 运行环境的路径，并不一定是机器人所在机器的路径。

pub fn message_id(&self) -> Option<i64>

获取消息的 message id，可以用于稍后回复

pub fn as_confirm(&self) -> Option<bool>

尝试把 message 按照 确认/取消 消息进行匹配。只会匹配常用的一些结构， 如“好”，“确认”等，并不保证准确。如果需要更准确的结果建议自行实现。

impl MessageChain

pub fn from_xml(xml: &str) -> Self

从简单的 xml 解析出 MessageChain

标签

标签内容都是路径，且是相对于 env:MIRAIE_RESOURCE_ROOT/{voices|images} 的相对路径。

• i, img, image：图片
• v, voice：音频

Example

let chain = MessageChain::from_xml("下面是图片：<img> image.jpg </img>");

Trait Implementations

impl Clone for MessageChain

fn clone(&self) -> MessageChain

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MessageChain

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MessageChain

fn default() -> MessageChain

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MessageChain

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for MessageChain

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&'_ str> for MessageChain

fn from(s: &str) -> Self

Performs the conversion.

impl From<MessageBlock> for MessageChain

fn from(block: MessageBlock) -> Self

Performs the conversion.

impl From<String> for MessageChain

fn from(s: String) -> Self

Performs the conversion.

impl PartialEq<MessageChain> for MessageChain

fn eq(&self, other: &MessageChain) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &MessageChain) -> bool

This method tests for !=.

impl Serialize for MessageChain

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl Eq for MessageChain

impl StructuralEq for MessageChain

impl StructuralPartialEq for MessageChain