脚本引擎 API

脚本引擎 API 总览

run_code 节点概述与 9 组运行时 API 索引:变量、网络、文件、屏幕、触控、视觉、节点、系统、流程。

当前:脚本引擎 API 总览
脚本引擎 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}}