脚本引擎 API

系统操作 API

runtime.system.* 系统级操作:返回、主页、最近任务、打开应用和链接。通过无障碍服务或 Intent 执行。

当前:系统操作 API
脚本引擎 API

系统操作 API

runtime.system.* 系统级操作:返回、主页、最近任务、打开应用和链接。通过无障碍服务或 Intent 执行。

概述

执行系统级操作。全局手势 (BACK/HOME/RECENTS) 通过无障碍服务注入;打开应用和链接通过 Android Intent 启动。

方法列表

  • runtime.system.globalAction(type): void — 全局手势操作。type 支持 'BACK'/'HOME'/'RECENTS'。
  • runtime.system.back(): void — 模拟返回键(等效 globalAction('BACK'))。
  • runtime.system.home(): void — 回到桌面(等效 globalAction('HOME'))。
  • runtime.system.recents(): void — 打开最近任务(等效 globalAction('RECENTS'))。
  • runtime.system.openApp(packageName): void — 通过包名打开应用。需要应用已安装。
  • runtime.system.openLink(uri): void — 通过 Intent 打开链接(http/https 等协议)。

调用示例

// 返回桌面
runtime.system.home();
runtime.touch.sleep(500);
// 打开应用
runtime.system.openApp("com.example.app");
runtime.touch.sleep(2000);
// 多步导航
runtime.system.openApp("com.android.settings");
runtime.touch.sleep(1000);
// 如果页面有返回按钮,使用返回
runtime.touch.findAndClick("返回");
// 系统返回
runtime.system.back();
// 打开网页链接
runtime.system.openLink("https://example.com");