按键模拟

稳定

按键模拟部分提供了一些模拟物理按键的全局函数,包括 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

模拟按下电源键。

Root

模拟按下菜单键。

VolumeUp()

Root

按下音量上键。

VolumeDown()

Root

按键音量上键。

Camera()

模拟按下照相键。

Up()

Root

模拟按下物理按键上。

Down()

Root

模拟按下物理按键下。

Left()

Root

模拟按下物理按键左。

Root

模拟按下物理按键右。

OK()

Root

模拟按下物理按键确定。

Text(text)

  • text {string} 要输入的文字,只能为英文或英文符号

输入文字 text。例如Text("aaa");

KeyCode(code)

  • code {number} | {String} 要按下的按键的数字代码或名称。KeyCode 对照表
    模拟物理按键。例如KeyCode(29)KeyCode("KEYCODE_A")是按下 A 键。

附录: KeyCode 对照表

KeyCodeKeyEvent Value
KEYCODE_MENU1
KEYCODE_SOFT_RIGHT2
KEYCODE_HOME3
KEYCODE_BACK4
KEYCODE_CALL5
KEYCODE_ENDCALL6
KEYCODE_07
KEYCODE_18
KEYCODE_29
KEYCODE_310
KEYCODE_411
KEYCODE_512
KEYCODE_613
KEYCODE_714
KEYCODE_815
KEYCODE_916
KEYCODE_STAR17
KEYCODE_POUND18
KEYCODE_DPAD_UP19
KEYCODE_DPAD_DOWN20
KEYCODE_DPAD_LEFT21
KEYCODE_DPAD_RIGHT22
KEYCODE_DPAD_CENTER23
KEYCODE_VOLUME_UP24
KEYCODE_VOLUME_DOWN25
KEYCODE_POWER26
KEYCODE_CAMERA27
KEYCODE_CLEAR28
KEYCODE_A29
KEYCODE_B30
KEYCODE_C31
KEYCODE_D32
KEYCODE_E33
KEYCODE_F34
KEYCODE_G35
KEYCODE_H36
KEYCODE_I37
KEYCODE_J38
KEYCODE_K39
KEYCODE_L40
KEYCODE_M41
KEYCODE_N42
KEYCODE_O43
KEYCODE_P44
KEYCODE_Q45
KEYCODE_R46
KEYCODE_S47
KEYCODE_T48
KEYCODE_U49
KEYCODE_V50
KEYCODE_W51
KEYCODE_X52
KEYCODE_Y53
KEYCODE_Z54
KEYCODE_COMMA55
KEYCODE_PERIOD56
KEYCODE_ALT_LEFT57
KEYCODE_ALT_RIGHT58
KEYCODE_SHIFT_LEFT59
KEYCODE_SHIFT_RIGHT60
KEYCODE_TAB61
KEYCODE_SPACE62
KEYCODE_SYM63
KEYCODE_EXPLORER64
KEYCODE_ENVELOPE65
KEYCODE_ENTER66
KEYCODE_DEL67
KEYCODE_GRAVE68
KEYCODE_MINUS69
KEYCODE_EQUALS70
KEYCODE_LEFT_BRACKET71
KEYCODE_RIGHT_BRACKET72
KEYCODE_BACKSLASH73
KEYCODE_SEMICOLON74
KEYCODE_APOSTROPHE75
KEYCODE_SLASH76
KEYCODE_AT77
KEYCODE_NUM78
KEYCODE_HEADSETHOOK79
KEYCODE_FOCUS80
KEYCODE_PLUS81
KEYCODE_MENU82
KEYCODE_NOTIFICATION83
KEYCODE_SEARCH84
TAG_LAST_KEYCODE85