脚本引擎 API
脚本引擎 API 总览
run_code 节点概述与 9 组运行时 API 索引:变量、网络、文件、屏幕、触控、视觉、节点、系统、流程。
概述
run_code 是编辑器中的「脚本执行」动作节点,通过嵌入式 JavaScript 引擎(Rhino)提供运行时代码执行能力。
脚本内通过全局对象 runtime 访问所有运行时 API。所有触控、视觉、网络操作均以同步阻塞方式调用。
编辑器底部工具栏点击「脚本执行」(代码图标) 添加 run_code 节点,在属性面板中编辑 JS 代码、设置超时和结果变量绑定。
9 组 API 索引
每组 API 对应独立的详细文档页,包含完整参数说明和可复制的代码示例。
- 变量操作 —
runtime.variables.*:读写脚本变量。 - 网络请求 —
runtime.network.*:HTTP 请求与响应。 - 文件操作 —
runtime.files.*:设备文件读写。 - 屏幕信息 —
runtime.screen.*:屏幕状态、尺寸、截屏与唤醒。 - 触控操作 —
runtime.touch.*:点击、滑动、长按、文字查找与输入。 - 视觉检测 —
runtime.vision.*:文字/图片检测与等待。 - 节点操作 —
runtime.nodes.*:无障碍节点树操作。 - 系统操作 —
runtime.system.*:返回、主页、打开应用与链接。 - 流程控制 —
runtime.process.*:日志与脚本终止。
run_code 节点结构
定义「脚本执行」动作节点的 JSON 结构:
- language: 脚本语言,当前仅支持 "javascript"。
- code: JS 代码内容(与 codeVarKey 二选一)。建议在属性面板直接编辑,避免 JSON 转义。
- codeVarKey: 从变量中读取代码内容(与 code 二选一)。
- bindResultToVar: 可选,将 JS 返回值绑定到指定变量名。
- timeoutMs: 执行超时(毫秒),默认 30000,建议不超过 60000。
{"type": "action", "action": {"type": "run_code", "language": "javascript", "code": "runtime.touch.tap(540, 1100);", "codeVarKey": "", "bindResultToVar": "", "timeoutMs": 30000}}