模式
不同的模式可以
共用一套代码,系统会自动用不同模式下的方法去实现相应功能目前 无障碍模式功能最全,且最稳定.
- 无障碍模式 , 图色模式/原HID模式 , 数字助理模式 , Root/激活模式
4种模式的区别
| 功能 | 无障碍 | 图色模式(原HID模式) | 数字助理模式 | Root或激活模式 |
|---|---|---|---|---|
| 动作 | ✅ | 虚拟HID或HID硬件 | ✅ | ✅ |
| 控件检索 | ✅ | ❌ | ✅ | ✅ |
| 图色检索: 找色,找图,文字识别,目标 | ✅ | ✅ | ✅ | ✅ |
| UI | ✅ | ✅ 透传模式部分机型不支持 | ✅ | ✅ 透传模式部分机型不支持 |
| 其他功能 | ✅ | ✅ | ✅ | ✅ |
| 权限需求 | 需开启无障碍 | 无需系统权限 | 助理授权 | Root / Shizuku |
| 适用场景 | APP类 | 游戏自动化 | 轻量接入 / 合规场景 | APP类 / 游戏自动化 / 模拟器 |
| 独立运行 | ✅ | ✅ | ✅ | ✅ |
无障碍模式
借助Android 的无障碍访问权限,来实现手机的自动化程序.
该模式较为稳定,且拥有最稳定,最兼容的权限.
该模式下,只需在手机上安装 AScript APP 即可编写运行程序.
安装APP后选择该 “无障碍模式运行” 即可
图色模式
图色模式下,不用开无障碍权限.
可通过 虚拟HID,HID物理硬件 执行点击,滑动,模拟按键等功能.
物理HID硬件魔鼠
使用物理HID硬件魔鼠,可 不用开启,开发者权限,无障碍权限 下执行动作.
虚拟HID
用电脑模拟虚拟HID设备,来达到执行动作的目的
- 我们可以按照以下方式,来完成HID的配置
1.驱动的安装
- mac 驱动的安装
brew install libusb
- windows驱动的安装
先行下载usb驱动,并双击打开
安装步骤:
2.软件安装与启动
根据您的电脑操作系统 下载HID设备管理器软件:
| 平台 |
|---|
| win-x64 |
| macos-x64 |
| macos-arm64 |
| linux-x64 |
3.HID的激活与初始化
::: danger 激活前注意事项
- 必须关闭开发者模式,否则可能会出现error -3 的错误.
:::
4.设备的绑定
::: danger 绑定前注意事项
- 请保持设备和电脑 处于同一个局域网,否则不可用.
:::
- 启动APP,选择HID模式
- 绑定IP地址 与 设备ID
数字助理模式
类似 Siri / 小爱同学 / Bixby 的系统数字助理通道——Android 原生为"数字助理类 App"留出的操作权限，AScript 作为数字助理接入后，无需开启无障碍权限即可对设备进行点击、控件检索、图色识别等自动化操作。
适合以下几类场景：
- 对"开启无障碍权限"有合规顾虑的团队
- 希望用户侧接入流程更轻量（少一步权限开关）
- 面向老人 / 无障碍辅助产品的二次开发
启用方式
- 安装 AScript App 并打开
- 进入 "设置 → 默认应用 → 数字助理应用"（不同品牌路径略有差异，下方已列出主流品牌入口）
- 将 AScript 设为默认数字助理应用
- 回到 App，选择
"数字助理模式运行"启动脚本
主流品牌入口参考
| 品牌 | 入口路径 |
|---|---|
| 原生 Android / Pixel | 设置 → 应用 → 默认应用 → 数字助理应用 |
| 小米 / Redmi | 设置 → 更多设置 → 无障碍 → 默认应用 → 数字助理 |
| 华为 / 荣耀 | 设置 → 系统和更新 → 默认应用 → 数字助理 |
| OPPO / OnePlus / realme | 设置 → 应用管理 → 默认应用 → 数字助理应用 |
| vivo | 设置 → 应用与权限 → 默认应用 → 数字助理应用 |
信息
- 数字助理模式下，控件检索、动作模拟、图色识别 均与无障碍模式行为一致，脚本基本无需改动。
- 设备重启后通常不会失效，但个别厂商在系统更新后可能需要重新指定默认数字助 理应用。
Root或激活模式
Root模式
如果您的设备已经具有Root权限.
则拥有最高权限,这种模式不用开启无障碍,对手机无系统版本要求.
适合于模拟器使用.
安装APP后选择该 “Root模式运行” 即可
激活模式
所谓激活模式是指: 给未Root的设备临时升权.
在激活模式下,可同样执行 adb shell指令, 且不用连接usb数据线.
激活步骤
-
- 需要安装第三方应用 Shizuku
-
- 通过adb 或无限调试激活shizuku
-
- 打开AScript程序,选择Root或激活模式
手机重启后失效.