ms-vite-plugin 1.1.1 → 1.1.3

package/docs/api/hid.md

@@ -0,0 +1,1032 @@
+# HID 模块
+
+HID 模块提供全面的输入控制功能，包括点击、滑动、长按滑动、主屏幕导航等操作，通过蓝牙 HID 设备实现。
+
+## 常量
+
+### hidKey - HID 按键常量
+
+预定义的键盘操作按键常量。
+
+```typescript
+declare const hidKey: {
+  COMMAND: number;
+  LEFT_CTRL: number;
+  LEFT_SHIFT: number;
+  LEFT_ALT: number;
+  RIGHT_CTRL: number;
+  RIGHT_SHIFT: number;
+  RIGHT_ALT: number;
+  UP_ARROW: number;
+  DOWN_ARROW: number;
+  LEFT_ARROW: number;
+  RIGHT_ARROW: number;
+  SPACE: number;
+  BACKSPACE: number;
+  TAB: number;
+  RETURN: number;
+  ESC: number;
+  INSERT: number;
+  DELETE: number;
+  PAGE_UP: number;
+  PAGE_DOWN: number;
+  HOME: number;
+  END: number;
+  CAPS_LOCK: number;
+  F1: number;
+  F2: number;
+  F3: number;
+  F4: number;
+  F5: number;
+  F6: number;
+  F7: number;
+  F8: number;
+  F9: number;
+  F10: number;
+  F11: number;
+  F12: number;
+};
+```
+
+## 获取和设置设备信息
+
+### isBLEConnected - 是否连接了蓝牙HID设备
+
+判断是否连接了蓝牙HID设备
+
+```typescript
+function isBLEConnected(): boolean;
+```
+
+**示例:**
+
+```javascript
+// 检查是否连接了蓝牙HID设备
+const isBLEConnected = hid.isBLEConnected();
+logi(isBLEConnected); // 输出: true 或 false
+```
+
+### isUSBConnected - 是否连接了USB HID设备
+
+判断是否连接了USB HID设备
+
+```typescript
+function isUSBConnected(): boolean;
+```
+
+**示例:**
+
+```javascript
+// 检查是否连接了USB HID设备
+const isUSBConnected = hid.isUSBConnected();
+logi(isUSBConnected); // 输出: true 或 false
+```
+
+### getBLEHIDDeviceName - 获取蓝牙 HID 设备名称
+
+获取当前连接的蓝牙 HID 设备名称。
+
+```typescript
+function getBLEHIDDeviceName(): string;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| string | 蓝牙 HID 设备名称 |
+
+**示例:**
+
+```javascript
+const deviceName = hid.getBLEHIDDeviceName();
+logi(deviceName);
+```
+
+### setBLEHIDDeviceName - 设置蓝牙 HID 设备名称
+
+设置当前蓝牙 HID 设备名称。
+
+```typescript
+function setBLEHIDDeviceName(name: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `name` | string | 是 | - | 要设置的蓝牙 HID 设备名称 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+const ok = hid.setBLEHIDDeviceName("KuaiJS-HID");
+logi(ok);
+```
+
+### getDeviceMac - 获取设备 MAC 字符串
+
+获取设备返回的 MAC 字符串。
+
+```typescript
+function getDeviceMac(): string;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| string | 设备 MAC 字符串 |
+
+**示例:**
+
+```javascript
+const mac = hid.getDeviceMac();
+logi(mac);
+```
+
+### resetPosition - 复位坐标
+
+将鼠标坐标复位到左上角（仅相对鼠标模式需要）。
+
+```typescript
+function resetPosition(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 复位坐标到左上角
+const ok = hid.resetPosition();
+logi(ok); // 输出: true 或 false
+```
+
+## 录屏
+
+### openRecordScreen - 打开录屏界面
+
+打开录屏界面，用户可以在界面上操作开始、结束录屏。
+
+```typescript
+function openRecordScreen(): void;
+```
+
+**示例:**
+
+```javascript
+// 打开录屏界面
+hid.openRecordScreen();
+```
+
+### isRecording - 是否录屏中
+
+获取录屏开启状态
+
+```typescript
+function isRecording(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 是否正在录屏 |
+
+**示例:**
+
+```javascript
+// 检查是否正在录屏
+const isRecording = hid.isRecording();
+logi(isRecording); // 输出: true 或 false
+```
+
+## 配置
+
+### setJitterValue - 设置抖动值
+
+设置动作的抖动值。带有抖动参数的动作将在像素范围`-value`到`value`内随机偏移。
+
+```typescript
+function setJitterValue(value: number): void;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `value` | number | 是 | - | 随机像素偏移的抖动值 |
+
+**示例:**
+
+```javascript
+// 设置抖动值为5像素
+hid.setJitterValue(5);
+```
+
+### move - 移动坐标
+
+将光标移动到指定坐标。
+
+```typescript
+function move(x: number, y: number): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | number | 是 | - | 目标 X 坐标 |
+| `y` | number | 是 | - | 目标 Y 坐标 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 移动到 (100, 200)
+hid.move(100, 200);
+```
+
+## 基础触摸操作
+
+### click - 点击操作
+
+在指定坐标执行点击操作。
+
+```typescript
+function click(
+  x: number,
+  y: number,
+  duration?: number,
+  jitter?: boolean,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | number | 是 | - | 点击的 X 坐标 |
+| `y` | number | 是 | - | 点击的 Y 坐标 |
+| `duration` | number | 否 | 10 | 点击持续时间（毫秒） |
+| `jitter` | boolean | 否 | false | 启用随机抖动偏移 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 简单点击
+hid.click(100, 200);
+
+// 带持续时间和抖动的点击
+hid.click(100, 200, 150, true);
+```
+
+### clickRandom - 随机点击
+
+在指定矩形区域内执行随机点击。
+
+```typescript
+function clickRandom(
+  x1: number,
+  y1: number,
+  x2: number,
+  y2: number,
+  duration?: number,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x1` | number | 是 | - | 左上角 X 坐标 |
+| `y1` | number | 是 | - | 左上角 Y 坐标 |
+| `x2` | number | 是 | - | 右下角 X 坐标 |
+| `y2` | number | 是 | - | 右下角 Y 坐标 |
+| `duration` | number | 否 | 20 | 点击持续时间（毫秒） |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 在区域内随机点击
+hid.clickRandom(100, 100, 200, 200, 20);
+```
+
+### doubleClick - 双击
+
+在指定坐标执行双击操作。
+
+```typescript
+function doubleClick(
+  x: number,
+  y: number,
+  duration?: number,
+  interval?: number,
+  jitter?: boolean,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | number | 是 | - | X 坐标 |
+| `y` | number | 是 | - | Y 坐标 |
+| `duration` | number | 否 | 20 | 点击持续时间（毫秒） |
+| `interval` | number | 否 | 20 | 两次点击间隔时间（毫秒） |
+| `jitter` | boolean | 否 | false | 启用随机抖动偏移 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 带抖动的双击
+hid.doubleClick(100, 100, 20, 20, true);
+```
+
+### doubleClickRandom - 随机双击
+
+在指定矩形区域内执行随机双击。
+
+```typescript
+function doubleClickRandom(
+  x1: number,
+  y1: number,
+  x2: number,
+  y2: number,
+  duration?: number,
+  interval?: number,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x1` | number | 是 | - | 左上角 X 坐标 |
+| `y1` | number | 是 | - | 左上角 Y 坐标 |
+| `x2` | number | 是 | - | 右下角 X 坐标 |
+| `y2` | number | 是 | - | 右下角 Y 坐标 |
+| `duration` | number | 否 | 20 | 点击持续时间（毫秒） |
+| `interval` | number | 否 | 20 | 两次点击间隔时间（毫秒） |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 在区域内随机双击
+hid.doubleClickRandom(100, 100, 200, 200, 20, 20);
+```
+
+## 滑动操作
+
+### swipe - 线性滑动
+
+执行从起始坐标到结束坐标的线性滑动。
+
+```typescript
+function swipe(
+  x: number,
+  y: number,
+  ex: number,
+  ey: number,
+  jitter?: boolean,
+  steps?: number,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | number | 是 | - | 起始 X 坐标 |
+| `y` | number | 是 | - | 起始 Y 坐标 |
+| `ex` | number | 是 | - | 结束 X 坐标 |
+| `ey` | number | 是 | - | 结束 Y 坐标 |
+| `jitter` | boolean | 否 | false | 启用随机抖动偏移 |
+| `steps` | number | 否 | 6 | 滑动步数 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 简单滑动
+hid.swipe(100, 100, 200, 200);
+
+// 带抖动和自定义步数的滑动
+hid.swipe(100, 100, 200, 200, true, 10);
+```
+
+### pressAndSwipe - 长按并滑动
+
+长按起始坐标，然后滑动到目标坐标。
+
+```typescript
+function swipe(
+  x: number,
+  y: number,
+  ex: number,
+  ey: number,
+  duration?: number,
+  jitter?: boolean,
+  steps?: number,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | number | 是 | - | 起始 X 坐标 |
+| `y` | number | 是 | - | 起始 Y 坐标 |
+| `ex` | number | 是 | - | 结束 X 坐标 |
+| `ey` | number | 是 | - | 结束 Y 坐标 |
+| `duration` | number | 否 | 500 | 长按持续时间（毫秒） |
+| `jitter` | boolean | 否 | false | 启用随机抖动偏移 |
+| `steps` | number | 否 | 6 | 滑动步数 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 长按 1 秒后滑动
+hid.pressAndSwipe(100, 100, 200, 200, 1000);
+
+// 长按 1 秒后带抖动和自定义步数的滑动
+hid.pressAndSwipe(100, 100, 200, 200, 1000, true, 10);
+```
+
+### swipeCurve - 曲线滑动
+
+执行 3 点曲线滑动（先快后慢），通过起始点、中间点和结束点。
+
+```typescript
+function swipeCurve(
+  startX: number,
+  startY: number,
+  midX: number,
+  midY: number,
+  endX: number,
+  endY: number,
+): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `startX` | number | 是 | - | 起始 X 坐标 |
+| `startY` | number | 是 | - | 起始 Y 坐标 |
+| `midX` | number | 是 | - | 中间点 X 坐标 |
+| `midY` | number | 是 | - | 中间点 Y 坐标 |
+| `endX` | number | 是 | - | 结束 X 坐标 |
+| `endY` | number | 是 | - | 结束 Y 坐标 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 通过三个点的曲线滑动
+hid.swipeCurve(100, 100, 150, 50, 200, 100);
+```
+
+## 系统导航
+
+### homeScreen - 返回主屏幕
+
+返回到设备主屏幕。
+
+```typescript
+function homeScreen(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 回到主屏幕
+hid.homeScreen();
+```
+
+## 文本输入
+
+### input - 文本输入
+
+输入文本。
+
+```typescript
+function input(text: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `text` | string | 是 | - | 要输入的文本 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 输入文本
+hid.input("Hello World");
+
+// 输入中文
+hid.input("测试");
+```
+
+### inputSimple - 基础文本输入
+
+输入基础文本（不支持中文），等价于键盘逐字输出。
+
+```typescript
+function inputSimple(text: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `text` | string | 是 | - | 要输入的基础文本（建议 ASCII） |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 输入英文与数字
+hid.inputSimple("hello_123");
+```
+
+## 基础按键操作
+
+### space - 空格键
+
+发送空格键按下。
+
+```typescript
+function space(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.space();
+```
+
+### backspace - 退格键
+
+发送退格键按下。
+
+```typescript
+function backspace(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.backspace();
+```
+
+### enter - 回车键
+
+发送回车/换行键按下。
+
+```typescript
+function enter(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.enter();
+```
+
+### pressButton - 按下系统按钮
+
+```typescript
+function pressButton(
+  button: "home" | "volumeup" | "volumedown" | "eject",
+): boolean;
+```
+
+**参数说明：**
+
+| 参数名   | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
+| -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
+| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
+
+**返回值：**
+
+| 类型      | 描述             |
+| --------- | ---------------- |
+| `boolean` | 按下按钮是否成功 |
+
+**示例：**
+
+```typescript
+// 按下 Home 键
+hid.pressButton("home");
+
+// 调高音量
+hid.pressButton("volumeup");
+
+// 调低音量
+hid.pressButton("volumedown");
+
+// 连续调节音量
+for (let i = 0; i < 5; i++) {
+  hid.pressButton("volumeup");
+  sleep(200);
+}
+```
+
+## 组合键
+
+### sendKey - 发送组合键
+
+发送组合键。
+
+```typescript
+function sendKey(key: Array<number | string>): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `key` | Array<number \| string> | 是 | - | 要发送的按键数组 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 发送Cmd+C
+hid.sendKey([hidKey.COMMAND, "c"]);
+
+// 发送Ctrl+Alt+Delete
+hid.sendKey([hidKey.LEFT_CTRL, hidKey.LEFT_ALT, hidKey.DELETE]);
+```
+
+### copyText - 复制文本
+
+发送 Command+C 复制文本。
+
+```typescript
+function copyText(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.copyText();
+```
+
+### pasteText - 粘贴文本
+
+发送 Command+V 粘贴文本。
+
+```typescript
+function pasteText(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.pasteText();
+```
+
+## 导航快捷键
+
+### back - 返回
+
+发送 Tab+B 进行返回导航。
+
+```typescript
+function back(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.back();
+```
+
+### recent - 最近应用
+
+显示 APP 切换器
+
+```typescript
+function recent(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.recent();
+```
+
+### lock - 锁屏
+
+发送锁定屏幕指令。
+
+```typescript
+function lock(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.lock();
+```
+
+### unlock - 解锁
+
+发送两次 Home 键解锁屏幕。
+
+```typescript
+function unlock(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.unlock();
+```
+
+## 应用控制
+
+### openURL - 打开 URL
+
+在默认浏览器或相应应用中打开 URL。
+
+```typescript
+function openURL(url: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `url` | string | 是 | - | 要打开的 URL |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 打开网站
+hid.openURL("https://www.example.com");
+
+// 使用自定义scheme打开应用
+hid.openURL("myapp://action");
+```
+
+### openApp - 打开应用
+
+按名称打开应用程序。
+
+```typescript
+function openApp(name: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `name` | string | 是 | - | 应用程序名称 或者 包名 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 打开Safari
+hid.openApp("Safari");
+
+// 打开设置
+hid.openApp("Settings");
+
+// 按 bundleId 打开应用
+hid.openApp("com.example.myapp");
+```
+
+### closeApp - 关闭应用
+
+按名称关闭应用程序。
+
+```typescript
+function closeApp(name: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `name` | string | 是 | - | 应用程序名称 或者 包名 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 关闭Safari
+hid.closeApp("Safari");
+
+// 关闭设置
+hid.closeApp("Settings");
+
+// 按 bundleId 关闭应用
+hid.closeApp("com.example.myapp");
+```
+
+### takeMeToFront - 置于前台
+
+将当前应用置于前台。
+
+```typescript
+function takeMeToFront(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.takeMeToFront();
+```
+
+### currentAppInfo - 获取当前应用信息
+
+获取当前打开应用的信息（仅 iOS 18.2+）。
+
+```typescript
+function currentAppInfo(): {
+  name: string;
+  bundleId: string;
+} | null;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| object \| null | 当前应用信息或 null（如果不可用） |
+
+**返回对象属性:**
+| 属性 | 类型 | 描述 |
+| ---- | ---- | ---- |
+| `name` | string | 应用程序名称 |
+| `bundleId` | string | 应用程序包 ID |
+
+**示例:**
+
+```javascript
+const appInfo = hid.currentAppInfo();
+if (appInfo) {
+  logi(`当前应用: ${appInfo.name} (${appInfo.bundleId})`);
+}
+```
+
+## 剪贴板操作
+
+### setClipboard - 设置剪贴板内容
+
+设置剪贴板内容。
+
+```typescript
+function setClipboard(text: string): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `text` | string | 是 | - | 要设置到剪贴板的文本 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+hid.setClipboard("你好，世界！");
+```
+
+### getClipboard - 获取剪贴板内容
+
+获取当前剪贴板内容。
+
+```typescript
+function getClipboard(): string;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| string | 剪贴板内容或 `""`（如果不可用） |
+
+**示例:**
+
+```javascript
+const clipboardText = hid.getClipboard();
+if (clipboardText) {
+  logi("剪贴板内容:", clipboardText);
+}
+```