按键模拟 - Keys

# Keys 按键模拟部分提供了一些模拟物理按键的全局函数,包括Home、音量键、照相键等,有的函数依赖于无障碍服务,有的函数依赖于root权限。 一般来说,以大写字母开头的函数都依赖于root权限。执行此类函数时,如果没有root权限,则函数执行后没有效果,并会在控制台输出一个警告。 ## 返回键 |back | 函数名 | 返回值 | 备注 | | ------ | ------ | ----------------------------------------------------------- | | back() | 布尔型 | 模拟按下返回键。返回是否执行成功。 此函数依赖于无障碍服务。 | back() * 返回 {boolean} 模拟按下返回键。返回是否执行成功。 此函数依赖于无障碍服务。 ## home键 |home | 函数名 | 返回值 | 备注 | | ------ | ------ | ----------------------------------------------------------- | | home() | 布尔型 | 模拟按下Home键。返回是否执行成功。 此函数依赖于无障碍服务。 | home() * 返回 {boolean} 模拟按下Home键。返回是否执行成功。 此函数依赖于无障碍服务。 ## 电源键菜单 |powerDialog | 函数名 | 返回值 | 备注 | | ------------- | ------ | ----------------------------------------------------------- | | powerDialog() | 布尔型 | 弹出电源键菜单。返回是否执行成功。 此函数依赖于无障碍服务。 | powerDialog() * 返回 {boolean} 弹出电源键菜单。返回是否执行成功。 此函数依赖于无障碍服务。 ## 拉出通知栏 |notifications | 函数名 | 返回值 | 备注 | | --------------- | ------ | ------------------------------------------------------- | | notifications() | 布尔型 | 拉出通知栏。返回是否执行成功。 此函数依赖于无障碍服务。 | notifications() * 返回 {boolean} 拉出通知栏。返回是否执行成功。 此函数依赖于无障碍服务。 ## 显示快速设置 |quickSettings | 函数名 | 返回值 | 备注 | | --------------- | ------ | ------------------------------------------------------------ | | quickSettings() | 布尔型 | 显示快速设置(下拉通知栏到底)。返回是否执行成功。 此函数依赖于无障碍服务。 | quickSettings() * 返回 {boolean} 显示快速设置(下拉通知栏到底)。返回是否执行成功。 此函数依赖于无障碍服务。 ## 显示最近任务 |recents | 函数名 | 返回值 | 备注 | | --------- | ------ | --------------------------------------------------------- | | recents() | 布尔型 | 显示最近任务。返回是否执行成功。 此函数依赖于无障碍服务。 | recents() * 返回 {boolean} 显示最近任务。返回是否执行成功。 此函数依赖于无障碍服务。 ## 分屏 |splitScreen | 函数名 | 返回值 | 备注 | | ------------- | ------ | ------------------------------------------------------------ | | splitScreen() | 布尔型 | 分屏。返回是否执行成功。 此函数依赖于无障碍服务, 并且需要系统自身功能的支持。 | splitScreen() * 返回 {boolean} 分屏。返回是否执行成功。 此函数依赖于无障碍服务, 并且需要系统自身功能的支持。 ## 模拟耳机键 | automator.headsetHook() | 函数名 | 返回值 | 备注 | | --------- | ------ | --------------------------------------------------------- | | automator.headsetHook() | 布尔型 | 模拟耳机键,返回是否执行成功。用于挂断、接听电话,播放、暂停音乐。 | automator.headsetHook() **\[[Pro 8.8.0新增](https://pro.autojs.org)\]** * 返回 {boolean} 模拟耳机键,返回是否执行成功。用于挂断、接听电话,播放、暂停音乐。 ## Home键 |Home | 函数名 | 返回值 | 备注 | | ------ | ------ | --------------------------------------- | | Home() | 布尔型 | 模拟按下Home键。 此函数依赖于root权限。 | Home() 模拟按下Home键。 此函数依赖于root权限。 ## 返回键 |Back | 函数名 | 返回值 | 备注 | | ------ | ------ | --------------------------------------- | | Back() | 布尔型 | 模拟按下返回键。 此函数依赖于root权限。 | Back() 模拟按下返回键。 此函数依赖于root权限。 ## 电源键 |Power | 函数名 | 返回值 | 备注 | | ------- | ------ | --------------------------------------- | | Power() | 布尔型 | 模拟按下电源键。 此函数依赖于root权限。 | Power() 模拟按下电源键。 此函数依赖于root权限。 ## 菜单键 |Menu | 函数名 | 返回值 | 备注 | | ------ | ------ | --------------------------------------- | | Menu() | 布尔型 | 模拟按下菜单键。 此函数依赖于root权限。 | Menu() 模拟按下菜单键。 此函数依赖于root权限。 ## 音量上键 |VolumeUp | 函数名 | 返回值 | 备注 | | ---------- | ------ | ------------------------------------- | | VolumeUp() | 布尔型 | 按下音量上键。 此函数依赖于root权限。 | VolumeUp() 按下音量上键。 此函数依赖于root权限。 ## 音量下键 |VolumeDown | 函数名 | 返回值 | 备注 | | ------------ | ------ | ------------------------------------- | | VolumeDown() | 布尔型 | 按键音量下键。 此函数依赖于root权限。 | VolumeDown() 按键音量上键。 此函数依赖于root权限。 ## 照相键 |Camera | 函数名 | 返回值 | 备注 | | -------- | ------ | ---------------- | | Camera() | 布尔型 | 模拟按下照相键。 | Camera() 模拟按下照相键。 ## 按键上 |Up | 函数名 | 返回值 | 备注 | | ------ | ------ | ------------------------------------------- | | Up() | 布尔型 | 模拟按下物理按键上。 此函数依赖于root权限。 | Up() 模拟按下物理按键上。 此函数依赖于root权限。 ## 按键下 |Down | 函数名 | 返回值 | 备注 | | ------ | ------ | ------------------------------------------- | | Down() | 布尔型 | 模拟按下物理按键下。 此函数依赖于root权限。 | Down() 模拟按下物理按键下。 此函数依赖于root权限。 ## 按键左 |Left | 函数名 | 返回值 | 备注 | | ------ | ------ | ------------------------------------------- | | Left() | 布尔型 | 模拟按下物理按键左。 此函数依赖于root权限。 | Left() 模拟按下物理按键左。 此函数依赖于root权限。 ## 按键右 |Right | 函数名 | 返回值 | 备注 | | ------- | ------ | ------------------------------------------- | | Right() | 布尔型 | 模拟按下物理按键右。 此函数依赖于root权限。 | Right() 模拟按下物理按键右。 此函数依赖于root权限。 ## 确定键 |OK | 函数名 | 返回值 | 备注 | | ------ | ------ | :-------------------------------------------- | | OK() | 布尔型 | 模拟按下物理按键确定。 此函数依赖于root权限。 | OK() 模拟按下物理按键确定。 此函数依赖于root权限。 ## 输入文字 |Text | 函数名 | 返回值 | 备注 | | ---------- | -------- | ----------------------------------------------------- | | Text(text) | | 只能为英文或英文符号 输入文字text。例如`Text(\"aaa\");` | | **参数名** | **类型** | | | 内容 | 文本型 | | Text(text) * text {string} 要输入的文字,只能为英文或英文符号 输入文字text。例如`Text("aaa");` ## 按键代码 |KeyCode | 函数名 | 返回值 | 备注 | | ------------- | -------- | ------------------------------------------------------- | | KeyCode(code) | | 要按下的按键的数字代码或名称。参见KeyCode对照表,模拟物理按键。 | | **参数名** | **类型** | | | 键码 | 整数型 | | KeyCode(code) * code {number} | <String> 要按下的按键的数字代码或名称。参见下表。 模拟物理按键。例如`KeyCode(29)`和`KeyCode("KEYCODE_A")`是按下A键。 # 附录: KeyCode对照表 ## 电话键 | 功能 | 键码 | | ------------ | ---- | | 拨号键 | 5 | | 挂机键 | 6 | | 按键Home | 3 | | 菜单键 | 82 | | 返回键 | 4 | | 搜索键 | 84 | | 拍照键 | 27 | | 拍照对焦键 | 80 | | 电源键 | 26 | | 通知键 | 83 | | 话筒静音键 | 91 | | 扬声器静音键 | 164 | | 音量增加键 | 24 | | 音量减小键 | 25 | ## 控制键 | 功能 | 键码 | | ---------------- | ---- | | 打开通讯录 | 207 | | 打开日历 | 208 | | 打开计算器 | 210 | | 屏幕亮度减 | 220 | | 屏幕亮度加 | 221 | | 息屏 | 223 | | 唤醒 | 224 | | 光标移动到开始键 | 122 | | 光标移动到末尾键 | 123 | | 向上翻页键 | 92 | | 向下翻页键 | 93 | | 删除键 | 112 | | 插入键 | 124 | | 小键盘锁 | 143 | | 滚动锁定键 | 116 | | 放大键 | 168 | | 缩小键 | 169 | | 向上键 | 19 | | 向下键 | 20 | | 向左键 | 21 | | 向右键 | 22 | | 回车键 | 66 | | ESC键 | 111 | | Tab键 | 61 | | 大写锁定键 | 115 | | 空格键 | 62 | | 退格键 | 67 | ## 组合键 | 功能 | 键码 | | ------- | ---- | | Ctrl键 | 113 | | ALT键 | 57 | | SHIFT键 | 59 | ## 多媒体键 | 功能 | 键码 | | ---------- | ---- | | 播放下一首 | 87 | | 播放上一首 | 88 | | 暂停播放 | 126 | | 恢复播放 | 127 | ## 数字键 | 功能 | 键码 | | :--- | ---- | | 键0 | 7 | | 键1 | 8 | | 键2 | 9 | | 键3 | 10 | | 键4 | 11 | | 键5 | 12 | | 键6 | 13 | | 键7 | 14 | | 键8 | 15 | | 键9 | 16 | ## 小键盘 | 功能 | 键码 | | ------- | ---- | | 小键盘0 | 144 | | 小键盘1 | 145 | | 小键盘2 | 146 | | 小键盘3 | 147 | | 小键盘4 | 148 | | 小键盘5 | 149 | | 小键盘6 | 150 | | 小键盘7 | 151 | | 小键盘8 | 152 | | 小键盘9 | 153 | ## 字母键 | 功能 | 键码 | | ---- | ---- | | A键 | 29 | | B键 | 30 | | C键 | 31 | | D键 | 32 | | E键 | 33 | | F键 | 34 | | G键 | 35 | | H键 | 36 | | I键 | 37 | | J键 | 38 | | K键 | 39 | | L键 | 40 | | M键 | 41 | | N键 | 42 | | O键 | 43 | | P键 | 44 | | Q键 | 45 | | R键 | 46 | | S键 | 47 | | T键 | 48 | | U键 | 49 | | V键 | 50 | | W键 | 51 | | X键 | 52 | | Y键 | 53 | | Z键 | 54 | ## 功能键 | 功能 | 键码 | | ----- | ---- | | F1键 | 131 | | F2键 | 132 | | F3键 | 133 | | F4键 | 134 | | F5键 | 135 | | F6键 | 136 | | F7键 | 137 | | F8键 | 138 | | F9键 | 139 | | F10键 | 140 | | F11键 | 141 | | F12键 | 142 | ## 符号键 | 功能 | 键码 | | ---------- | ---- | | 加号键 | 81 | | 减号键 | 69 | | 乘号键 | 17 | | 除号键 | 76 | | 等号键 | 70 | | 单引号键 | 75 | | 斜杠键 | 73 | | 逗号键 | 55 | | 圆点键 | 56 | | 左中括号键 | 71 | | 右中括号键 | 72 | | 分号键 | 74 | | 反撇号键 | 68 |