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

入坑提示

建议开发者先根据自身需求结合表格，选择属于自己的专属开发框架，避免浪费时间。

编写一套代码就能在多个平台运行
支持使用除了 C# 之外的开发语言来开发
我希望他足够简单，不用学习太多就能掌握，通常只需要半个小时就能掌握所有内容
我希望社区的反馈足够快，有问题都可以帮我解决

SDK 名称（1）（2）（3）（4）论坛中的其他 SDK✔✔✔✔Jie2GG.Native.Csharp.Frame✔✘✔✔Newbe.Mahua V2✔✔✘✘Newbe.Mahua V1✔✘✘✘

论坛其他 SDK 的链接

CQP
MPQ
QQLight

插件功能

自动将发送者的消息回发给发送人，嘤鹉（Parrot，其实是说嘤嘤嘤怪）学舌。

基础环境要求

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

设置 Powershell 执行策略限制

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

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

powershell -command "Set-ExecutionPolicy RemoteSigned -Force"

下载机器人平台

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

名称地址费用CQPhttps://cqp.cc/Air 免费，Pro 收费MPQhttps://f.mypcqq.cc/thread-2327-1-1.html免费QQLighthttp://www.52chat.cc/Air 免费，Pro 收费

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

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

安装 Newbe.Mahua

点击此处 Newbe.Mahua.Installer，下载这个文件夹下所有的文件。

或者，可以点击此处下载其中的 Newbe.Mahua.Installer.zip 压缩包。压缩包中的内容与以上链接一致。

将下载的文件放置到机器人软件的 exe 所在的文件夹。

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

mahua.bat InstallMahua

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

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

启用 Newbe.Mahua.Agent 插件

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

CQP

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

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

MPQ、QQLight

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

尝试调用 HTTP API

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

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

注意：以下 API 调用需要根据实际的 API 文档界面的参数提示进行调用。此处文档可能和真实的调用不同，请以文档为准。

request

POST http://127.0.0.1:36524/api/v1/Cqp/CQ_sendPrivateMsg
Content-Type: Application/json

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

实际效果如下：

实现回调订阅与处理

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

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

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

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

request

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"
}

实现功能

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

这里给出一些常用编程语言的对应实现，其中包含有 C#/JAVA/JavaScript/Typescript 等开发语言。调用与回调方式包含有 HTTP/Websocket 等。

开发者可以点击此处查看一些技术实现

成功！

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

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

教程链接

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

发布说明

Newbe.Mahua 2.4 恢复 QQLight
Newbe.Mahua 2.3 移除 CleverQQ
Newbe.Mahua 2.2 可用性修复
Newbe.Mahua 2.1 支持 Websocket
Newbe.Mahua 2.0 不再仅仅支持 .Net

本文作者： newbe36524
本文链接： https://www.newbe.pro/Newbe.Mahua/Start-With-Mahua-In-V2.0/
版权声明： 本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！

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