MiraiTravel 的 使用 (六)

简介

MiraiTravel 框架基本介绍

MiraiTravel 框架是基于Mirai 的 Mirai-api-http 插件的一个PHP框架。可以通过 Http 协议与 Mirai 通信，以实现让 Mirai 进行指定操作的一个 PHP 框架。因为 MiraiTravel 是基于 Mirai-api-http 的，而Mirai-api-http 又是 Mirai 的一个插件。所以只有 Mirai 支持的操作， MiraiTravel 才能进行。

CSDN MiraiTravel 专栏地址 https://blog.csdn.net/apple_53792700/category_12176569.html

跟着专栏进行,你一定可以让你的QQ机器人拥有你想要的功能。

Mirai API

Mirai 提供了很多的API，这些API提供了我们对QQ机器人的控制能力。
MiraiAPI文档地址 : https://docs.mirai.mamoe.net/mirai-api-http/api/API.html
MriaiTravel已经对大部分的API进行了封装。
比如我们要发送好友消息,我们就可以参考Mirai文档中的发送好友消息实现：
点击连接直接跳转: https://docs.mirai.mamoe.net/mirai-api-http/api/API.html#%E5%8F%91%E9%80%81%E5%A5%BD%E5%8F%8B%E6%B6%88%E6%81%AF
我们可以看到这个API的使用文档,他没写就是所有的适配器都支持这个操作。
MiraiTravel是推荐使用HTTP适配器的。
MiraiTravel对该API进行了多层封装,以HTTP接口为例封装程度如下:
send_friend_message(QQObj发送消息方法)->send_friend_message(MiraiApi发送消息方法)->adapter_manager(MiraiApi适配器中转器)->http_adapter(HttpAdapter HTTP适配器)->curl_post(HttpAdapter CURLPOST请求方法)
MiraiTravel框架对API的封装全部采用命令的下划线形式封装,比如发送好友消息的命令在Mirai中为/sendFriendMessage那么在MiraiTravel中的方法就为sen_friend_message。其他的同理。
一般我们写脚本时使用的都是QQBot封装的的方法,可能还有由component封装的方法。比如reply_message就不是QQBot封装的方法,而是Component easyMirai封装的方法。这个方法就是对各种回复消息的方法的封装。

要使用文档中的功能获得方法的最快方法就是在QQObj这个对象中查找下划线形式的命令命名的方法。找到以后按照上面的注释使用该方法。

什么？你要用的API没有被QQObj封装？

如果你需要使用的API没有被QQObj封装,那么你有以下方法可供选择:

• 按照上面给出的封装链一直往下寻找,找到可以使用的方法。并在Github上提Issue。
• 自己实现并在github上提Issue。
• 在GIthub上提Issue然后坐等更新。
• 在Github上提Issue并且fork后提 Pull request 。

重点是一定要提Issue,不然这个功能的更新将会被推缓！！！
当然,如果你能以其他方式联系到开发者也可。

👋都看到这里了，还不快点个关注？

---

✍️本文作者为 > 【谢玄.】 Mr-XieXuan < 于 2022/2/1/22:19发布于 CSDN 。

📧E-mail: [ Mr_Xie_@outlook.com ]
⌨️GitHub: [ https://github.com/MR-XieXuan }
🔍个人私站: [ https://main.mrxie.xyz/ ]
---且行且珍惜 ---