MaaAssistantArknights 连接 Android 实体设备全指南：ADB 调试、分辨率适配与无线连接-北京尧图网络

MaaAssistantArknights 连接 Android 实体设备全指南ADB 调试、分辨率适配与无线连接【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights本篇指南完整讲解如何将《明日方舟》小助手 MaaAssistantArknightsMAA连接到Android 实体手机设备上运行从下载 ADB 调试工具、开启 USB 调试并授权到通过wm size强制修改分辨率为 MAA 支持的16:9比例、修改屏幕密度DPI以修复账号切换问题再到有线/无线两种连接方式adb tcpip、adb pair、root 方案在 MAA「连接设置」中的落地配置。读完本文你将能在不使用模拟器的情况下通过实体设备完整跑通 MAA 的全日常挂机任务。::: warning 适用性说明本文方案涉及 ADB 命令行操作稳定性相对较低且仍需与电脑保持连接不推荐 0 基础玩家尝试。请先阅读连接设置了解 MAA 连接模块的整体概念再按本文操作。 :::一、连接前必须了解的五件事在动手之前请先对照以下五点检查你的设备和环境这直接决定了后续能否成功连接与稳定运行Android 10 及以上的 Minitouch 限制从 Android 10 开始默认触控模式 Minitouch 在 SELinux 为Enforcing模式时不再可用。此时需要切换至其他触控模式如 MaaTouch、ADB Input或将 SELinux临时切换为Permissive模式。Minitouch 是 MAA 的默认触控模式这一点在 Controller.h 中可以看到m_touch_mode TouchMode::Minitouch的默认值设定。连接配置需要反复尝试Android 生态极为复杂可在 MAA设置-连接设置中尝试将连接配置修改为通用模式、兼容模式、第二分辨率或通用模式屏蔽异常输出直到某个模式可以正常使用为止。分辨率必须是16:9MAA 仅支持16:9比例的分辨率非16:9或9:16屏幕比例的设备包含大多数现代设备必须强制修改分辨率。若设备屏幕原生就是16:9或9:16则可跳过「更改分辨率」部分。关闭全面屏手势请将设备导航方式切换为除全面屏手势以外的方式如经典导航键等避免 MAA 操作时误触发手势。调整异形屏 UI 适配请将游戏内设置中的异形屏UI适配调整为 0避免任务因屏幕裁切区域而出错。::: tip 参考典型16:9分辨率3840*21604K、2560*14402K、1920*10801080P、1280*720720P均为典型的16:9比例分辨率。 :::二、下载并运行 ADB 调试工具ADBAndroid Debug Bridge是 MAA 与实体设备通信的桥梁。MAA 底层正是通过 ADB 协议与设备交互——甚至在其自研的ADB Lite实现中MAA 直接以 TCP 与 ADB Server 通信完成adb devices、adb connect等操作参见 client.hpp 中「Equivalent toadb devices/adb connect serial」的注释。因此一台可用的 ADB 环境是一切的前提。按以下步骤准备 ADB下载谷歌官方提供的 ADB 工具包platform-tools-latest-windows.zip并解压。打开解压后的文件夹清空地址栏并输入cmd后回车在该目录打开命令提示符。输入adb并回车若输出大量英文帮助文本说明 ADB 运行成功。手机开启USB 调试每个品牌手机的进入方式不同请善用搜索引擎。部分厂商提供额外的 USB 调试选项如 MIUI 中的USB安装和USB调试安全设置请一并开启。用数据线将手机连接至电脑在命令提示符中执行adb devices执行成功后会列出已连接设备的信息例如List of devices attached VFNDU1682100xxxx devicedevice前的英文数字组合就是设备序列号Serial同时也是 MAA 的连接地址请务必记下。常见的异常输出及处理方式输出状态含义处理方式unauthorized设备未授权现代安卓设备进行 USB 调试时需在被调试设备上点击弹窗授权请检查手机屏幕完成授权offline设备离线重启设备及电脑后重试若仍未解决可删除当前用户个人文件夹下的.android文件夹后再次重启重试具体位置请自行搜索三、更改分辨率将设备强制调整为 16:9MAA 的截图识别与触控坐标都基于16:9比例设计源码中AdbController::screencap负责从设备拉取截图用于后续图像识别见 AdbController.cpp因此非 16:9 设备必须通过wm size修改分辨率。::: tip 重要概念手机屏幕分辨率写法是短边*长边而非电脑显示器的长边*短边。例如 1080P 在手机上应写成1080x1920。具体数值请根据目标设备自行确定。 :::单设备场景如果上文设备列表中仅有一台设备可直接运行以下命令# 查看当前分辨率 adb shell wm size # 还原默认分辨率 adb shell wm size reset # 更改分辨率为 720p adb shell wm size 720x1280 # 更改分辨率为 1080p adb shell wm size 1080x1920多设备场景若存在多台设备则需要在adb和shell之间添加-s 目标设备序列号来指定目标设备# 查看当前分辨率 adb -s VFNDU1682100xxxx shell wm size # 还原默认分辨率 adb -s VFNDU1682100xxxx shell wm size reset # 更改分辨率为 720p adb -s VFNDU1682100xxxx shell wm size 720x1280 # 更改分辨率为 1080p adb -s VFNDU1682100xxxx shell wm size 1080x1920::: danger 高危注意强烈建议在下次重启设备前还原分辨率否则因设备而定可能会导致不可预料的后果包括但不限于布局混乱、触控错位、应用闪退、无法解锁等。 :::另外部分设计不规范的应用可能在还原分辨率后内容布局仍然错乱一般重启对应应用或设备即可解决。账号切换异常修改屏幕密度DPI已知在部分实体设备上 MAA 的账号切换功能可能无法正常工作。由于 MAA 主要在电脑端模拟器环境工作并无计划修复该问题。如遇到此问题可通过以下任意一种方式修改屏幕密度DPI建议取值[100-800]使用指令直接修改 DPIadb shell wm density DPI调整开发者选项 → 最小宽度通过修改最小宽度间接修改 DPI注DPI与最小宽度成反比换算关系为最小宽度屏幕宽度(px) / (DPI / 160)。::: danger 风险提示该操作存在风险可能使设备工作异常请确保你知道自己在做什么设备故障后果自负。强烈建议在下次重启设备前还原这些更改。如忘记默认值无论使用何种方式修改均可使用指令adb shell wm density reset还原。 :::四、自动化更改分辨率startup.bat 与 finish.bat手动输入命令过于繁琐MAA 提供了「开始前脚本 / 结束后脚本」机制可以在任务开始前自动调整分辨率和亮度、任务结束后自动还原实现全程无人值守。操作步骤如下在 MAA 目录下新建两个文本文件分别填入以下内容:: 调整分辨率为 1080p adb -s 目标设备序列号 shell wm size 1080x1920 :: 降低屏幕亮度可选 adb -s 目标设备序列号 shell settings put system screen_brightness 1:: 还原分辨率 adb -s 目标设备序列号 shell wm size reset :: 提高屏幕亮度可选 adb -s 目标设备序列号 shell settings put system screen_brightness 20 :: 返回桌面可选 adb -s 目标设备序列号 shell input keyevent 3 :: 锁屏可选 adb -s 目标设备序列号 shell input keyevent 26将第一个文件重命名为startup.bat第二个文件重命名为finish.bat。若重命名后没有弹出修改扩展名的二次确认对话框且文件图标没有变化请自行搜索“Windows 如何显示文件扩展名”。在 MAA 的设置-运行设置-开始前脚本和结束后脚本中分别填入startup.bat和finish.bat。这样每次 MAA 启动任务时会先执行startup.bat完成分辨率和亮度调整任务结束后自动执行finish.bat还原并锁屏兼顾挂机效率与设备安全。五、连接 MAA有线连接::: tip 使用有线连接不需要任何 IP 地址或端口只需要adb devices给出的设备序列号。 :::将上文获取到的目标设备序列号填入 MAA设置-连接设置-连接地址中。Link Start!无线连接无线连接要求设备与电脑处于同一局域网且能互相通信。请注意AP 隔离、访客网络等路由器设置会阻止设备间通信具体请查阅对应路由器文档同时无线调试在设备重启后失效需要重新设置。无线连接有三种开启方式按需求选择方式一使用adb tcpip开启无线端口在命令提示符中输入以下命令开启无线调试存在多台设备则添加参数-s指定序列号adb tcpip 5555查看设备 IP 地址进入手机设置-WLAN点击当前已连接的无线网络查看 IP 地址各品牌设备设置位置不同请自行查找。将IP:5555填入 MAA设置-连接设置-连接地址例如192.168.1.2:5555。Link Start!方式二使用adb pair无线配对Android 11adb pair使用安卓 11 及更新版本开发者选项内的无线调试进行配对后连接与adb tcpip相比可以完全避免有线连接。进入手机开发者选项点击无线调试并开启点击确定点击使用配对码配对设备在配对完成前不要关闭弹出的配对窗口。进行配对在命令提示符中输入adb pair 设备弹窗给出的 IP 地址和端口回车输入设备弹窗给出的六位配对码回车窗口出现Successfully paired to IP:端口等内容同时设备上的弹窗自动消失底部已配对的设备列表中出现计算机名称。将当前设备屏幕上给出的IP 地址和端口填入 MAA设置-连接设置-连接地址例如192.168.1.2:11451——注意这个地址是设备屏幕上显示的那个和配对时用的端口一定不一样。Link Start!方式三使用 root 权限开启无线端口都接触到 root 了还用得着看这段文档吗笑此方式适合已取得 root 权限的高级用户。下载、安装 WADB 应用并授予其 root 权限。打开 WADB启动无线 adb。将 WADB 提供的 IP 地址及端口填入 MAA设置-连接设置-连接地址例如192.168.1.2:5555。Link Start!六、连接后的检查与故障排查成功填入连接地址后MAA 会通过 ADB 建立连接并探测截图与触控能力。若出现问题可从源码与配置两个层面排查触控模式MAA 的触控模式由InstanceOptionKey::TouchMode控制取值包括minitouch、maatouch、adb、MaaFwAdb、MumuExtras等参见 AsstTypes.h。在实体设备上若默认的 Minitouch 不可用如 Android 10 且 SELinux 为 EnforcingMinitouchController 会在连接阶段探测失败并抛出TouchModeNotAvailable回调参见 MinitouchController.cpp此时应在连接设置中切换触控模式。连接配置在连接设置中反复尝试通用模式、兼容模式、第二分辨率、通用模式屏蔽异常输出直到截图与触控正常。分辨率还原挂机结束后务必还原分辨率与 DPI避免设备出现布局混乱、触控错位等问题还原命令见第三、四节。关于 ADB 路径、自动检测、连接配置与触控模式的更多细节请参阅连接设置一文其中也说明了 MAA 对各模拟器连接地址的自动检测列表、ADB Lite 自研实现以 TCP 直连 ADB Server减少进程开销以及ADB Input触控模式在实体机上作为兜底方案的使用场景。【免费下载链接】MaaAssistantArknights《明日方舟》小助手全日常一键长草| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

MaaAssistantArknights 连接 Android 实体设备全指南：ADB 调试、分辨率适配与无线连接

相关推荐

MaaAssistantArknights 基建换班深度解析：常规模式调度算法、跨设施组合与自定义排班协议

一个文件跑完整套后端：PocketBase 从零到上线的实战指南

Anthropic-Cybersecurity-Skills 实战指南：AWS S3 数据外泄检测的 CloudTrail、GuardDuty 与 Athena 接口全参考

更多资讯

Beads 与 bd CLI 实战指南：用仓库级任务系统为 Coding Agent 建立持久工作记忆

CAN总线故障诊断：从掉帧到ECU固件的全链路排查

SEO优化失败原因与提升流量的系统解决方案

CAN自定义协议设计实战：ID规划、数据编码与容错机制

车载测试从理论到仿真：CANoe与ECU测试完整学习路径

PMSM电机FOC控制全解析：从坐标变换到无感调试

今日更新

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？