Skip to content

发送按键 ​

发送完整的按键事件,自动处理按下和释放,支持单键、多键和组合键。

⚠️ 提示:sendKey 仅能输入键盘字符(英文字母、数字和常见符号),不支持其它语言或任意文本。如果需要发送任意文字到设备,请参考 发送文本。

接口说明 ​

接口类型 ​

sendKey

参数 ​

参数名类型必填说明
deviceIdstring✅设备 ID
keystring✅按键(支持+拼接)
fnkeystring❌功能键/修饰键(如 CTRL、SHIFT 等,支持+拼接)

返回值 ​

javascript
true  // 操作成功返回 true

基本使用 ​

输入单个字符 ​

javascript
// 输入字母 A
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'A'
});

输入多个字符 ​

javascript
// 输入 "HELLO"
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'HELLO'
});

// 等效于依次输入 H, E, L, L, O

组合键使用 ​

配合修饰键 ​

javascript
// COMMAND + C(复制)
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'C',
    fnkey: 'COMMAND'
});

// COMMAND + V(粘贴)
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'V',
    fnkey: 'COMMAND'
});

// COMMAND + A(全选)
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'A',
    fnkey: 'COMMAND'
});

商务合作:try.catch@foxmail.com