Kovi

外观

监听事件 ​

通过 PluginBuilder 可以监听事件

on_msg() ​

添加消息监听函数, 包括好友私聊、群消息以及讨论组消息

关于 AllMsgEvent ，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_msg(|event| async move {
        event.reply("hi");
    });
}

on_admin_msg() ​

添加管理员消息监听函数, 包括好友私聊、群消息以及讨论组消息，Kovi 会帮你筛选消息。

关于 AllMsgEvent ，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_admin_msg(|event| async move {
        event.reply("hi");
    });
}

on_private_msg() ​

添加好友私聊消息监听函数。

关于 AllMsgEvent ，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_private_msg(|event| async move {
        event.reply("hi");
    });
}

on_group_msg() ​

添加群消息监听函数。

关于 AllMsgEvent ，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_group_msg(|event| async move {
        event.reply("hi");
    });
}

on_all_notice() ​

添加 OneBot 的 通知事件 监听函数。

关于 AllNotionEvent，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_all_notice(|event| async move {
        info!("{}", event.notice_type); 
    }); 
}

on_all_request() ​

添加 OneBot 的 请求事件 监听函数。

关于 AllRequestEvent ，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_all_request(|event| async move {
        info!("{}", event.request_type); 
    }); 
}

cron() 和 cron_use_croner() ​

添加一个定时任务。

传入的 cron 会使用 croner 进行解析。

rust
use kovi::croner;
use kovi::{log::info, PluginBuilder as p};

#[kovi::plugin]
async fn main() {
    // 每天00:00
    p::cron("0 0 * * *", || async {
        info!("00:00");
    })
    .unwrap();

    // 每一秒
    p::cron("* * * * * *", || async {
        info!("每一秒");
    })
    .unwrap();

    let cron = croner::Cron::new("0 0 * * *").parse().unwrap();
    p::cron_use_croner(cron, || async {
        info!("00:00");
    });
}

drop() ​

添加 程序退出 监听函数。

如果你需要在程序结束时，运行一些代码，可以使用此监听来监听程序退出。

为了提高用户侧退出体验，程序在接收到第二次退出信号的时候，会强制退出程序。

CAUTION

本函数运行起来非常复杂，对于主线程意外 panic! (这取决于 Kovi 开发有没有 Bug ) ，本函数不会触发。

只会在监听到系统退出信号时或者断开 OneBot 服务端连接时，才会运行传入的闭包。

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::drop(|| async { 
        println!("正在退出程序"); 
    }); 
}

on_msg_send() ​

添加自身消息发送监听函数。

需打开 message_sent feature。

还要注意服务端是否有这一个功能。

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_msg_sent(|_event| async move {
        info!("我自己发了消息"); 
    });
}