ms-types 0.4.27 → 0.4.28

package/types/zh/HID/346/250/241/345/235/227.d.ts

@@ -1,349 +1,361 @@
-/// <reference path="全局模块.d.ts" />
-
-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模块 包含点击、滑动、长按滑动、返回首页等动作
- */
-declare namespace $HID {
-  /**
-   * 打开录屏界面
-   */
-  function 打开录屏界面(): 无返回值;
-
-  /**
-   * 检查录屏是否开启
-   * @returns 是否开启
-   */
-  function 录屏是否开启(): 布尔值;
-
-  /**
-   * 设置动作抖动值
-   * @param 抖动值
-   */
-  function 设置抖动值(抖动值: 数字): 无返回值;
-
-  /**
-   * 重置坐标
-   * @param 屏幕方向 可选值为"PORTRAIT"和"LANDSCAPE"
-   */
-  function 重置坐标(屏幕方向?: "PORTRAIT" | "LANDSCAPE"): 无返回值;
-
-  /**
-   * 移动指定坐标
-   * @param 坐标x 移动坐标的X轴
-   * @param 坐标y 移动坐标的Y轴
-   * @returns 操作是否成功
-   */
-  function 移动(坐标x: 数字, 坐标y: 数字): 布尔值;
-
-  /**
-   * 点击指定坐标
-   * @param 坐标x 点击坐标的X轴
-   * @param 坐标y 点击坐标的Y轴
-   * @param 按下持续时间 点击持续时间（可选，默认值为10毫秒）
-   * @param 抖动 是否添加随机抖动（可选，默认值为false）
-   * @returns 操作是否成功
-   */
-  function 点击(
-    坐标x: 数字,
-    坐标y: 数字,
-    按下持续时间?: 数字,
-    抖动?: 布尔值,
-  ): 布尔值;
-
-  /**
-   * 随机点击
-   * @param 区域左上角x坐标
-   * @param 区域左上角y坐标
-   * @param 区域右下角x坐标
-   * @param 区域右下角y坐标
-   * @param 按下持续时间 默认20ms
-   * @returns 随机点击是否成功
-   * @example $动作.点击随机范围(100, 100, 200, 200, 20)
-   */
-  function 点击随机范围(
-    区域左上角x坐标: 数字,
-    区域左上角y坐标: 数字,
-    区域右下角x坐标: 数字,
-    区域右下角y坐标: 数字,
-    按下持续时间?: 数字,
-  ): 布尔值;
-
-  /**
-   * 双击
-   * @param 坐标x
-   * @param 坐标y
-   * @param 按下持续时间 默认20ms
-   * @param 间隔时间 默认20ms
-   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
-   * @returns 双击是否成功
-   * @example $动作.双击(100, 100, 20, 20, true)
-   */
-  function 双击(
-    坐标x: 数字,
-    坐标y: 数字,
-    按下持续时间?: 数字,
-    间隔时间?: 数字,
-    抖动?: 布尔值,
-  ): 布尔值;
-  /**
-   * 随机双击
-   * @param 区域左上角x坐标
-   * @param 区域左上角y坐标
-   * @param 区域右下角x坐标
-   * @param 区域右下角y坐标
-   * @param 按下持续时间 默认20ms
-   * @param 间隔时间 默认20ms
-   * @returns 随机双击是否成功
-   * @example $动作.双击随机范围(100, 100, 200, 200, 20, 20)
-   */
-  function 双击随机范围(
-    区域左上角x坐标: 数字,
-    区域左上角y坐标: 数字,
-    区域右下角x坐标: 数字,
-    区域右下角y坐标: 数字,
-    按下持续时间?: 数字,
-    间隔时间?: 数字,
-  ): 布尔值;
-
-  /**
-   * 滑动指定坐标
-   * @param 起始x坐标 滑动起始坐标的X轴
-   * @param 起始y坐标 滑动起始坐标的Y轴
-   * @param 目标x坐标 滑动目标坐标的X轴
-   * @param 目标y坐标 滑动目标坐标的Y轴
-   * @param 抖动 是否添加随机抖动（可选，默认值为false）
-   * @param 步数 滑动步骤数（可选，默认值为6）
-   * @returns 操作是否成功
-   */
-  function 滑动(
-    起始x坐标: 数字,
-    起始y坐标: 数字,
-    目标x坐标: 数字,
-    目标y坐标: 数字,
-    抖动?: 布尔值,
-    步数?: 数字,
-  ): 布尔值;
-
-  /**
-   * 长按并滑动
-   * @param 起始x坐标 滑动起始坐标的X轴
-   * @param 起始y坐标 滑动起始坐标的Y轴
-   * @param 目标x坐标 滑动目标坐标的X轴
-   * @param 目标y坐标 滑动目标坐标的Y轴
-   * @param 长按持续时间 默认500ms
-   * @param 抖动 是否添加随机抖动（可选，默认值为false）
-   * @param 步数 滑动步骤数（可选，默认值为6）
-   * @returns 操作是否成功
-   */
-  function 长按并滑动(
-    起始x坐标: 数字,
-    起始y坐标: 数字,
-    目标x坐标: 数字,
-    目标y坐标: 数字,
-    长按持续时间?: 数字,
-    抖动?: 布尔值,
-    步数?: 数字,
-  ): 布尔值;
-
-  /**
-   * 3点曲线滑动（先快后慢）
-   * @param 起始x坐标 滑动起始坐标的X轴
-   * @param 起始y坐标 滑动起始坐标的Y轴
-   * @param 中间点x坐标 滑动中间点坐标的X轴
-   * @param 中间点y坐标 滑动中间点坐标的Y轴
-   * @param 目标x坐标 滑动目标坐标的X轴
-   * @param 目标y坐标 滑动目标坐标的Y轴
-   * @returns 操作是否成功
-   */
-  function 曲线滑动(
-    起始x坐标: 数字,
-    起始y坐标: 数字,
-    中间点x坐标: 数字,
-    中间点y坐标: 数字,
-    目标x坐标: 数字,
-    目标y坐标: 数字,
-  ): 布尔值;
-
-  /**
-   * 回到主页
-   * @returns 操作是否成功
-   */
-  function 回到主页(): 布尔值;
-
-  /**
-   * 输入文本
-   * @param 文本 要输入的文本
-   * @returns 操作是否成功
-   */
-  function 输入文本(文本: 字符串): 布尔值;
-
-  /**
-   * 空格（Space）
-   * @returns 操作是否成功
-   */
-  function 空格键(): 布尔值;
-
-  /**
-   * 删除键（Backspace）
-   * @param count 删除次数（可选，默认值为1）
-   * @returns 操作是否成功
-   */
-  function 删除键(count?: 数字): 布尔值;
-
-  /**
-   * 回车键（Return）
-   * @returns 操作是否成功
-   */
-  function 回车键(): 布尔值;
-
-  /**
-   * 发送组合按键
-   * @param 按键数组 按键数组
-   * @returns 操作是否成功
-   */
-  function 发送组合按键(按键数组: 数组<数字 | 字符串>): 布尔值;
-
-  /**
-   * 按下按钮
-   * @param 按键 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
-   * @returns 按下按钮是否成功
-   * @example $动作.按键("home")
-   */
-  function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
-
-  /**
-   * 复制文本（Command+C）
-   * @returns 操作是否成功
-   */
-  function 复制(): 布尔值;
-
-  /**
-   * 粘贴文本（Command+V）
-   * @returns 操作是否成功
-   */
-  function 粘贴(): 布尔值;
-
-  /**
-   * 返回（Tab+B)
-   * @returns 操作是否成功
-   */
-  function 返回(): 布尔值;
-
-  /**
-   * APP 切换器
-   * @returns 操作是否成功
-   */
-  function 最近应用(): 布尔值;
-
-  /**
-   * 锁屏
-   * @returns 操作是否成功
-   */
-  function 锁屏(): 布尔值;
-
-  /**
-   * 解锁（Home 两次）
-   * @returns 操作是否成功
-   */
-  function 解锁(): 布尔值;
-
-  /**
-   * 打开URL
-   * @param url URL字符串
-   * @returns 操作是否成功
-   */
-  function 打开URL(url: 字符串): 布尔值;
-
-  /**
-   * 打开 app
-   * @param name 应用名称 支持 app name 或 bundleId
-   * @returns 操作是否成功
-   */
-  function 打开App(name: 字符串): 布尔值;
-
-  /**
-   * 关闭 app
-   * @param name 应用名称 支持 app name 或 bundleId
-   * @returns 操作是否成功
-   */
-  function 关闭App(name: 字符串): 布尔值;
-
-  /**
-   * 切换到前台
-   * @returns 操作是否成功
-   */
-  function APP切入前台(): 布尔值;
-
-  /**
-   * 获取当前打开应用信息（仅 IOS18.6+）
-   * @returns 当前打开应用信息
-   */
-  function 当前打开应用信息(): {
-    /**
-     * 应用名称
-     */
-    name: 字符串;
-    /**
-     * 应用Bundle ID
-     */
-    bundleId: 字符串;
-  } | null;
-
-  /**
-   * 设置剪切板内容
-   * @param text 要设置的文本
-   * @returns 设置结果
-   */
-  function 设置剪切板内容(text: 字符串): 布尔值;
-
-  /**
-   * 获取剪切板内容
-   * @returns 剪切板内容
-   */
-  function 获取剪切板内容(): 字符串 | null;
-
-  /**
-   * 执行自定义按钮
-   * @param button 自定义按钮 5-11 对应 自定义快捷键 5-11
-   * @returns 操作是否成功
-   */
-  function 执行自定义按钮(button: 数字): 布尔值;
-}
+/// <reference path="全局模块.d.ts" />
+
+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模块 包含点击、滑动、长按滑动、返回首页等动作
+ */
+declare namespace $HID {
+  /**
+   * 打开录屏界面
+   */
+  function 打开录屏界面(): 无返回值;
+
+  /**
+   * 检查录屏是否开启
+   * @returns 是否开启
+   */
+  function 录屏是否开启(): 布尔值;
+
+  /**
+   * 检查是否连接了蓝牙HID设备
+   * @returns 是否连接了蓝牙HID设备
+   */
+  function 是否连接蓝牙模块(): 布尔值;
+
+  /**
+   * 检查是否连接了USB HID设备
+   * @returns 是否连接了USB HID设备
+   */
+  function 是否连接USB模块(): 布尔值;
+
+  /**
+   * 设置动作抖动值
+   * @param 抖动值
+   */
+  function 设置抖动值(抖动值: 数字): 无返回值;
+
+  /**
+   * 重置坐标
+   * @param 屏幕方向 可选值为"PORTRAIT"和"LANDSCAPE"
+   */
+  function 重置坐标(屏幕方向?: "PORTRAIT" | "LANDSCAPE"): 无返回值;
+
+  /**
+   * 移动指定坐标
+   * @param 坐标x 移动坐标的X轴
+   * @param 坐标y 移动坐标的Y轴
+   * @returns 操作是否成功
+   */
+  function 移动(坐标x: 数字, 坐标y: 数字): 布尔值;
+
+  /**
+   * 点击指定坐标
+   * @param 坐标x 点击坐标的X轴
+   * @param 坐标y 点击坐标的Y轴
+   * @param 按下持续时间 点击持续时间（可选，默认值为10毫秒）
+   * @param 抖动 是否添加随机抖动（可选，默认值为false）
+   * @returns 操作是否成功
+   */
+  function 点击(
+    坐标x: 数字,
+    坐标y: 数字,
+    按下持续时间?: 数字,
+    抖动?: 布尔值,
+  ): 布尔值;
+
+  /**
+   * 随机点击
+   * @param 区域左上角x坐标
+   * @param 区域左上角y坐标
+   * @param 区域右下角x坐标
+   * @param 区域右下角y坐标
+   * @param 按下持续时间 默认20ms
+   * @returns 随机点击是否成功
+   * @example $动作.点击随机范围(100, 100, 200, 200, 20)
+   */
+  function 点击随机范围(
+    区域左上角x坐标: 数字,
+    区域左上角y坐标: 数字,
+    区域右下角x坐标: 数字,
+    区域右下角y坐标: 数字,
+    按下持续时间?: 数字,
+  ): 布尔值;
+
+  /**
+   * 双击
+   * @param 坐标x
+   * @param 坐标y
+   * @param 按下持续时间 默认20ms
+   * @param 间隔时间 默认20ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
+   * @returns 双击是否成功
+   * @example $动作.双击(100, 100, 20, 20, true)
+   */
+  function 双击(
+    坐标x: 数字,
+    坐标y: 数字,
+    按下持续时间?: 数字,
+    间隔时间?: 数字,
+    抖动?: 布尔值,
+  ): 布尔值;
+  /**
+   * 随机双击
+   * @param 区域左上角x坐标
+   * @param 区域左上角y坐标
+   * @param 区域右下角x坐标
+   * @param 区域右下角y坐标
+   * @param 按下持续时间 默认20ms
+   * @param 间隔时间 默认20ms
+   * @returns 随机双击是否成功
+   * @example $动作.双击随机范围(100, 100, 200, 200, 20, 20)
+   */
+  function 双击随机范围(
+    区域左上角x坐标: 数字,
+    区域左上角y坐标: 数字,
+    区域右下角x坐标: 数字,
+    区域右下角y坐标: 数字,
+    按下持续时间?: 数字,
+    间隔时间?: 数字,
+  ): 布尔值;
+
+  /**
+   * 滑动指定坐标
+   * @param 起始x坐标 滑动起始坐标的X轴
+   * @param 起始y坐标 滑动起始坐标的Y轴
+   * @param 目标x坐标 滑动目标坐标的X轴
+   * @param 目标y坐标 滑动目标坐标的Y轴
+   * @param 抖动 是否添加随机抖动（可选，默认值为false）
+   * @param 步数 滑动步骤数（可选，默认值为6）
+   * @returns 操作是否成功
+   */
+  function 滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    抖动?: 布尔值,
+    步数?: 数字,
+  ): 布尔值;
+
+  /**
+   * 长按并滑动
+   * @param 起始x坐标 滑动起始坐标的X轴
+   * @param 起始y坐标 滑动起始坐标的Y轴
+   * @param 目标x坐标 滑动目标坐标的X轴
+   * @param 目标y坐标 滑动目标坐标的Y轴
+   * @param 长按持续时间 默认500ms
+   * @param 抖动 是否添加随机抖动（可选，默认值为false）
+   * @param 步数 滑动步骤数（可选，默认值为6）
+   * @returns 操作是否成功
+   */
+  function 长按并滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    长按持续时间?: 数字,
+    抖动?: 布尔值,
+    步数?: 数字,
+  ): 布尔值;
+
+  /**
+   * 3点曲线滑动（先快后慢）
+   * @param 起始x坐标 滑动起始坐标的X轴
+   * @param 起始y坐标 滑动起始坐标的Y轴
+   * @param 中间点x坐标 滑动中间点坐标的X轴
+   * @param 中间点y坐标 滑动中间点坐标的Y轴
+   * @param 目标x坐标 滑动目标坐标的X轴
+   * @param 目标y坐标 滑动目标坐标的Y轴
+   * @returns 操作是否成功
+   */
+  function 曲线滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    中间点x坐标: 数字,
+    中间点y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+  ): 布尔值;
+
+  /**
+   * 回到主页
+   * @returns 操作是否成功
+   */
+  function 回到主页(): 布尔值;
+
+  /**
+   * 输入文本
+   * @param 文本 要输入的文本
+   * @returns 操作是否成功
+   */
+  function 输入文本(文本: 字符串): 布尔值;
+
+  /**
+   * 空格（Space）
+   * @returns 操作是否成功
+   */
+  function 空格键(): 布尔值;
+
+  /**
+   * 删除键（Backspace）
+   * @param count 删除次数（可选，默认值为1）
+   * @returns 操作是否成功
+   */
+  function 删除键(count?: 数字): 布尔值;
+
+  /**
+   * 回车键（Return）
+   * @returns 操作是否成功
+   */
+  function 回车键(): 布尔值;
+
+  /**
+   * 发送组合按键
+   * @param 按键数组 按键数组
+   * @returns 操作是否成功
+   */
+  function 发送组合按键(按键数组: 数组<数字 | 字符串>): 布尔值;
+
+  /**
+   * 按下按钮
+   * @param 按键 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
+   * @returns 按下按钮是否成功
+   * @example $动作.按键("home")
+   */
+  function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
+
+  /**
+   * 复制文本（Command+C）
+   * @returns 操作是否成功
+   */
+  function 复制(): 布尔值;
+
+  /**
+   * 粘贴文本（Command+V）
+   * @returns 操作是否成功
+   */
+  function 粘贴(): 布尔值;
+
+  /**
+   * 返回（Tab+B)
+   * @returns 操作是否成功
+   */
+  function 返回(): 布尔值;
+
+  /**
+   * APP 切换器
+   * @returns 操作是否成功
+   */
+  function 最近应用(): 布尔值;
+
+  /**
+   * 锁屏
+   * @returns 操作是否成功
+   */
+  function 锁屏(): 布尔值;
+
+  /**
+   * 解锁（Home 两次）
+   * @returns 操作是否成功
+   */
+  function 解锁(): 布尔值;
+
+  /**
+   * 打开URL
+   * @param url URL字符串
+   * @returns 操作是否成功
+   */
+  function 打开URL(url: 字符串): 布尔值;
+
+  /**
+   * 打开 app
+   * @param name 应用名称 支持 app name 或 bundleId
+   * @returns 操作是否成功
+   */
+  function 打开App(name: 字符串): 布尔值;
+
+  /**
+   * 关闭 app
+   * @param name 应用名称 支持 app name 或 bundleId
+   * @returns 操作是否成功
+   */
+  function 关闭App(name: 字符串): 布尔值;
+
+  /**
+   * 切换到前台
+   * @returns 操作是否成功
+   */
+  function APP切入前台(): 布尔值;
+
+  /**
+   * 获取当前打开应用信息（仅 IOS18.6+）
+   * @returns 当前打开应用信息
+   */
+  function 当前打开应用信息(): {
+    /**
+     * 应用名称
+     */
+    name: 字符串;
+    /**
+     * 应用Bundle ID
+     */
+    bundleId: 字符串;
+  } | null;
+
+  /**
+   * 设置剪切板内容
+   * @param text 要设置的文本
+   * @returns 设置结果
+   */
+  function 设置剪切板内容(text: 字符串): 布尔值;
+
+  /**
+   * 获取剪切板内容
+   * @returns 剪切板内容
+   */
+  function 获取剪切板内容(): 字符串 | null;
+
+  /**
+   * 执行自定义按钮
+   * @param button 自定义按钮 5-11 对应 自定义快捷键 5-11
+   * @returns 操作是否成功
+   */
+  function 执行自定义按钮(button: 数字): 布尔值;
+}