Kovi

外观

监听事件 ​

正如在前面 "快速上手" 看到的，通过 PluginBuilder 可以监听事件

WARNING

PluginBuilder 只能在插件入口处，也就是由 #[kovi::plugin] 标注的函数的这个主线程中使用。请不要在监听闭包里使用 PluginBuilder ，监听闭包不属于插件主线程。

on_msg() 消息监听 ​

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

关于 MsgEvent ，点击前往查看

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

on_admin_msg() 管理员消息监听 ​

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

关于 AdminMsgEvent ，点击前往查看

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

on_private_msg() 私聊消息监听 ​

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

关于 PrivateMsgEvent ，点击前往查看

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

on_group_msg() 群消息监听 ​

添加群消息监听函数。

关于 GroupMsgEvent ，点击前往查看

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

on_notice() 通知事件监听 ​

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

关于 NotionEvent，点击前往查看

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

on_request() 请求事件监听 ​

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

关于 RequestEvent ，点击前往查看

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::on_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! ，本函数不会触发。

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

rust
#[kovi::plugin]
async fn main() {
    PluginBuilder::drop(|| async { 
        println!("正在关闭插件"); 
    }); 
}

自定义监听 ^0.12.0 ​

如果细心点进去 上面监听的源代码一看。他们都是通过一个统一的 PluginBuilder::on 进行监听的。

类似如下效果

rust
PluginBuilder::on(|event: Arc<MsgEvent>| foo())

是的没错，Kovi 通过了一些 魔法 让 on 可以通过指定事件类型，就可以监听此事件。

可以通过这种方式来监听自己想要的事件。

甚至可以写出这种极其简约的写法

rust
use kovi::event::MsgEvent;
use kovi::PluginBuilder as P;
use std::sync::Arc;

#[kovi::plugin]
async fn main(){
    P::on(foo)
}
async fn foo(e: Arc<MsgEvent>){
    todo!()
}

Kovi 框架内部目前有三个的 ‘自定义监听’，如下

MsgSendFromKoviEvent 自己发送的消息（来自Kovi框架自身） ^0.12.0 ​

可以通过这个来监听自己发送的消息。

rust
use kovi::event::MsgSendFromKoviEvent;

#[kovi::plugin]
async fn main(){
    P::on(|e: Arc<MsgSendFromKoviEvent>| async move {})
}

MsgSendFromServerEvent 自己发送的消息（来自服务端） ^0.12.0 ​

rust
use kovi::event::MsgSendFromServerEvent;

#[kovi::plugin]
async fn main(){
    P::on(|e: Arc<MsgSendFromServerEvent>| async move {})
}

LifecycleEvent 生命周期元信息（来自服务端） ^0.12.0 ​

其实这个一点用都没有，插件启动其实就代表着Bot启动了，LifecycleEvent 是给框架本体用的信息，但是 Kovi 内部有这玩意，顺便 pub 出来。

rust
use kovi::event::LifecycleEvent;

#[kovi::plugin]
async fn main(){
    P::on(|e: Arc<LifecycleEvent>| async move {})
}