【Mirai-js】如何快速制作一个 QQ 机器人

快速开始

完整文档见 -> https://Drincann.github.io/Mirai-js

把项目 clone 到本地:

$ git clone https://github.com/Drincann/Mirai-js.git

接口入口位于 ./src/Mirai-js.js 从该文件解构:

const { Bot, Message } = require('./src/Mirai-js');

登录

可以直接在 mirai-console 中输入/login qq password

若想要远程控制 mirai-console 登录,可通过 Bot 的类方法sendCommend发送命令:

await Bot.sendCommand({
    // mirai-api-http 服务的网络位置
    baseUrl: 'http://example.com:8080',
    // 在 mirai-api-http 的配置中设置的 authKey
    authKey: 'authKey',
    // 指令名
    command: '/login',
    // 指令参数列表,这条指令等价于 /login 1019933576 password
    args: ['1019933576', 'password'],
});

注意该方法的返回值,已知的问题:

‘Login failed: Mirai 无法完成滑块验证. 使用协议 ANDROID_PHONE 强制要求滑块验证, 请更换协议后重试. 另请参阅: https://github.com/project-mirai/mirai-login-solver-selenium’

不要重复登录!

建立连接

获得一个Bot实例,然后在实例上调用open方法连接到你的 mirai-api-http 服务:

const bot = new Bot();

// 连接到一个 mirai-api-http 服务
await bot.open({
    baseUrl: 'http://example.com:8080',
    authKey: 'authKey',
    // 要绑定的 qq,须确保该用户已在 mirai-console 登录
    qq: 1019933576,
});

重复调用 open 方法将重建连接,需要重建连接时,可以传入想要修改的参数。

若未提供任何参数,将保持原先的配置。

发送消息

向好友发送消息:

await bot.sendMessage({
    // 好友 qq 号
    friend: '1019933576',
    // Message 实例,表示一条消息
    message: new Message().addText('hello world!').addImageUrl('http://exapmle/image.jpg')});

注意!这些方法都是异步的

还可以使用 mirai-api-http 接口所需的原始格式来作为 message。

向群组发送消息:

await bot.sendMessage({
    // 群号
    group: '123456789',
    // 是 http server 接口所需的原始格式,若提供则优先使用
    messageChain: [
    	{ type: 'Plain', text: 'hello world!'},
        { type: 'Image', url:;'http://example/image.jpg'},
	],
});

具体的MessageChain的消息类型见 MessageType。

接收消息和事件

注册事件处理器,接收好友消息:

// 监听好友消息事件
bot.on('FriendMessage', async data => {
    await bot.sendMessage({
        friend: data.sender.id,
        message: new Message().addText('hello world!'),
    });
});

FriendMessage 事件的消息结构:

{
    messageChain,
    sender: {
        id,
        nickname,
        remark
    }
}

框架以原始的 messageChain 的方式给出具体的消息内容,其结构是一个 MessageType 数组,各种 MessageType 见 MessageType

不想看没关系,如果你仅关注文本消息,那么我们可以使用框架预定义的中间件轻松解决这个问题。

接收群消息:

// 监听群消息事件
bot.on('GroupMessage', async data => {
    await bot.sendMessage({
        group: data.sender.group.id,
        message: new Message().addText('hello world!'),
    });

    // 你可以像这样来判断群成员的权限
    switch (data.sender.permission) {
        case Bot.GroupPermission.OWNER:
            // 群主
            break;
        case Bot.GroupPermission.ADMINISTRATOR:
            // 管理员
            break;
        case Bot.GroupPermission.MEMBER:
            // 普通群成员
            break;
    }
});

GroupMessage 事件的消息结构:

{
    messageChain,
    sender: {
        id,
        memberName,
        permission,
        group: {
            id,
            name,
            permission
        }
    }
}

具体的事件类型及消息结构见 EventType。

使用中间件

框架还提供了一系列预定义的用于处理消息的中间件:

const { Middleware } = require('./src/Mirai-js');

获得一个 Middleware 的实例:

const middleware = new Middleware();

在实例上(链式)调用你需要的中间件:

textProcessor用于拼接messageChain所有的文本信息,并置于data.textgroupFilter则是过滤出指定群号的群消息事件。

middleware.textProcessor().groupFilter([123456789, 987654321]);

通过调用 done 方法, 传入你的事件处理器,获得一个带有中间件的事件处理器:

const processor = middleware.done(async data => {
    bot.sendMessage({
        friend: data.sender.id,
        message: new Message().addText(data.text),
    });
});

注册到一个事件上:

bot.on('FriendMessage', processor);

也可以组合在一起:

bot.on('FriendMessage', new Middleware()
    .textProcessor()
    .groupFilter([123456789, 987654321])
    .done(async data => {
        bot.sendMessage({
            friend: data.sender.id,
            message: new Message().addText(data.text),
        });
    })
);

此外,你也可以自定义中间件,使用 use

最后调用 next 将控制权移交给下一个中间件。

const processor = middleware.use((data, next) => {
    data.text = data.messageChain
        .filter((val) => val.type == 'Plain')
        .map((val) => val.text)
        .join('');
    next();
}).done(/* callback */);

已知的问题

当我们的机器人下线并重新登陆后,当前会话会陷入一种未失效但无法操作的状态,强行操作(例如发送消息)将抛出服务端异常(status 500)。

重新登陆后再次调用open方法可以避免这个问题。

或者在需要重新登陆的事件下使用预定义的autoReLogin中间件,将会在掉线后自动登陆,例子:

bot.on('BotOfflineEventForce',
    new Middleware()
       .autoReLogin({ bot, baseUrl, authKey, password })
       .done()
);

你可能感兴趣的:(分享,教程,mirai)