inputKey

abstract fun inputKey(scope: CoroutineScope, xpath: String, keySequence: String): Deferred<Boolean>

通过输入法通道 (InputConnection) 向指定元素发送按键序列或组合快捷键。

该方法模拟物理键盘的行为,能够触发系统级别的快捷键拦截(如 Ctrl+C, Ctrl+Enter 等)。 相比于 pressKey,此方法更接近真实用户的键盘输入流,适用于需要输入法联动的场景。

支持的格式:

  • 单个按键: "ENTER", "TAB", "BACKSPACE"

  • 组合快捷键 (使用 '+' 连接): "CTRL+ENTER", "CTRL+SHIFT+Z", "ALT+TAB"

  • 普通字母/数字: "A", "1"

Return

Deferred<Boolean>:操作成功返回 true,若元素未找到或无法建立输入连接则返回 false。

Parameters

scope

协程作用域。

xpath

目标元素的 XPath 路径。

keySequence

按键序列字符串,不区分大小写。支持修饰键:CTRL, SHIFT, ALT, META。

Throws

如果按键序列为空。