欢迎来到MiraiCP

• 欢迎来到MiraiCP
• 使用声明
• 许可
  • 使用流程:
    • 0 配置环境
    • 1 下载启动器(mcl)
    • 2 了解项目
    • 3 注意事项
    • 4 使用方法:
      • 4.1 使用release包
      • 4.2 使用源代码
    • TODO

使用声明

0. MiraiCP是一个Mirai 的C++语言的社区SDK，基于Mirai-console插件模板开发

1. 本项目仅供学习参考，禁止用于任何商业用途(根据Mirai的AGPLv3许可协议开源)。

2. 本项目不含有任何旨在破坏用户计算机数据和获取用户隐私的恶意代码，不含有任何跟踪、监视用户计算机功能代码，不会收集任何用户个人信息，不会泄露用户隐私。

3. 本项目不提供任何具体功能实现，仅仅只是对项目mirai-console和mirai-core(详见mirai仓库)的二次封装。

4. 任何单位或个人认为本项目可能涉嫌侵权，应及时提出反馈，本项目将会第一时间对违规内容给予删除等相关处理。

许可

Copyright (C) 2020-2021 Eritque arcus and contributors.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

使用流程:

0 配置环境

mcl需要openjdk而不是甲骨文的jdk

1 下载启动器(mcl)

下载地址笔者整合包 或 官方

2 了解项目

文件结构:

kotlin_mirai: 配套kotlin插件

mirai-demo: C++SDK

版本规则: 从2.2.0开始 (2021/1/31),版本前两位为Mirai的版本，后一位为SDK更新迭代版本

3 注意事项

1. 过于频繁向群聊或私聊发送信息会导致堆栈溢出，还在解决没观察过这个错误

2. 因为JNIEnv是局部变量，不了解jni请勿在SDK中使用多线程，如果要使用多线程的话，要保存全局JavaVM变量然后在多线程开头使用genv == JavaVM.GetEnv()覆盖全局Env，否则可能会报错，目前已添加定时计划的实现

4 使用方法:

4.1 使用release包

1. 下载release文件
2. 压缩包根目录下有个.jar文件留着下面有用
3. 打开mirai-demo文件夹下的.sln文件从而打开vs的c++项目，或者用其他方式打开位于mirai-dome目录下的c++项目
4. 在procession.cpp里自定义你自己的代码
5. 按照(x64 release)这个配置生成.dll文件
6. 看mirai-demo/x64/Release/这个路径下的mirai-demo.dll文件，留着下面有用
7. 打开上面下载的mcl文件夹
8. 把.jar文件拷贝进mcl的plugin文件夹下
9. 运行一次mcl，然后不管报错，不要登录，直接退出
10. 打开mcl目录下的data/org.example.miraiCP路径，把上面的.dll文件拷进来
11. 正常运行mcl

4.2 使用源代码

1. 下载源代码文件
2. 里面把kotlin_mirai用IDE打开
3. 运行gradle里面的buildplugin这个任务
4. 在/build/mirai/下获得.jar文件
5. 以下步骤同3.1

如果有其他问题，欢迎提交issue和提交PR贡献

目前支持的事件 events.md

项目设计流程 intro.md

代码示例 example.md

Mirai支持的qq表情对应序号 faces.md

进阶教程(在补了在补了[:wink:])

附:kotlin版开发模板

TODO

• 修复v1.0.1中发现的群聊频繁发送消息报错问题(堆栈溢出以及一个未知的错误)暂无再次观察到此现象
• 增加更多事件
• 写文档