全局函数 - Globals
## 延时 |sleep
| 函数名 | 返回值 | 备注 |
| ---------- | -------- | --------------------- |
| sleep() | | 暂停运行n毫秒的时间。 |
| **参数名** | **类型** | |
| 时间 | 整数型 | 1秒等于1000毫秒。 |
```javascript
sleep(5000);
```
## 停止脚本 |exit
| 函数名 | 返回值 | 备注 |
| ------ | ------ | ------------------ |
| exit() | | 立即停止脚本运行。 |
```javascript
立即停止是通过抛出ScriptInterrupttedException来实现的，
因此如果用try...catch把exit()函数的异常捕捉，则脚本不会立即停止，仍会运行几行后再停止。
```
## 吐司信息 |toast
| 函数名 | 返回值 | 备注 |
| ------------ | -------- | ------------------------------------------------------------ |
| toast() | | 以气泡显示信息message几秒。(具体时间取决于安卓系统，一般都是2秒) |
| **参数名** | **类型** | |
| 要显示的信息 | 字符串 | |
```javascript
toast("text");
```
## 控制台吐司 |toastLog
| 函数名 | 返回值 | 备注 |
| ------------ | -------- | ------------------------------- |
| toastLog() | | 显示信息message并在控制台中输出 |
| **参数名** | **类型** | |
| 要显示的信息 | 字符串 | |
```javascript
toastLog("text")
相当于toast(message);log(message)。显示信息message并在控制台中输出。参见console.log。
```
## 置剪贴板 |setClip
| 函数名 | 返回值 | 备注 |
| ---------- | -------- | ---------------- |
| setClip() | | 设置剪贴板内容。 |
| **参数名** | **类型** | |
| 文本 | 字符串 | |
```javascript
setClip("剪贴板文本");
此剪贴板即系统剪贴板，在一般应用的输入框中"粘贴"既可使用。
```
## 取剪贴板 |getClip
| 函数名 | 返回值 | 备注 |
| --------- | ------ | -------------------- |
| getClip() | 字符串 | 取系统剪贴板的内容。 |
```javascript
toast("剪贴板内容为:" + getClip());
```
## 取随机数 |getClip
| 函数名 | 返回值 | 备注 |
| ---------- | ------------- | ------------------------------- |
| random() | 整数型/浮点型 | 取一个在[min...max]之间的随机数 |
| **参数名** | **类型** | |
| min | 整数型 | |
| max | 整数型 | |
```javascript
random(0,100) //返回一个在0..100之间的随机数。
random(0,1) //返回一个在[0-1]之间的随机浮点数0.1 0.2 0.3。
```
## 获取应用包名 |currentPackage
| 函数名 | 返回值 | 备注 |
| ---------------- | ------ | -------------------------- |
| currentPackage() | 字符串 | 取当前正在运行的应用的包名 |
```javascript
var str = currentPackage();
此函数依赖于无障碍服务，如果服务未启动，则抛出异常并提示用户启动。
```
## 获取应用Activity |currentActivity
| 函数名 | 返回值 | 备注 |
| ----------------- | ------ | ---------------------------------- |
| currentActivity() | 字符串 | 取当前正在运行的应用Activity的名称 |
```javascript
var str = currentActivity();
数依赖于无障碍服务，如果服务未启动，则抛出异常并提示用户启动。
```
## 检测应用包名 |waitForPackage
| 函数名 | 返回值 | 备注 |
| ---------------- | -------- | ------------------ |
| waitForPackage() | | 等待指定的应用出现 |
| **参数名** | **类型** | |
| 包名 | 字符串 | |
| 轮询等待间隔 | 整数型 | 毫秒 |
```javascript
waitForPackage("com.tencent.mm",1500)
```
## 检测应用Activity |waitForActivity
| 函数名 | 返回值 | 备注 |
| ----------------- | -------- | ---------------------- |
| waitForActivity() | | 等待指定的Activity出现 |
| **参数名** | **类型** | |
| Activity名称 | 字符串 | |
| 轮询等待间隔 | 整数型 | 毫秒 |
```javascript
waitForActivity("Activity",1500)
```
## 检测安卓版本 |requiresApi
| 函数名 | 返回值 | 备注 |
| ------------- | -------- | ------------------------------ |
| requiresApi() | | 判断运行脚本的设备系统的版本号 |
| **参数名** | **类型** | |
| Android版本号 | 字符串 | |
```javascript
requiresApi(19) //表示脚本需要在Android 4.4以及以上运行。
调用该函数时会判断运行脚本的设备系统的版本号，如果没有达到要求则抛出异常。
可以参考以下Android API和版本的对照表:
Android 7.0： 24
Android 6.0： 23
Android 5.1： 22
Android 5.0： 21
Android 4.4W： 20
Android 4.4： 19
Android 4.3： 18
```
## 检测Auto.js版本 |requiresAutojsVersion
| 函数名 | 返回值 | 备注 |
| ----------------------- | ------------- | ----------------------------- |
| requiresAutojsVersion() | | 判断运行脚本的Auto.js的版本号 |
| **参数名** | **类型** | |
| Auto.js的版本或版本号 | 字符串/整数型 | |
```javascript
requiresAutojsVersion("3.0.0 Beta") //表示脚本需要在Auto.js 3.0.0 Beta以及以上运行。
requiresAutojsVersion(250) //可以是整数表示版本号。
表示此脚本需要Auto.js版本达到指定版本才能运行。如果没有达到要求则抛出异常。
可以通过app.autojs.versionCode和app.autojs.versionName获取当前的Auto.js版本号和版本。
```