开始第一个QQ机器人【适用于v2.0及以上】

本示例将会使用”嘤鹉学舌”这个小插件的实现来演示如何使用Newbe.Mahua实现第一个机器人插件。

提示:如果你是 .Net 开发者,也可以使用 Newbe.Mahua 1.X 版本, 可以点击此处学习如何使用

插件功能

自动将发送者的消息回发给发送人,嘤鹉(Parrot,其实是说嘤嘤嘤怪)学舌。

基础环境要求

  • Windows 操作系统
  • .Net Framework 4.6.1 及以上
  • Powershell 5.0及以上,仅开发环境要求

设置Powershell执行策略限制

参考链接:http://www.pstips.net/powershell-create-and-start-scripts.html

简单来说,使用管理员权限在cmd中运行以下命令:

1
powershell -command "Set-ExecutionPolicy RemoteSigned -Force"

下载机器人平台

需要从各机器人平台下载最新的软件,各平台官网地址:

名称地址费用
CQPhttps://cqp.cc/Air免费,Pro收费
MPQhttps://f.mypcqq.cc/thread-2327-1-1.html免费
CleverQQhttps://d.cleverqq.cn/forum.phpAir 免费,Pro收费
QQLighthttp://www.52chat.cc/收费

选择开发者喜欢的平台,下载完毕后,将压缩包解压备用。

本教程将采用 CQP 作为主要演示平台。

安装 Newbe.Mahua

从源码中下载 Newbe.Mahua.Installer

将该文件夹中的所有文件放置到机器人软件的EXE所在的文件夹

使用控制台打开机器人软件的EXE所在的文件夹,然后执行以下命令

1
mahua.bat InstallMahua

计算机第一次安装 Newbe.Mahua 时将会花费较多的时间,需要下载约 50M 左右的软件包,需要耐心等待。

以下便是一次安装的效果图:

mahua.bat 安装效果图

启用 Newbe.Mahua.Agent 插件

各个机器人平台的启用方式各不相同。

CQP

按照下图所示,开启开发者模式。

开启开发者模式

打开插件管理将插件启用。

CleverQQ

打开插件管理将插件启用。

MPQ

打开插件管理将插件启用。

QQLight

打开插件管理将插件启用。

尝试调用 HTTP API

Newbe.Mahua 默认将启动 HTTP API 以便外部进行调用。API文档的地址默认是 http://127.0.0.1:36524/apiDoc

以下便是一个调用 CQP 发送好友消息的示例:

request
1
2
3
4
5
6
7
POST http://127.0.0.1:36524/api/v1/Cqp/CQ_sendPrivateMsg
Content-Type: application/json

{
"qqid": 472158246,
"msg": "月落大佬永远都是唯一的大佬!"
}

实际效果如下:

测试发送消息

实现回调订阅与处理

除了调用API,框架本身还提供了回调的实现,也就是在机器人触发了“收到好友消息”等事件时,通过一些方式回调开发者的程序。

本示例利用HTTP方式来实现需求。

默认情况下,安装完 Newbe.Mahua 之后,机器人的所有事件会通过 HTTP 的方式进行回调。

例如,CQP平台收到好友消息时,将产生如下请求:

request
1
2
3
4
5
6
7
8
9
10
11
12
13
POST http://localhost:65321/api/ReceiveMahuaOutput
Content-Type: application/json

{
"TypeCode": "ProcessPrivateMessage",
"SubType": 11,
"FromQQ": 472158246,
"Msg": "YUELUO : You unknow every lucky ubuntu owner",
"MsgId": 1408,
"Font": 147911064,
"Platform": 0,
"CreateTime": "2019-01-26T07:36:11.006313+00:00"
}

实现功能

基于“调用”和“回调”两个内容的处理,我们便可以实现以上需求。

这里给出一些常用编程语言的对应实现。开发者可以点击此处查看一些技术实现

成功!

发送消息给机器人,你就会收到机器人回发的信息。

机器人插件启动可能需要一段时间,并且大多数平台都会丢弃离线信息,可能需要等待一会儿在发送。

教程链接

发布说明

来吧,信仰充值!