发送按键
发送完整的按键事件,自动处理按下和释放,支持单键、多键和组合键。
⚠️ 提示:
sendKey仅能输入键盘字符(英文字母、数字和常见符号),不支持其它语言或任意文本。如果需要发送任意文字到设备,请参考 发送文本。
接口说明
接口类型
sendKey参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
deviceId | string | ✅ | 设备 ID |
key | string | ✅ | 按键(支持+拼接) |
fnkey | string | ❌ | 功能键/修饰键(如 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'
});