接口: Accessibility

更新: 2025/7/20 字数: 0 字 时长: 0 分钟

accessibility.Accessibility

无障碍服务

继承关系

• unknown

• EventEmitter

目录

属性

• service
• enabled

方法

• root
• rootOrNull
• windows
• enableService
• enableKeyEvents
• disableKeyEvents
• clearCache

属性

service

安卓无障碍服务实例

• readonly service: android.accessibilityservice.AccessibilityService | null

---

enabled

无障碍服务是否启用

• readonly enabled: boolean

方法

root

获取当前活跃窗口的根节点。若无障碍服务未启动，则会等待服务启动；若无法获取到根节点，则返回 null的Promise。

• root: Promise<UiObject | null>

---

rootOrNull

直接获取当前活跃窗口的根节点。若无障碍服务未启动，或无法获取到根节点，则返回 null。

• rootOrNull: UiObject | null

---

windows

• get windows: Array<AccessibilityWindow>

---

enableService

启用无障碍服务，若无权限将申请权限并等待用户授予权限

• enableService(options?): Promise<android.accessibilityservice.AccessibilityService>

参数

名称	类型
options?	"EnableServiceOptions"

返回值

Promise<android.accessibilityservice.AccessibilityService>;

---

on

监听Toast事件，当其他应用发出Toast时，会触发该事件。

• enableService("toast"): this

参数

名称	类型
event	"toast"
listener	(event: ToastEvent) => void

返回值

this

---

enableKeyEvents

启用按键监听，启用后可以通过key_event, key_down, key_up等事件监听按键。

• enableKeyEvents(): this

返回值

this

---

disableKeyEvents

禁用按键监听。

• disableKeyEvents(): this

返回值

this

---

on

按键事件，参考KeyEvent

• on("key_event"): this

参数

名称	类型
event	"key_event"
listener	(keyCode: number, event: android.view.KeyEvent) => void

返回值

this

---

on

按键按下事件，任意按键按下时触发

• on("key_down"): this

参数

名称	类型	备注
event	"key_down"	固定值为 "key_down"
listener	(keyCode: number, event: android.view.KeyEvent) => void	回调函数

返回值

this

---

on

按键弹起事件，任意按键弹起时触发

• on("key_up"): this

参数

名称	类型	备注
event	"key_up"	固定值为 "key_up"
listener	(keyCode: number, event: android.view.KeyEvent) => void	回调函数

返回值

this

---

clearCache

清除无障碍控件缓存。

• clearCache(): this

返回值

this