按键模拟 - Keys
按键模拟部分提供了一些模拟物理按键的全局函数,包括Home、音量键、照相键等,有的函数依赖于无障碍服务,有的函数依赖于root权限。
一般来说,以大写字母开头的函数都依赖于root权限。执行此类函数时,如果没有root权限,则函数执行后没有效果,并会在控制台输出一个警告。
## 返回键 |back
| 函数名 | 返回值 | 备注 |
| ------ | ------ | ----------------------------------------------------------- |
| back() | 布尔型 | 模拟按下返回键。返回是否执行成功。 此函数依赖于无障碍服务。 |
## home键 |home
| 函数名 | 返回值 | 备注 |
| ------ | ------ | ----------------------------------------------------------- |
| home() | 布尔型 | 模拟按下Home键。返回是否执行成功。 此函数依赖于无障碍服务。 |
## 电源键菜单 |powerDialog
| 函数名 | 返回值 | 备注 |
| ------------- | ------ | ----------------------------------------------------------- |
| powerDialog() | 布尔型 | 弹出电源键菜单。返回是否执行成功。 此函数依赖于无障碍服务。 |
## 拉出通知栏 |notifications
| 函数名 | 返回值 | 备注 |
| --------------- | ------ | ------------------------------------------------------- |
| notifications() | 布尔型 | 拉出通知栏。返回是否执行成功。 此函数依赖于无障碍服务。 |
## 显示快速设置 |quickSettings
| 函数名 | 返回值 | 备注 |
| --------------- | ------ | ------------------------------------------------------------ |
| quickSettings() | 布尔型 | 显示快速设置(下拉通知栏到底)。返回是否执行成功。 此函数依赖于无障碍服务。 |
## 显示最近任务 |recents
| 函数名 | 返回值 | 备注 |
| --------- | ------ | --------------------------------------------------------- |
| recents() | 布尔型 | 显示最近任务。返回是否执行成功。 此函数依赖于无障碍服务。 |
## 分屏 |splitScreen
| 函数名 | 返回值 | 备注 |
| ------------- | ------ | ------------------------------------------------------------ |
| splitScreen() | 布尔型 | 分屏。返回是否执行成功。 此函数依赖于无障碍服务, 并且需要系统自身功能的支持。 |
## Home键 |Home
| 函数名 | 返回值 | 备注 |
| ------ | ------ | --------------------------------------- |
| Home() | 布尔型 | 模拟按下Home键。 此函数依赖于root权限。 |
## 返回键 |Back
| 函数名 | 返回值 | 备注 |
| ------ | ------ | --------------------------------------- |
| Back() | 布尔型 | 模拟按下返回键。 此函数依赖于root权限。 |
## 电源键 |Power
| 函数名 | 返回值 | 备注 |
| ------- | ------ | --------------------------------------- |
| Power() | 布尔型 | 模拟按下电源键。 此函数依赖于root权限。 |
## 菜单键 |Menu
| 函数名 | 返回值 | 备注 |
| ------ | ------ | --------------------------------------- |
| Menu() | 布尔型 | 模拟按下菜单键。 此函数依赖于root权限。 |
## 音量上键 |VolumeUp
| 函数名 | 返回值 | 备注 |
| ---------- | ------ | ------------------------------------- |
| VolumeUp() | 布尔型 | 按下音量上键。 此函数依赖于root权限。 |
## 音量下键 |VolumeDown
| 函数名 | 返回值 | 备注 |
| ------------ | ------ | ------------------------------------- |
| VolumeDown() | 布尔型 | 按键音量下键。 此函数依赖于root权限。 |
## 照相键 |Camera
| 函数名 | 返回值 | 备注 |
| -------- | ------ | ---------------- |
| Camera() | 布尔型 | 模拟按下照相键。 |
## 按键上 |Up
| 函数名 | 返回值 | 备注 |
| ------ | ------ | ------------------------------------------- |
| Up() | 布尔型 | 模拟按下物理按键上。 此函数依赖于root权限。 |
## 按键下 |Down
| 函数名 | 返回值 | 备注 |
| ------ | ------ | ------------------------------------------- |
| Down() | 布尔型 | 模拟按下物理按键下。 此函数依赖于root权限。 |
## 按键左 |Left
| 函数名 | 返回值 | 备注 |
| ------ | ------ | ------------------------------------------- |
| Left() | 布尔型 | 模拟按下物理按键左。 此函数依赖于root权限。 |
## 按键右 |Right
| 函数名 | 返回值 | 备注 |
| ------- | ------ | ------------------------------------------- |
| Right() | 布尔型 | 模拟按下物理按键右。 此函数依赖于root权限。 |
## 确定键 |OK
| 函数名 | 返回值 | 备注 |
| ------ | ------ | :-------------------------------------------- |
| OK() | 布尔型 | 模拟按下物理按键确定。 此函数依赖于root权限。 |
## 输入文字 |Text
| 函数名 | 返回值 | 备注 |
| ---------- | -------- | ----------------------------------------------------- |
| Text(text) | | 只能为英文或英文符号 输入文字text。例如`Text("aaa");` |
| **参数名** | **类型** | |
| 内容 | 文本型 | |
## 按键代码 |KeyCode
| 函数名 | 返回值 | 备注 |
| ------------- | -------- | ------------------------------------------------------- |
| KeyCode(code) | | 要按下的按键的数字代码或名称。参见KeyCode对照表,模拟物理按键。 |
| **参数名** | **类型** | |
| 键码 | 整数型 | |