Mirai.Net是基于mirai-api-http实现的轻量级mirai社区sdk。
Mirai.NET 是基于 mirai-api-http 实现的 C# 版轻量级 mirai 社区 SDK。
此项目遵循 AGPL-3.0 协议开源。
QQ 群: 752379554欢迎加入群聊探讨 以及水群聊天
如果你这个项目还不错,不妨考虑给它点一个 Star。
如果你还觉得挺酷但还不够好的话,也欢迎提交 Pull Request 和 Issue。
Http Adapter
和 Websocket Adapter
Http Adapter
用来进行发送操作。Websocket Adapter
用来进行接收操作。(以下仅为一些简单示例,如果需要更详细的说明,请移步文档。有时候文档跟不上版本请进群提问
Install-Package Mirai.Net
dotnet add package Mirai.Net
Mirai.Net
安装最新版。
using System;
using System.Linq;
using System.Reactive.Linq;
using System.Threading;
using System.Threading.Tasks;
using Mirai.Net.Data.Messages;
using Mirai.Net.Data.Messages.Receivers;
using Mirai.Net.Sessions;
using var bot = new MiraiBot
{
Address = "localhost:8080",
QQ = "xx",
VerifyKey = "xx"
};
(因为MiraiBot
类实现了IDisposable
接口,所以可以使用using
关键字)
Address
和VerifyKey
来自mirai-api-http
的配置文件,QQ
就是Mirai Console
已登录的机器人的 QQ 号。
创建完MiraiBot
实例之后,就可以启动了:
await bot.LaunchAsync();
MiraiBot
类暴露两个属性: EventReceived
和MessageReceived
,订阅它们就可以监听事件和消息。
下面的例子就是过滤出接收到的好友请求事件
事件,然后把它从EventBase
转换成具体的NewFriendRequestedEvent
,最后才是订阅器。
(消息的订阅器也是同样的)
bot.EventReceived
.OfType<NewFriendRequestedEvent>()
.Subscribe(x =>
{
//do things
});
Mirai.Net
通过一系列的xxManager
(这些管理器都是静态类。)来进行主动操作,其中,消息相关的管理器为MessageManager
。
这里以发送群消息作为演示,实际上还可以发送好友消息,临时消息和戳一戳消息。
发送消息的方法有两个参数: 发送到哪里和发送什么。所以第一个参数就是发消息的群号,第二个参数就是要发送的消息链(或者字符串)。
await MessageManager.SendGroupMessageAsync("xx", "Hello, World");
或者:
await MessageManager.SendGroupMessageAsync("xx", new MessageChainBuilder().Plain("Hello, ").At("xx").Build());
此项目欢迎任何人的 Pull Request 和 Issue 也欢迎 Star 和 Fork。
如果你认为文档不够好,也欢迎对 文档仓库 提交 Pull Request 和 Issue。