55bacfb468
添加新的触控方式，针对 macOS 平台原生运行的 iOS 版明日方舟客户端。 ## 背景 macOS 上有一个叫做 [PlayCover](https://playcover.io) 的 iOS 游戏启动器的项目。它的原理是通过注入库（[PlayTools](https://github.com/PlayCover/PlayTools)）让应用绕过系统的运行环境检查。 ## 实现 我们可以 [fork 一份 PlayTools](https://github.com/hguandl/PlayTools/tree/MaaTools)，添加一个功能类似 adb 的本地 server，来实现截图和触控。我们可以称其为 MaaTools。 ## 协议 当前的 MaaTools 基于 TCP 实现了以下协议： - 握手：`MAA\x00` 作为最初的 4 个字节发送以尝试建立连接，如果成功会收到 `OKAY`，连接就此建立。 - 请求体：后续请求会先有2字节作为长度，然后发送请求内容。 - 截图请求：内容为 `SCRN`，返回 4 字节头作为长度，然后紧接着是 RGBA bitmap 内容。 - 分辨率请求：内容为 `SIZE`，返回各 2 字节长度的宽和高。 - 触控请求：内容为 `TUCH` + 1 字节触控类型 + 各 2 字节长度的 x 和 y，无返回。 - 关闭请求：内容为 `TERM`，关闭客户端，无返回。 ## 合并 请 @aa889788 帮忙看看我对新 Controller 类的实现是否完全。iOS 不支持 ESC 按键，不知道除了不能暂停部署之外，会不会对 MAA 的其他功能造成影响。最后再让玛丽 @MistEO 把把关（）
MaaAssistantArknights
简体中文 | 繁體中文 | English | 日本語 | 한국어
MAA 的意思是 MAA Assistant Arknights
一款明日方舟游戏小助手
基于图像识别技术，一键完成全部日常任务！
绝赞更新中 ✿✿ヽ(°▽°)ノ✿
亮点功能
- 刷理智，掉落识别及上传 企鹅物流
- 智能基建换班，自动计算干员效率，单设施内最优解；同时也支持 自定义排班
- 自动公招，可选使用加急许可，一次全部刷完！公招数据上传 企鹅物流，一图流
- 访问好友、收取信用及购物、领取日常奖励等。一键全日常自动长草！
- 肉鸽全自动刷源石锭和蜡烛，自动识别干员及练度
- 选择作业 JSON 文件，自动抄作业！ 视频演示
- 仓库识别并支持导出至 企鹅物流刷图规划器, 明日方舟工具箱, ARK-NIGHTS 干员培养表
- 支持 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多种接口，方便集成调用，自定义你的 MAA！
话不多说，看图！
下载地址
使用说明
基本说明
- 请根据 模拟器支持情况，进行对应的操作。
- 修改模拟器分辨率为
16:9比例，最低1280 * 720，更高不限。 - 开始使用吧！
更多使用说明请参考 详细介绍
常见问题
- 软件一打开就闪退
- 连接错误、不知道 adb 路径怎么填写
- 连接成功了，但没反应
- 如何连接自定义端口
- 下载速度慢，且镜像站无法打开网页
- 下载到一半提示“登陆”/“鉴权”
- 连接正常，任务开始了，但是没反应
请参考 常见问题
外服支持
目前国际服（美服）、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足，很多功能并没有进行全面的测试，所以请自行体验。
若您遇到了 Bug，或对某个功能有强需求，欢迎在 Issues 和 讨论区 催更；或加入我们一起建设 MAA！请参考 外服适配教程
主要关联项目
目前项目组非常缺前端大佬，若您有相关经验，欢迎加入我们！
- 全新 GUI：MaaAsstElectronUI （正在开发中，欢迎加入！）
- 作业站 前端：maa-copilot-frontend （正在开发中，欢迎加入！）
- 作业站 后端：MaaBackendCenter
- 官网：前端
- 深度学习：MaaAI
致谢
开源库
- 图像识别库：opencv
文字识别库：chineseocr_lite- 文字识别库：PaddleOCR
- 深度学习部署库：FastDeploy
- 机器学习加速器：onnxruntime
关卡掉落识别：企鹅物流识别- 地图格子识别：Arknights-Tile-Pos
- C++ JSON库：meojson
- C++ 运算符解析器：calculator
C++ base64编解码：cpp-base64- C++ 解压压缩库：zlib
- C++ Gzip封装：gzip-hpp
- 安卓触控事件器：minitouch
- 安卓触控事件器：MaaTouch
- WPF MVVM框架：Stylet
- WPF控件库：HandyControl
- C# 日志：Serilog
- C# JSON库：Newtonsoft.Json & System.Text.Json
下载器：aria2
数据源
公开招募数据：明日方舟工具箱- 干员及基建数据：PRTS明日方舟中文WIKI
- 关卡数据：企鹅物流数据统计
- 游戏数据及资源：明日方舟bot常用素材
- 游戏数据：《明日方舟》游戏数据
贡献/参与者
感谢所有参与到开发/测试中的朋友们，是大家的帮助让 MAA 越来越好！ (*´▽｀)ノノ
开发相关
Windows
-
下载预构建的第三方库
python maadeps-download.py -
使用 Visual Studio 2022 打开
MAA.sln，右键MaaWpfGui，设为启动项目 -
VS 上方配置选择
RelWithDebInfox64（如果编译 Release 包 或 ARM 平台，请忽略这步） -
右键
MaaWpfGui- 属性 - 调试 - 启用本地调试（这样就能把断点挂到 C++ Core 那边了） -
（可选）若准备提交 PR，建议启用 clang-format 支持
Linux | macOS
请参考 Linux 编译教程
API
- C 接口：集成示例
- Python 接口：集成示例
- Golang 接口：集成示例
- Dart 接口
- Java 接口：集成示例
- Java HTTP 接口
- Rust 接口：HTTP 接口
- TypeScript 接口
- 集成文档
- 回调消息协议
- 任务流程协议
- 自动抄作业协议
外服适配
请参考 外服适配教程，对于国服已支持的功能，绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
想参与开发，但不太会用 Github?
Issue bot
请参考 Issue bot 使用方法
声明
- 本软件 logo 并非使用 AGPL 3.0 协议开源，耗毛、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo，不得在未经授权的情况下将本软件 logo 用于任何商业用途。
- 本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能是设备与时间等费用，产生的问题及后果与本软件无关。
广告
用户交流 QQ 群：MAA 使用 & 粥游交流 QQ 群
用户交流 TG 群：Telegram 群
自动战斗 JSON 作业分享：prts.plus 或 抄作业.com
Bilibili 直播间：直播间 每晚直播敲代码，近期很长一段时间应该都是在写本软件~
技术 & 吹水群（舟无关）：内卷地狱！(QQ 群)
开发者群：QQ 群
如果觉得软件对你有帮助，帮忙点个 Star 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！