Auto.js中的一般全局函数

Posted 2022-12-30 aiguangyuan

1. 常用的全局函数

1. 暂停运行n毫秒的时间；

sleep(n)

n为毫秒数，1秒等于1000毫秒。

2. 以气泡显示消息几秒钟；

toast(message)

显示停留的时间取决于安卓系统，一般都是2秒。

3. 在控制台调试输出信息；

 log(message)

4. 在控制台和气泡中同时输出信息；

toastLog(message)

5. 立即停止脚本运行；

exit()

2. 返回当前监测包名和Activity

1. 获取最近一次监测到的正在运行的应用的包名，一般可以认为就是当前正在运行的应用的包名；

currentPackage()

2. 获取最近一次监测到的正在运行的Activity的名称，一般可以认为就是当前正在运行的Activity的名称；

 currentActivity()

3. 等待包名和Activity的出现

1. 等待指定的Activity出现；

waitForActivity(activity，[period = 200])

activity：Activity名称

period：轮询等待间隔（毫秒）

2. 等待指定的应用出现；

waitForPackage(package，[period = 200])

package：包名

period：轮询等待间隔（毫秒）

例如：waitForPackage("com.tencent.mm") 为等待当前界面为微信；

4. 剪切板：实现复制粘贴功能

1. 设置剪贴板内容。此剪贴板即系统剪贴板，在一般应用的输入框中"粘贴"既可使用；

setClip(text)

2. 获取系统剪贴板的内容；

getClip()

3. 粘贴剪贴板的内容；

paste()

5. 获取随机数

1. 获取在0和1之间的随机浮点数；

random()

2. 获取一个最小和最大之间的随机数；

random(min, max)

例如：random(0, 2)可能产生0, 1, 2；

6. 适配安卓版本和Auto.js版本

1. 判断该函数运行脚本的设备系统的版本号，如果没有达到要求则抛出异常；

requiresApi(api)

表示此脚本需要android API版本达到指定版本才能运行。

例如： requiresApi(19) 表示脚本需要在Android 4.4以及以上运行。

2. 判断该函数运行脚本的Auto.js的版本号，如果没有达到要求则抛出异常；

requiresAutojsVersion(version)

表示此脚本需要Auto.js版本达到指定版本才能运行。

例如：requiresAutojsVersion("3.0.0 Beta") 表示脚本需要在Auto.js 3.0.0 Beta以及以上运行。

版本号可以通过 app.autojs.versionCode 和 app.autojs.versionName 获取当前的Auto.js版本号和版本。