使用内置模块和函数

在学会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并开启：

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

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。

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

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

函数的文档链接

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

• sleep() 暂停一段时间
• toast() 显示气泡消息
• swipe() 滑动屏幕
• click() 点击屏幕
• device.width 设备屏幕宽度
• device.height 设备屏幕高度

更多的例子

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