MiraiAndroid

mirai-console的Android前端程序，可作为qq机器人使用，支持多种脚本接口，已适配MiraiConsole 2.0

如果你不知道什么是mirai或者是mirai-console，请到这里了解更多信息mirai

相比使用Termux或者是Linux Deploy等应用运行mirai的方案，该项目提供的方案具有更好的性能以及更少的资源占用，但可能存在兼容性问题

最新的构建版本你可以到release或QQ群内找到

MiraiAndroid交流群：1131127734但是请注意，如果您违反了群内相关规定或是有其他不当行为你可能会被无理由移出本群

MiraiForum：mirai官方论坛 https://mirai.mamoe.net

图标以及形象由画师DazeCake绘制

声明

一切开发旨在学习，请勿用于非法用途

• MiraiAndroid 是完全免费且开放源代码的软件，仅供学习和娱乐用途使用
• MiraiAndroid 不会通过任何方式强制收取费用，或对使用者提出物质条件
• MiraiAndroid 由整个开源社区维护，并不是属于某个个体的作品，所有贡献者都享有其作品的著作权。

许可证

Copyright (C) 2019-2020 Mamoe Technologies 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/>.

MiraiAndroid 采用 AGPLv3 协议开源。为了整个社区的良性发展，我们强烈建议您做到以下几点：

• 间接接触（包括但不限于使用 httpapi 或 跨进程技术）到 mirai 的软件使用 AGPLv3 开源
• 不鼓励，不支持一切商业使用

已实现的功能

• 兼容mirai-console插件(实验性)
• 带验证码的登录处理
• 内置Google d8 dex编译器，可直接编译JVM的console插件在Android运行(实验性)
• lua脚本接口（测试版）
• 网络掉线提醒

安装脚本

目前脚本系统仍在开发中，对于2.x版本的lua或js脚本系统正在迁移中，请等待后续更新

安装插件

对于apk(Android软件包)格式的插件，请直接安装到系统内即可，关于这类插件的开发说明请看这里

对于jar格式的插件，你有两个办法安装插件

使用app直接打开jar文件安装

这是最简单的方式。app切换到插件管理点击右上角选择即可，你也可以使用系统文件选择器直接打开jar文件

对于已经经过d8转换过的插件，请直接导入

如果你无法选择文件，请使用第三方文件选择器选择（例如Mix）

使用pc转换后导入

请按照以下方法操作

• 找到d8编译器的运行脚本

d8工具已在新版Android sdk中自带，它就在build-tools中对应版本的文件夹下。在Windows平台他是一个bat文件

如果没有可到上面的交流群内下载

• 编译

打开终端，使用以下命令编译

d8.bat --output 输出文件.jar 源文件

输出文件扩展名必须是jar或者是zip

• 复制资源

使用压缩软件打开源jar文件，将里面的plugin.yml，META-INF和其他资源文件(除存放class文件夹的其他文件)复制到新的jar文件内

• 安装插件

将上一步的新的jar文件复制到手机的/sdcard/Android/data/io.github.mzdluo123.mirai.android/files/plugins/

重启即可使用插件，当然部分插件可能也会存在兼容性问题

FAQ

Q: 后台运行被系统杀死
A：请手动将应用添加到系统后台白名单

Q：应用崩溃或后台报错
A：如果是后台报错一般是插件或者是mirai-core的问题，是mirai-core的问题请在菜单内找到分享日志并到群内或开启issue反馈，插件的问题请联系对应开发者；如果是应用崩溃，请重启并按照上面的方法提交日志给我们

兼容的Console插件列表

以下插件由群友测试未发现问题，你可以到群内下载，或是到插件中心手动下载jvm版并导入

• mirai-api-http
• chatcommand

对于其他插件请自行尝试；此外，如果你的插件使用了一些Android不支持的api(例如BufferedImage)那么使用了这个api的功能将绝对不能正常工作

关于支持的Android版本

MiraiAndroid只能在Android8.0及以上版本的系统中工作，因为上游MiaiCore使用了大量Java8特性

目前测试过的版本中Android10无问题，Android8.1无法在移动端编译插件

消息推送(2.9新增)

必须使用自动登录并在设置中开启才能使用该功能

你可以发送广播来快速向指定群或联系人推送信息，这里是data的URI格式

ma://sendGroupMsg?msg=消息&id=群号
ma://sendFriendMsg?msg=消息&id=账号
ma://sendFriendMsg?msg=消息&id=账号&at=要at的人

sendBroadcast(Intent("io.github.mzdluo123.mirai.android.PushMsg").apply {
        data = Uri.parse("ma://sendGroupMsg?msg=HelloWorld&id=655057127")
    })

以下是auto.js的示例

app.sendBroadcast({
    action: "io.github.mzdluo123.mirai.android.PushMsg",
    data: "ma://sendGroupMsg?msg=来自autojs的消息&id=655057127"
})

以下是tasker的示例

    ma (2)
    	A1: 发送意图 [ 操作:io.github.mzdluo123.mirai.android.PushMsg 类别:None Mime类型: 数据:ma://sendGroupMsg?msg=来自tasker的消息&id=655057127 额外: 额外: 额外: 包: 类: 目标:Broadcast Receiver ]