Skip to content

feat: add macOS PlayCover/MaaTools support - #238

Draft
WenSilvia wants to merge 1 commit into
AzurTian:minefrom
WenSilvia:agent/add-macos-playcover-maatools-support-azurtian
Draft

feat: add macOS PlayCover/MaaTools support#238
WenSilvia wants to merge 1 commit into
AzurTian:minefrom
WenSilvia:agent/add-macos-playcover-maatools-support-azurtian

Conversation

@WenSilvia

Copy link
Copy Markdown

中文

本 PR 将 runhey/OnmyojiAutoScript#1720 的 macOS PlayCover/MaaTools 支持移植到 AzurTian 的 mine 分支,并按当前设备层接口做了最小适配。接入思路参考 MAA macOS PlayCover/MaaTools 使用方案

主要改动

  • 新增 PlayCover MaaTools 握手、截图和触控通信。
  • 新增 MacPlayTools 控制方式。
  • 新增 MacBGRRGBAMacSCK 截图方式。
  • PlayCover 路径跳过 ADB 初始化;原有 ADB、uiautomator2 和 minitouch 路径保持不变。
  • PlayCover 截图要求为 1280×720
  • 新增 macOS 手动依赖清单 requirements-macos-playcover.txt
  • README 增加中英文 macOS 使用说明。

使用方式

  1. 安装带 MaaTools 的 PlayCover,并参考 MAA macOS 手册完成设置。
  2. OASX Flutter 源码编译并运行 macOS 本地 app。
  3. requirements-macos-playcover.txt 手动安装 Python 依赖。
  4. 将 PlayCover 游戏分辨率设置为 1280×720
  5. 在 OASX 中选择 PlayCover(MacPlayTools),截图方式选择 MacBGRRGBAMacSCK,并填写 MaaTools 地址,例如 localhost:1718
  6. Android 模拟器仍可继续选择 ADB 或 minitouch。

本 PR 不包含 OASX app 二进制,也不内置 Python、OCR 或 OAS 服务。

验证

  • PlayCover 协议测试:7/7
  • 设备接线与 ADB/minitouch 共存测试:6/6
  • 总计:13/13

English

This PR ports the macOS PlayCover/MaaTools support from runhey/OnmyojiAutoScript#1720 to AzurTian's mine branch with minimal adaptations for its current device layer. The integration follows the approach documented in the MAA macOS PlayCover/MaaTools guide.

Changes

  • Add PlayCover MaaTools handshake, screenshot, and touch communication.
  • Add MacPlayTools as a control method.
  • Add MacBGR, RGBA, and MacSCK screenshot methods.
  • Skip ADB initialization for PlayCover while preserving existing ADB, uiautomator2, and minitouch paths.
  • Require 1280×720 PlayCover screenshots.
  • Add requirements-macos-playcover.txt for manual macOS dependency installation.
  • Add bilingual macOS setup instructions to README.

Usage

  1. Install a PlayCover build that includes MaaTools and follow the MAA macOS guide.
  2. Build and run a local macOS app from the OASX Flutter source.
  3. Install Python dependencies from requirements-macos-playcover.txt.
  4. Set the PlayCover game resolution to 1280×720.
  5. Select PlayCover (MacPlayTools) in OASX, choose MacBGR, RGBA, or MacSCK, and enter the MaaTools address, for example localhost:1718.
  6. Existing Android emulator configurations can continue to use ADB or minitouch.

This PR does not include an OASX app binary and does not bundle Python, OCR, or the OAS service.

Validation

  • PlayCover protocol tests: 7/7
  • Device wiring and ADB/minitouch coexistence tests: 6/6
  • Total: 13/13

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant