Skip to content

Home

Jump to bottom
PeratX edited this page May 14, 2020 · 8 revisions

欢迎来到 Mirai Native 的 Wiki 页面。

Mirai Native Wiki, built by PeratX.
Copyright (C) 2020 iTX Technologies All Rights Reserved.

Mirai Native API 文档

致开发者

  • DLL 字符串编码采用 GB18030
  • Mirai Native 内部使用了非阻塞，协程实现具体功能，调用所有API都立即返回，但是也有劣势，比如无法得知消息是否发送成功
  • 如果您的插件仅使用了酷Q兼容API，则可遵循原有协议或闭源；如果您的插件使用了Mirai独有API，则 必须 遵循 AGPL-v3 开放所有源代码，详见协议文本

使用 Mirai Native

运行环境

  • Java 8+ 32位，Windows环境，支持wine
  • 可能需要管理员权限，因为需要在Java目录下创建数据文件夹，如果不想授权管理员权限，请将JRE移动到不需要管理员权限的目录下

Tips

  • 待 Bot 上线后才会调用插件的 Enable 事件，托班菜单内才可以禁用插件

安装 Mirai Native

  1. 从官方QQ群或 Releases 获取 mirai-native-x.x.x.jar
  2. 将其放置到 mirai console 运行目录的 plugins 目录下

Mirai Native 目录结构

└─MiraiNative
    │  config.json // Mirai Native 配置文件
    │  CQP.dll // Mirai Native Bridge
    │
    ├─data // 原生插件数据文件夹
    │  ├─io.github.richardchien.coolqhttpapi // CQHTTP数据文件夹
    │  └─net.peratx.tester // Mirai Native API Tester数据文件夹
    │
    ├─libraries // 原生插件依赖的dll文件，最先被 Mirai Native加载
    │      libiconv.dll // 被 CQHTTP 依赖
    │      sqlite3.dll // 被 CQHTTP 依赖
    │
    └─plugins // 插件文件夹
            http.dll // CQHTTP插件dll
            http.json // CQHTTP插件json
            test.dll // Tester dll
            test.json // Tester json

如何获取及安装CQHTTP

  1. 加入Mirai官方群获取http.dll和http.json，或自行编译CQHTTP
  2. 将 libiconv.dll 和 sqlite3.dll 放入 MiraiConsole\plugins\MiraiNative\libraries 文件夹
  3. 将 http.dll和http.json 放入 MiraiConsole\plugins\MiraiNative\plugins 文件夹
  4. 启动 mirai console

重要：如果你正在使用控制台版Mirai-console(Pure)则需要进行以下步骤

  1. 完成上述安装过程并登录账号，你将会看到，此时控制台大概率会卡死
12:45:02 [INFO] [MiraiNative] [CQHTTP 配置] 没有找到配置文件，写入默认配置
12:45:02 [INFO] [MiraiNative] [CQHTTP 配置] 已加载的配置：
  1. 关闭软件
  2. 在CQHTTP的配置文件内进行以下修改
"show_log_console": false,    //不弹出独立控制台
"disable_coolq_log": false    //取消禁言酷Q日志系统，此设置项目可能需要手动添加

除以上修改外请按照你的需求自行修改其他配置项目

  1. 开启软件并完成登录，你会在mirai-console的控制台看到类似以下的内容
 12:51:08 [INFO] [MiraiNative] [CQHTTP 日志] 日志系统初始化完成
 12:51:08 [INFO] [MiraiNative] [CQHTTP 日志] 请在 酷Q 主目录的 MiraiNative\data\io.github.richardchien.coolqhttpapi\log\ 中查看日志文件
 12:51:08 [INFO] [MiraiNative] [CQHTTP HTTP] 开启 HTTP 服务器成功，开始监听 http://[::]:5700
  1. 配置完成
Clone this wiki locally