ms-vite-plugin 1.4.49 → 1.4.51

package/docs/apilua/hid.md

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