按键按下

按下键盘按键（不释放）。

接口说明

接口类型

keyDown

参数

参数名	类型	必填	默认值	说明
deviceId	string	✅	-	设备 ID
key	string	✅	-	按键名称

key 参数可选值

支持的功能键：

按键	说明	示例用途
RIGHT	右箭头	向右导航
LEFT	左箭头	向左导航
DOWN	下箭头	向下导航
UP	上箭头	向上导航
ENTER	回车键	确认、换行
DEL	删除键	删除内容
BACKSPACE	退格键	删除字符
END	End 键	跳转到末尾
HOME	Home 键	跳转到开头
PAGEDOWN	PageDown 键	向下翻页
PAGEUP	PageUp 键	向上翻页
ESC	Esc 键	取消、退出
TAB	Tab 键	切换焦点
CTRL	Ctrl 键	控制键（组合键）
SHIFT	Shift 键	上档键（组合键）
ALT	Alt 键	替换键（组合键）
COMMAND	Command 键	macOS 组合键
F1 - F12	功能键	系统功能快捷键

💡 字母和数字键

字母键（A-Z）和数字键（0-9）请使用 sendKey 接口，该接口会自动处理按下和释放。

返回值

true  // 操作成功返回 true

基本使用

// 按下回车键
await apiInvoke('keyDown', {
    deviceId: 'P72578581E07',
    key: 'ENTER'
});

// 注意：必须配合 keyUp 使用
await apiInvoke('keyUp', {
    deviceId: 'P72578581E07',
    key: 'ENTER'
});