ms-vite-plugin 1.1.2 → 1.1.3

package/docs/apicn/hid.md

@@ -0,0 +1,1033 @@
+# HID 模块
+
+HID 模块提供全面的输入控制功能，包括点击、滑动、长按滑动、主屏幕导航等操作，通过蓝牙 HID 设备实现。
+
+## 常量
+
+### $HID 按键 - HID 按键常量
+
+预定义的键盘操作按键常量。
+
+```typescript
+declare const $HID按键: {
+  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;
+};
+```
+
+## 获取和设置设备信息
+
+### 是否连接蓝牙模块
+
+判断是否连接了蓝牙HID设备
+
+```typescript
+function 是否连接蓝牙模块(): 布尔值;
+```
+
+**示例:**
+
+```javascript
+// 检查是否连接了蓝牙HID设备
+const 是否连接蓝牙模块 = $HID.是否连接蓝牙模块();
+$打印信息日志(是否连接蓝牙模块); // 输出: true 或 false
+```
+
+### 是否连接USB模块
+
+判断是否连接了USB HID设备
+
+```typescript
+function 是否连接USB模块(): 布尔值;
+```
+
+**示例:**
+
+```javascript
+// 检查是否连接了USB HID设备
+const 是否连接USB模块 = $HID.是否连接USB模块();
+$打印信息日志(是否连接USB模块); // 输出: true 或 false
+```
+
+### 获取蓝牙HID设备名称
+
+获取当前连接的蓝牙 HID 设备名称。
+
+```typescript
+function 获取蓝牙HID设备名称(): 字符串;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 字符串 | 蓝牙 HID 设备名称 |
+
+**示例:**
+
+```javascript
+const 设备名称 = $HID.获取蓝牙HID设备名称();
+$打印信息日志(设备名称);
+```
+
+### 设置蓝牙HID设备名称
+
+设置当前蓝牙 HID 设备名称。
+
+```typescript
+function 设置蓝牙HID设备名称(name: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `name` | 字符串 | 是 | - | 要设置的蓝牙 HID 设备名称 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+const 是否成功 = $HID.设置蓝牙HID设备名称("KuaiJS-HID");
+$打印信息日志(是否成功);
+```
+
+### 获取设备Mac
+
+获取设备返回的 MAC 字符串。
+
+```typescript
+function 获取设备Mac(): 字符串;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 字符串 | 设备 MAC 字符串 |
+
+**示例:**
+
+```javascript
+const mac = $HID.获取设备Mac();
+$打印信息日志(mac);
+```
+
+### 复位坐标
+
+将鼠标坐标复位到左上角（仅相对鼠标模式需要）。
+
+```typescript
+function 复位坐标(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 复位坐标到左上角
+const 是否成功 = $HID.复位坐标();
+$打印信息日志(是否成功); // 输出: true 或 false
+```
+
+## 录屏
+
+### 打开录屏界面
+
+打开录屏界面，用户可以在界面上操作开始、结束录屏。
+
+```typescript
+function 打开录屏界面(): 无返回值;
+```
+
+**示例:**
+
+```javascript
+// 打开录屏界面
+$HID.打开录屏界面();
+```
+
+### 录屏是否开启
+
+获取录屏开启状态
+
+```typescript
+function 录屏是否开启(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 是否正在录屏 |
+
+**示例:**
+
+```javascript
+// 检查是否正在录屏
+const 录屏是否开启 = $HID.录屏是否开启();
+logi(录屏是否开启); // 输出: true 或 false
+```
+
+## 配置
+
+### 设置抖动值
+
+设置动作的抖动值。带有抖动参数的动作将在像素范围内随机偏移。
+
+```typescript
+function 设置抖动值(抖动值: 数字): 无返回值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `抖动值` | 数字 | 是 | - | 随机像素偏移的抖动值 |
+
+**示例:**
+
+```javascript
+// 设置抖动值为5像素
+$HID.设置抖动值(5);
+```
+
+### 移动
+
+将光标移动到指定坐标。
+
+```typescript
+function 移动(x: 数字, y: 数字): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | 数字 | 是 | - | 目标 X 坐标 |
+| `y` | 数字 | 是 | - | 目标 Y 坐标 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 移动到 (100, 200)
+$HID.移动(100, 200);
+```
+
+## 基础触摸操作
+
+### 点击
+
+在指定坐标执行点击操作。
+
+```typescript
+function 点击(
+  坐标x: 数字,
+  坐标y: 数字,
+  按下持续时间?: 数字,
+  抖动?: 布尔值,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `坐标x` | 数字 | 是 | - | 点击坐标的 X 轴 |
+| `坐标y` | 数字 | 是 | - | 点击坐标的 Y 轴 |
+| `按下持续时间` | 数字 | 否 | 10 | 点击持续时间（毫秒） |
+| `抖动` | 布尔值 | 否 | false | 是否添加随机抖动 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 简单点击
+$HID.点击(100, 200);
+
+// 带持续时间和抖动的点击
+$HID.点击(100, 200, 150, true);
+```
+
+### 点击随机范围
+
+在指定矩形区域内执行随机点击。
+
+```typescript
+function 点击随机范围(
+  区域左上角x坐标: 数字,
+  区域左上角y坐标: 数字,
+  区域右下角x坐标: 数字,
+  区域右下角y坐标: 数字,
+  按下持续时间?: 数字,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `区域左上角x坐标` | 数字 | 是 | - | 左上角 X 坐标 |
+| `区域左上角y坐标` | 数字 | 是 | - | 左上角 Y 坐标 |
+| `区域右下角x坐标` | 数字 | 是 | - | 右下角 X 坐标 |
+| `区域右下角y坐标` | 数字 | 是 | - | 右下角 Y 坐标 |
+| `按下持续时间` | 数字 | 否 | 20 | 点击持续时间（毫秒） |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 随机点击是否成功 |
+
+**示例:**
+
+```javascript
+// 在区域内随机点击
+$HID.点击随机范围(100, 100, 200, 200, 20);
+```
+
+### 双击
+
+在指定坐标执行双击操作。
+
+```typescript
+function 双击(
+  坐标x: 数字,
+  坐标y: 数字,
+  按下持续时间?: 数字,
+  间隔时间?: 数字,
+  抖动?: 布尔值,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `坐标x` | 数字 | 是 | - | X 坐标 |
+| `坐标y` | 数字 | 是 | - | Y 坐标 |
+| `按下持续时间` | 数字 | 否 | 20 | 点击持续时间（毫秒） |
+| `间隔时间` | 数字 | 否 | 20 | 两次点击间隔时间（毫秒） |
+| `抖动` | 布尔值 | 否 | false | 开启抖动，会在像素范围随机偏移点击 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 双击是否成功 |
+
+**示例:**
+
+```javascript
+// 带抖动的双击
+$HID.双击(100, 100, 20, 20, true);
+```
+
+### 双击随机范围
+
+在指定矩形区域内执行随机双击。
+
+```typescript
+function 双击随机范围(
+  区域左上角x坐标: 数字,
+  区域左上角y坐标: 数字,
+  区域右下角x坐标: 数字,
+  区域右下角y坐标: 数字,
+  按下持续时间?: 数字,
+  间隔时间?: 数字,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `区域左上角x坐标` | 数字 | 是 | - | 左上角 X 坐标 |
+| `区域左上角y坐标` | 数字 | 是 | - | 左上角 Y 坐标 |
+| `区域右下角x坐标` | 数字 | 是 | - | 右下角 X 坐标 |
+| `区域右下角y坐标` | 数字 | 是 | - | 右下角 Y 坐标 |
+| `按下持续时间` | 数字 | 否 | 20 | 点击持续时间（毫秒） |
+| `间隔时间` | 数字 | 否 | 20 | 两次点击间隔时间（毫秒） |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 随机双击是否成功 |
+
+**示例:**
+
+```javascript
+// 在区域内随机双击
+$HID.双击随机范围(100, 100, 200, 200, 20, 20);
+```
+
+## 滑动操作
+
+### 滑动
+
+执行从起始坐标到结束坐标的线性滑动。
+
+```typescript
+function 滑动(
+  起始x坐标: 数字,
+  起始y坐标: 数字,
+  目标x坐标: 数字,
+  目标y坐标: 数字,
+  抖动?: 布尔值,
+  步数?: 数字,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `起始x坐标` | 数字 | 是 | - | 滑动起始坐标的 X 轴 |
+| `起始y坐标` | 数字 | 是 | - | 滑动起始坐标的 Y 轴 |
+| `目标x坐标` | 数字 | 是 | - | 滑动目标坐标的 X 轴 |
+| `目标y坐标` | 数字 | 是 | - | 滑动目标坐标的 Y 轴 |
+| `抖动` | 布尔值 | 否 | false | 是否添加随机抖动 |
+| `步数` | 数字 | 否 | 6 | 滑动步骤数 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 简单滑动
+$HID.滑动(100, 100, 200, 200);
+
+// 带抖动和自定义步数的滑动
+$HID.滑动(100, 100, 200, 200, true, 10);
+```
+
+### 长按并滑动
+
+长按起始坐标，然后滑动到目标坐标。
+
+```typescript
+function 长按并滑动(
+  起始x坐标: 数字,
+  起始y坐标: 数字,
+  目标x坐标: 数字,
+  目标y坐标: 数字,
+  长按持续时间?: 数字,
+  抖动?: 布尔值,
+  步数?: 数字,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `起始x坐标` | 数字 | 是 | - | 滑动起始坐标的 X 轴 |
+| `起始y坐标` | 数字 | 是 | - | 滑动起始坐标的 Y 轴 |
+| `目标x坐标` | 数字 | 是 | - | 滑动目标坐标的 X 轴 |
+| `目标y坐标` | 数字 | 是 | - | 滑动目标坐标的 Y 轴 |
+| `长按持续时间` | 数字 | 否 | 500 | 长按持续时间（毫秒） |
+| `抖动` | 布尔值 | 否 | false | 是否添加随机抖动 |
+| `步数` | 数字 | 否 | 6 | 滑动步骤数 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 长按 1 秒后滑动
+$HID.长按并滑动(100, 100, 200, 200, 1000);
+
+// 长按 1 秒后带抖动和自定义步数的滑动
+$HID.长按并滑动(100, 100, 200, 200, 1000, true, 10);
+```
+
+### 曲线滑动
+
+执行 3 点曲线滑动（先快后慢），通过起始点、中间点和结束点。
+
+```typescript
+function 曲线滑动(
+  起始x坐标: 数字,
+  起始y坐标: 数字,
+  中间点x坐标: 数字,
+  中间点y坐标: 数字,
+  目标x坐标: 数字,
+  目标y坐标: 数字,
+): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `起始x坐标` | 数字 | 是 | - | 滑动起始坐标的 X 轴 |
+| `起始y坐标` | 数字 | 是 | - | 滑动起始坐标的 Y 轴 |
+| `中间点x坐标` | 数字 | 是 | - | 滑动中间点坐标的 X 轴 |
+| `中间点y坐标` | 数字 | 是 | - | 滑动中间点坐标的 Y 轴 |
+| `目标x坐标` | 数字 | 是 | - | 滑动目标坐标的 X 轴 |
+| `目标y坐标` | 数字 | 是 | - | 滑动目标坐标的 Y 轴 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 通过三个点的曲线滑动
+$HID.曲线滑动(100, 100, 150, 50, 200, 100);
+```
+
+## 系统导航
+
+### 回到主页
+
+返回到设备主屏幕。
+
+```typescript
+function 回到主页(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 回到主屏幕
+$HID.回到主页();
+```
+
+## 文本输入
+
+### 输入文本
+
+输入文本。
+
+```typescript
+function 输入文本(文本: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `文本` | 字符串 | 是 | - | 要输入的文本 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 输入文本
+$HID.输入文本("Hello World");
+
+// 输入中文
+$HID.输入文本("测试");
+```
+
+### 输入简易文本
+
+输入基础文本（不支持中文），等价于键盘逐字输出。
+
+```typescript
+function 输入简易文本(文本: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `文本` | 字符串 | 是 | - | 要输入的基础文本（建议 ASCII） |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 输入英文与数字
+$HID.输入简易文本("hello_123");
+```
+
+## 基础按键操作
+
+### 空格键
+
+发送空格键按下。
+
+```typescript
+function 空格键(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.空格键();
+```
+
+### 删除键
+
+发送删除键（Backspace）按下。
+
+```typescript
+function 删除键(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.删除键();
+```
+
+### 回车键
+
+发送回车键（Return）按下。
+
+```typescript
+function 回车键(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.回车键();
+```
+
+### 按键 - 按下系统按钮
+
+```typescript
+function 按键(按键: "home" | "volumeup" | "volumedown" | "eject"): 布尔值;
+```
+
+**参数说明：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
+| ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
+| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
+
+**返回值：**
+
+| 类型     | 描述             |
+| -------- | ---------------- |
+| `布尔值` | 按下按钮是否成功 |
+
+**示例：**
+
+```typescript
+// 按下 Home 键
+$HID.按键("home");
+
+// 调高音量
+$HID.按键("volumeup");
+
+// 调低音量
+$HID.按键("volumedown");
+
+// 连续调节音量
+for (let i = 0; i < 5; i++) {
+  const 是否成功 = $HID.按键("volumeup");
+  if (是否成功) {
+    $打印信息日志("成功调高音量");
+  }
+  $延时(200);
+}
+```
+
+## 组合键
+
+### 发送组合按键
+
+发送组合按键。
+
+```typescript
+function 发送组合按键(按键数组: 数组<数字 | 字符串>): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `按键数组` | 数组<数字 \| 字符串> | 是 | - | 按键数组 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 发送Cmd+C
+$HID.发送组合按键([$HID按键.COMMAND, "c"]);
+
+// 发送Ctrl+Alt+Delete
+$HID.发送组合按键([$HID按键.LEFT_CTRL, $HID按键.LEFT_ALT, $HID按键.DELETE]);
+```
+
+### 复制
+
+发送 Command+C 复制键。
+
+```typescript
+function 复制(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.复制();
+```
+
+### 粘贴
+
+发送 Command+V 粘贴键。
+
+```typescript
+function 粘贴(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.粘贴();
+```
+
+## 导航快捷键
+
+### 返回
+
+发送 Tab+B 进行返回导航。
+
+```typescript
+function 返回(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.返回();
+```
+
+### 最近应用
+
+显示 APP 切换器
+
+```typescript
+function 最近应用(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.最近应用();
+```
+
+### 锁屏
+
+发送锁定屏幕指令。
+
+```typescript
+function 锁屏(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.锁屏();
+```
+
+### 解锁
+
+发送两次 Home 键解锁屏幕。
+
+```typescript
+function 解锁(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.解锁();
+```
+
+## 应用控制
+
+### 打开 URL
+
+打开 URL。
+
+```typescript
+function 打开URL(url: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `url` | 字符串 | 是 | - | URL 字符串 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 打开网站
+$HID.打开URL("https://www.example.com");
+
+// 使用自定义scheme打开应用
+$HID.打开URL("myapp://action");
+```
+
+### 关闭 App
+
+按名称关闭应用程序。
+
+```typescript
+function 关闭App(name: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `name` | 字符串 | 是 | - | 应用名称 或者 包名 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 关闭Safari
+$HID.关闭App("Safari");
+
+// 关闭设置
+$HID.关闭App("Settings");
+
+// 按 bundleId 关闭应用
+$HID.关闭App("com.example.myapp");
+```
+
+### 打开 App
+
+按名称打开应用程序。
+
+```typescript
+function 打开App(name: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `name` | 字符串 | 是 | - | 应用名称 或者 包名 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 打开Safari
+$HID.打开App("Safari");
+
+// 打开设置
+$HID.打开App("Settings");
+
+// 按 bundleId 打开应用
+$HID.打开App("com.example.myapp");
+```
+
+### APP 切入前台
+
+将当前应用切换到前台。
+
+```typescript
+function APP切入前台(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+$HID.APP切入前台();
+```
+
+### 当前打开应用信息
+
+获取当前打开应用的信息（仅 iOS 18.2+）。
+
+```typescript
+function 当前打开应用信息(): {
+  name: 字符串;
+  bundleId: 字符串;
+} | null;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 对象 \| null | 当前打开应用信息或 null（如果不可用） |
+
+**返回对象属性:**
+| 属性 | 类型 | 描述 |
+| ---- | ---- | ---- |
+| `name` | 字符串 | 应用名称 |
+| `bundleId` | 字符串 | 应用 Bundle ID |
+
+**示例:**
+
+```javascript
+const appInfo = $HID.当前打开应用信息();
+if (appInfo) {
+  $打印信息日志(`当前应用: ${appInfo.name} (${appInfo.bundleId})`);
+}
+```
+
+## 剪贴板操作
+
+### 设置剪切板内容
+
+设置剪切板内容。
+
+```typescript
+function 设置剪切板内容(text: 字符串): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `text` | 字符串 | 是 | - | 要设置的文本 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 设置结果 |
+
+**示例:**
+
+```javascript
+$HID.设置剪切板内容("你好，世界！");
+```
+
+### 获取剪切板内容
+
+获取当前剪切板内容。
+
+```typescript
+function 获取剪切板内容(): 字符串 | null;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 字符串 \| null | 剪切板内容 |
+
+**示例:**
+
+```javascript
+const clipboardText = $HID.获取剪切板内容();
+if (clipboardText) {
+  $打印信息日志("剪切板内容:", clipboardText);
+}
+```