使用内置模块和函数

2022年10月22日

使用内置模块和函数

在学会JavaScript基础后,你便可以尝试使用Auto.js自带的函数和模块了。类似于之前的toastLog函数,Auto.js内置了很多函数和模块。这些函数和模块都可以在文档中找到。

文档链接:第一代API文档

在文档的左侧菜单(手机需要点击左上角按钮展开)是模块列表,列出每个模块的功能和名字。例如app模块用于启动其他应用、获取其他应用信息等。

在第一代API中,所有模块都可以直接使用而无需导入。例如,我们需要使用app模块的launchApp函数来启动其他应用:

$app.launchApp("日历");

在这行代码中,$app表示app模块(前面的$符号表示这是内置模块,避免和你自定义的变量冲突),launchApp则是app模块的函数。

通过阅读这个函数的文档我们知道,这个函数的作用是通过应用名称启动一个应用,运行后可启动日历应用。

一个小例子

这里给一个小例子,它将滑动Auto.js Pro的示例页面3次,并点击页面的中间位置。

Step 1: 打开无障碍权限

在Auto.js Pro的主界面侧拉菜单中,打开无障碍服务的开关。此时会跳转系统的无障碍权限界面,在界面中找到,打开Auto.js Pro的开关。

无障碍服务开关

这里以小米为例:

已下载的应用

在已下载的应用中选择AutoJsPro并开启:

AutoJsPro无障碍服务

打开权限时系统可能会提示无障碍是高危权限。这是因为无障碍权限可以让应用获取屏幕的内容并模拟操作,因此请勿随意运行网络上下载的代码

Step 2: 创建文件

用Auto.js Pro新建一个文件,将以下代码复制进去,保存文件,先不要运行

代码的主要内容均有注解,一时看不懂也没关系,后面会有用到的每个函数的文档链接

// 暂停2000毫秒,也即2秒
sleep(2000);
// 气泡提示开始运行
toast("开始执行");

// 循环3次
for (var i = 0; i < 3; i++) {
   // 从屏幕的(500, 三分之二高度)位置滑动到屏幕的(500, 三分之一高度位置),时长300毫秒
   // 这个操作相当于上滑屏幕
   // device.height是获取屏幕的高度
   swipe(500, device.height / 3 * 2, 500, device.height / 3, 300);
   // 暂停1秒
   sleep(1000);
}

// 点击屏幕中心位置,device.width是获取屏幕的宽度
click(device.width / 2, device.height / 2)

// 气泡提示执行结束
toast("执行结束");

Step 3: 打开悬浮控制

点击编辑器上方工具栏的”调试“按钮,选择”悬浮运行“。如果之前没有授予过悬浮窗权限,则此时会提示没有悬浮窗并跳转系统界面,需要你授予悬浮窗(显示在其他应用上层)权限。

调试菜单

授权后将弹出一个绿色的悬浮控制条,我们可以使用它随时开始和停止代码的运行。

悬浮控制

Step 4: 运行测试

退出编辑器界面,回到Auto.js Pro主界面,切换到示例的Tab。

示例Tab

点击悬浮窗控制条的运行▶️按钮,此时会开始执行代码,自动滑动屏幕3次,并点击屏幕中间。

如果这里运行的时候,提示“无障碍已启动但并未运行,这可能是Android的Bug”,参见常见问题

函数的文档链接

以下为这个例子中使用到的模块、函数、变量的文档链接:

更多的例子

在Auto.js Pro的主页面,切换到示例的Tab,这里有大量的官方示例。

更多的例子

上次编辑于:
贡献者: hyb1996