Core 核心模块

核心模块提供 Android 系统的基础操作能力，包括点击、输入、截图等底层操作。这些模块通常需要配合 Shizuku 或 Root 权限使用。

模块列表

触摸回放 (Touch Replay)

录制触摸操作序列并回放，可调节回放速度。

输入参数：

参数	类型	默认值	说明
录制数据	触摸录制	必填	在编辑器中录制的触摸操作
回放速度	数字	1.0	回放速度倍率，支持小数

输出参数：

参数	类型	说明
success	布尔值	是否成功
event_count	数字	事件数量

权限要求： Core 权限

使用示例：

1. 在编辑器中点击"录制"按钮
2. 执行你想要自动化的操作
3. 点击"停止"完成录制
4. 添加"触摸回放"模块，选择录制的数据
5. 设置回放速度（可选）

按键操作 (Press Key)

模拟按下物理按键或虚拟按键。

输入参数：

参数	类型	默认值	说明
按键类型	枚举	必填	HOME、BACK、MENU、VOLUME_UP、VOLUME_DOWN 等

支持的按键：

• HOME - 返回桌面
• BACK - 返回键
• MENU - 菜单键
• VOLUME_UP - 音量加
• VOLUME_DOWN - 音量减
• POWER - 电源键
• NOTIFICATION - 通知栏

使用示例：

1. 添加"按键操作"模块
2. 选择"BACK"返回键
3. 执行工作流时将模拟返回操作

文本输入 (Input Text)

在当前焦点位置输入文本。

输入参数：

参数	类型	说明
文本内容	文本/魔法变量	要输入的内容
是否清空现有文本	布尔值	输入前是否清空当前输入框

输出参数：

参数	类型	说明
success	布尔值	是否成功

使用技巧：

• 建议配合"延时"模块使用，输入后等待界面响应
• 可以使用魔法变量引用之前模块的输出

屏幕截图 (Capture Screen)

截取当前屏幕图像。

输出参数：

参数	类型	说明
screenshot	图像	截取的屏幕图像
path	文本	图像保存路径

使用场景：

• 配合 OCR 模块识别屏幕文字
• 截图保存作为操作凭证
• 配合图像处理模块进行图像分析

剪贴板操作

CoreSetClipboard - 设置剪贴板

设置系统剪贴板内容。

输入参数：

参数	类型	说明
内容	文本/魔法变量	要复制到剪贴板的内容

CoreGetClipboard - 获取剪贴板

获取当前剪贴板内容。

输出参数：

参数	类型	说明
content	文本	剪贴板内容

屏幕状态控制

CoreWakeScreen - 唤醒屏幕

唤醒休眠的屏幕，确保持续执行自动化任务。

CoreSleepScreen - 休眠屏幕

使屏幕进入休眠状态。

网络状态

CoreWifiState - WiFi 状态

获取当前 WiFi 连接状态。

输出参数：

参数	类型	说明
connected	布尔值	是否已连接 WiFi
ssid	文本	网络名称 (SSID)
bssid	文本	接入点地址

CoreBluetoothState - 蓝牙状态

获取当前蓝牙连接状态。

输出参数：

参数	类型	说明
enabled	布尔值	蓝牙是否开启
connected	布尔值	是否已连接设备
device_name	文本	已连接设备名称

其他

CoreForceStopApp - 强制停止应用

强制停止指定应用。

输入参数：

参数	类型	说明
应用包名	文本/魔法变量	要停止的应用包名

权限要求： Core 权限

使用示例：

1. 使用"获取剪贴板"获取要停止的应用包名
2. 添加"强制停止应用"模块
3. 引用剪贴板内容作为包名参数

权限说明

Core 模块组中的模块需要以下权限：

• Core 权限 - 需要 Shizuku 或 Root 权限
• 无障碍服务 - 用于获取屏幕信息和执行点击

确保在执行包含 Core 模块的工作流前，已正确配置权限。