Skip to content

发送按键

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

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

接口说明

接口类型

sendKey

参数

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

返回值

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