事件监听

监听

C#

代码参考：src/Serein.Core/Models/Plugins/Net/PluginBase.Events.cs

在插件类内重载虚方法即可

示例

using Serein.Core.Models.Plugins.Net;
using System;
using System.Threading.Tasks;

namespace MyPlugin;

public class MainPlugin : PluginBase
{
    public override void Dispose() { }
    
    protected override Task OnPluginsLoaded()
    {
        Console.WriteLine("Loaded!");
        return Task.CompletedTask;
    }
}

JavaScript

serein.setListener(event: string, callback: Function): void

参数	类型	说明
event	string	事件名称（见下）
callback	Function	回调函数

示例

serein.setListener('PluginsLoaded', () => {
    console.log(`I'm loaded!`);
});

拦截

对于可被拦截的事件，可以通过返回false来拦截事件，阻止其继续传递

例如，拦截ServerStarting将阻止服务器启动并阻止下一个事件ServerStarted的触发

C#

using Serein.Core.Models.Plugins.Net;
using Serein.Core.Services.Servers;
using System;
using System.Threading.Tasks;

namespace MyPlugin;

public partial class MainPlugin : PluginBase
{
    protected override Task<bool> OnServerStarting(ServerBase server)
    {
        Console.WriteLine("Intercepted!");
        return Task.FromResult(false);
    }
}

JavaScript

serein.setListener('ServerStarting', (_) => {
    console.log('Intercepted!');
    return false;
});

提示

当拦截事件时，你或许应该根据实际情况以合理的方式告诉用户，避免造成不必要的困扰

事件一览

事件名称	是否可被拦截
ServerStarting	是
ServerStarted	否
ServerStopping	是
ServerExited	否
ServerRawOutput	是
ServerOutput	是
ServerInput	否
GroupMessageReceived	是
PrivateMessageReceived	是
WsDataReceived	是
PacketReceived	是
SereinClosed	否
SereinCrashed	否
PluginsLoaded	否
PluginsUnloading	否

ServerStarting

• 触发时机：服务器启动前
• 可被拦截：是
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象

ServerStarted

• 触发时机：服务器启动后
• 可被拦截：否
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象

ServerStopping

• 触发时机：用户尝试手动停止服务器时
• 可被拦截：是
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象

ServerExited

• 触发时机：服务器进程退出后
• 可被拦截：否
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象
exitCode	int/number	退出代码
exitTime	DateTime/Date	退出时间

ServerRawOutput

和ServerOutput的区别

ServerRawOutput会在ServerOutput之前触发，且可能包含ANSI转义序列等特殊字符

• 触发时机：服务器输出
• 可被拦截：是
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象
line	string	输出行

ServerOutput

• 触发时机：服务器输出
• 可被拦截：是
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象
line	string	输出行

ServerInput

• 触发时机：服务器输入
• 可被拦截：否
• 函数参数：

参数	类型	说明
server	ServerBase	服务器对象
line	string	输入行

GroupMessageReceived

• 触发时机：收到群聊消息
• 可被拦截：是
• 函数参数：

参数	类型	说明
messagePacket	MessagePacket	消息数据包

PrivateMessageReceived

• 触发时机：收到私聊消息
• 可被拦截：是
• 函数参数：

参数	类型	说明
messagePacket	MessagePacket	消息数据包

WsDataReceived

触发顺序

WsDataReceived>PacketReceived>GroupMessageReceived/PrivateMessageReceived

• 触发时机：收到WebSocket连接的数据文本
• 可被拦截：是
• 函数参数：

参数	类型	说明
data	string	数据文本

PacketReceived

• 触发时机：收到WebSocket连接的数据包
• 可被拦截：是
• 函数参数：

参数	类型	说明
packet	JsonObject	数据包

SereinClosed

提示

你可以通过此事件和PluginsUnloading事件来释放插件占用的资源，例如数据库连接、文件流等

• 触发时机：程序即将退出前
• 可被拦截：否
• 函数参数：无

SereinCrashed

备注

不能保证总是能触发成功

• 触发时机：程序崩溃后
• 可被拦截：否
• 函数参数：无

PluginsLoaded

• 触发时机：插件加载完成后
• 可被拦截：否
• 函数参数：无

PluginsUnloading

• 触发时机：插件卸载前
• 可被拦截：否
• 函数参数：无