按键模拟
稳定按键模拟部分提供了一些模拟物理按键的全局函数,包括 Home、音量键、照相键等,有的函数依赖于无障碍服务,有的函数依赖于 root 权限。
一般来说,以大写字母开头的函数都依赖于 root 权限。执行此类函数时,如果没有 root 权限,则函数执行后没有效果,并会在控制台输出一个警告。
back()
无障碍retrun
{boolean}
模拟按下返回键。返回是否执行成功。
home()
无障碍retrun
{boolean}
模拟按下 Home 键。返回是否执行成功。
powerDialog()
无障碍retrun
{boolean}
弹出电源键菜单。返回是否执行成功。
notifications()
无障碍retrun
{boolean}
拉出通知栏。返回是否执行成功。
quickSettings()
无障碍retrun
{boolean}
显示快速设置(下拉通知栏到底)。返回是否执行成功。
recents()
无障碍retrun
{boolean}
显示最近任务。返回是否执行成功。
splitScreen()
无障碍retrun
{boolean}
分屏。返回是否执行成功。
此函数需要系统自身功能的支持。
takeScreenshot()
无障碍 Android 9+retrun
{boolean}
模拟按键 电源键+音量下键 截屏
不返回截屏得到的图片对象,只返回是否截图成功,图片保存到系统相册
lockScreen()
无障碍Android 9+retrun
{boolean}
模拟按键 电源键 锁屏
dismissNotificationShade()
无障碍Android 12+retrun
{boolean}
关闭通知栏的操作
keyCodeHeadsetHook()
无障碍Android 12+retrun
{boolean}
发送 KEYCODE_HEADSETHOOK KeyEvent 的动作,用于接听/挂断通话和播放/停止媒体
accessibilityShortcut()
无障碍Android 12+retrun
{boolean}
触发辅助功能快捷方式的操作。此快捷方式有一个硬件触发器并且可以通过按住两个音量键来激活。
accessibilityButtonChooser()
无障碍Android 12+retrun
{boolean}
调出辅助功能按钮的选择器菜单的操作
accessibilityButton()
无障碍Android 12+retrun
{boolean}
触发辅助功能按钮的操作
accessibilityAllApps()
无障碍Android 12+retrun
{boolean}
显示 Launcher(启动器) 的所有应用的操作。
Home()
Root模拟按下 Home 键。
Back()
Root模拟按下返回键。
Power()
Root模拟按下电源键。
Menu()
Root模拟按下菜单键。
VolumeUp()
Root按下音量上键。
VolumeDown()
Root按键音量上键。
Camera()
模拟按下照相键。
Up()
Root模拟按下物理按键上。
Down()
Root模拟按下物理按键下。
Left()
Root模拟按下物理按键左。
Right()
Root模拟按下物理按键右。
OK()
Root模拟按下物理按键确定。
Text(text)
text
{string} 要输入的文字,只能为英文或英文符号
输入文字 text。例如Text("aaa");
KeyCode(code)
code
{number} | {String} 要按下的按键的数字代码或名称。KeyCode 对照表
模拟物理按键。例如KeyCode(29)
和KeyCode("KEYCODE_A")
是按下 A 键。
附录: KeyCode 对照表
KeyCode | KeyEvent Value |
---|---|
KEYCODE_MENU | 1 |
KEYCODE_SOFT_RIGHT | 2 |
KEYCODE_HOME | 3 |
KEYCODE_BACK | 4 |
KEYCODE_CALL | 5 |
KEYCODE_ENDCALL | 6 |
KEYCODE_0 | 7 |
KEYCODE_1 | 8 |
KEYCODE_2 | 9 |
KEYCODE_3 | 10 |
KEYCODE_4 | 11 |
KEYCODE_5 | 12 |
KEYCODE_6 | 13 |
KEYCODE_7 | 14 |
KEYCODE_8 | 15 |
KEYCODE_9 | 16 |
KEYCODE_STAR | 17 |
KEYCODE_POUND | 18 |
KEYCODE_DPAD_UP | 19 |
KEYCODE_DPAD_DOWN | 20 |
KEYCODE_DPAD_LEFT | 21 |
KEYCODE_DPAD_RIGHT | 22 |
KEYCODE_DPAD_CENTER | 23 |
KEYCODE_VOLUME_UP | 24 |
KEYCODE_VOLUME_DOWN | 25 |
KEYCODE_POWER | 26 |
KEYCODE_CAMERA | 27 |
KEYCODE_CLEAR | 28 |
KEYCODE_A | 29 |
KEYCODE_B | 30 |
KEYCODE_C | 31 |
KEYCODE_D | 32 |
KEYCODE_E | 33 |
KEYCODE_F | 34 |
KEYCODE_G | 35 |
KEYCODE_H | 36 |
KEYCODE_I | 37 |
KEYCODE_J | 38 |
KEYCODE_K | 39 |
KEYCODE_L | 40 |
KEYCODE_M | 41 |
KEYCODE_N | 42 |
KEYCODE_O | 43 |
KEYCODE_P | 44 |
KEYCODE_Q | 45 |
KEYCODE_R | 46 |
KEYCODE_S | 47 |
KEYCODE_T | 48 |
KEYCODE_U | 49 |
KEYCODE_V | 50 |
KEYCODE_W | 51 |
KEYCODE_X | 52 |
KEYCODE_Y | 53 |
KEYCODE_Z | 54 |
KEYCODE_COMMA | 55 |
KEYCODE_PERIOD | 56 |
KEYCODE_ALT_LEFT | 57 |
KEYCODE_ALT_RIGHT | 58 |
KEYCODE_SHIFT_LEFT | 59 |
KEYCODE_SHIFT_RIGHT | 60 |
KEYCODE_TAB | 61 |
KEYCODE_SPACE | 62 |
KEYCODE_SYM | 63 |
KEYCODE_EXPLORER | 64 |
KEYCODE_ENVELOPE | 65 |
KEYCODE_ENTER | 66 |
KEYCODE_DEL | 67 |
KEYCODE_GRAVE | 68 |
KEYCODE_MINUS | 69 |
KEYCODE_EQUALS | 70 |
KEYCODE_LEFT_BRACKET | 71 |
KEYCODE_RIGHT_BRACKET | 72 |
KEYCODE_BACKSLASH | 73 |
KEYCODE_SEMICOLON | 74 |
KEYCODE_APOSTROPHE | 75 |
KEYCODE_SLASH | 76 |
KEYCODE_AT | 77 |
KEYCODE_NUM | 78 |
KEYCODE_HEADSETHOOK | 79 |
KEYCODE_FOCUS | 80 |
KEYCODE_PLUS | 81 |
KEYCODE_MENU | 82 |
KEYCODE_NOTIFICATION | 83 |
KEYCODE_SEARCH | 84 |
TAG_LAST_KEYCODE | 85 |