ms-types 0.1.23 → 0.1.25

package/types/zh//345/212/250/344/275/234/346/250/241/345/235/227.d.ts

@@ -1,300 +1,300 @@
-/// <reference path="全局模块.d.ts" />
-
-/**
- * 动作模块 包含点击、滑动、长按滑动、返回首页等动作
- */
-declare namespace $动作 {
-  /**
-   * 设置动作抖动值 点击、滑动等动作会在像素范围-5到5随机偏移
-   * @param value 抖动值
-   * @example $动作.设置抖动值(5)
-   */
-  function 设置抖动值(抖动值: 数字): 无返回值;
-  /**
-   * 点击
-   * @param 坐标x
-   * @param 坐标y
-   * @param 按下持续时间 默认20ms
-   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
-   * @returns 点击是否成功
-   * @example $动作.点击(100, 100, 20, true)
-   */
-  function 点击(
-    坐标x: 数字,
-    坐标y: 数字,
-    按下持续时间?: 数字,
-    抖动?: 布尔值
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 随机点击
-   * @param 区域左上角x坐标
-   * @param 区域左上角y坐标
-   * @param 区域右下角x坐标
-   * @param 区域右下角y坐标
-   * @param 按下持续时间 默认20ms
-   * @returns 随机点击是否成功
-   * @example $动作.点击随机范围(100, 100, 200, 200, 20)
-   */
-  function 点击随机范围(
-    区域左上角x坐标: 数字,
-    区域左上角y坐标: 数字,
-    区域右下角x坐标: 数字,
-    区域右下角y坐标: 数字,
-    按下持续时间?: 数字
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 双击
-   * @param 坐标x
-   * @param 坐标y
-   * @param 按下持续时间 默认20ms
-   * @param 间隔时间 默认20ms
-   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
-   * @returns 双击是否成功
-   * @example $动作.双击(100, 100, 20, 20, true)
-   */
-  function 双击(
-    坐标x: 数字,
-    坐标y: 数字,
-    按下持续时间?: 数字,
-    间隔时间?: 数字,
-    抖动?: 布尔值
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 随机双击
-   * @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坐标: 数字,
-    按下持续时间?: 数字,
-    间隔时间?: 数字
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 滑动
-   * @param 起始x坐标
-   * @param 起始y坐标
-   * @param 目标x坐标
-   * @param 目标y坐标
-   * @param 滑动持续时间 默认 100ms
-   * @param 抖动 开启抖动，会在像素范围随机偏移 滑动 默认false
-   * @param 步数 生成抖动点数量 默认6
-   * @returns 滑动是否成功
-   * @example $动作.滑动(100, 100, 200, 200, 500, true, 10)
-   */
-  function 滑动(
-    起始x坐标: 数字,
-    起始y坐标: 数字,
-    目标x坐标: 数字,
-    目标y坐标: 数字,
-    滑动持续时间?: 数字,
-    抖动?: 布尔值,
-    步数?: 数字
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 长按滑动
-   * @param 起始x坐标
-   * @param 起始y坐标
-   * @param 目标x坐标
-   * @param 目标y坐标
-   * @param 按下持续时间 默认500ms
-   * @param 移动持续时间 默认1000ms
-   * @param 松开持续时间 默认500ms
-   * @param 抖动 开启抖动，会在像素范围随机偏移 长按滑动 默认false
-   * @param 步数 生成抖动点数量 默认6
-   * @returns 长按滑动是否成功
-   * @example $动作.长按并滑动(100, 100, 200, 200, 500, 500, 500, true, 10)
-   */
-  function 长按并滑动(
-    起始x坐标: 数字,
-    起始y坐标: 数字,
-    目标x坐标: 数字,
-    目标y坐标: 数字,
-    按下持续时间?: 数字,
-    移动持续时间?: 数字,
-    松开持续时间?: 数字,
-    抖动?: 布尔值,
-    步数?: 数字
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 3点曲线滑动（先快后慢，拟人化轨迹）
-   * 使用二次贝塞尔曲线算法，添加随机偏移和时间抖动，模拟真实人手操作
-   * @param 起始x坐标
-   * @param 起始y坐标
-   * @param 中间点x坐标（控制曲线弯曲程度）
-   * @param 中间点y坐标（控制曲线弯曲程度）
-   * @param 目标x坐标
-   * @param 目标y坐标
-   * @param 滑动持续时间 总持续时间（毫秒），默认1000ms，实际执行时间会有随机变化
-   * @returns 曲线滑动是否成功
-   * @example $动作.曲线滑动(100, 100, 200, 150, 300, 200, 1000)
-   */
-  function 曲线滑动(
-    起始x坐标: 数字,
-    起始y坐标: 数字,
-    中间点x坐标: 数字,
-    中间点y坐标: 数字,
-    目标x坐标: 数字,
-    目标y坐标: 数字,
-    滑动持续时间?: 数字
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 输入文本
-   * @param text 文本内容
-   * @returns 输入文本是否成功
-   * @example $动作.输入文本("123456")
-   */
-  function 输入文本(文本: 字符串): 布尔值 | Promise<布尔值>;
-  /**
-   * 删除文本
-   * @param 删除数量 默认为1
-   * @returns 删除文本是否成功
-   * @example $动作.删除文本(1)
-   */
-  function 删除文本(删除数量?: 数字): 布尔值 | Promise<布尔值>;
-  /**
-   * 调用回车
-   * @returns 调用回车是否成功
-   * @example $动作.回车()
-   */
-  function 回车(): 布尔值 | Promise<布尔值>;
-  /**
-   * 返回首页
-   * @returns 返回首页是否成功
-   * @example $动作.回到主页()
-   */
-  function 回到主页(): 布尔值 | Promise<布尔值>;
-  /**
-   * 按下按钮
-   * @param 按键 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
-   * @returns 按下按钮是否成功
-   * @example $动作.按键("home")
-   */
-  function 按键(
-    按键: "home" | "volumeup" | "volumedown"
-  ): 布尔值 | Promise<布尔值>;
-  /**
-   * 模拟按下HID按钮
-   * @param 按键 HID按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键 power 按下电源键 snapshot 按下截图键
-   * @param 持续时间 持续时间 单位毫秒 默认20ms
-   * @returns 按下HID按钮是否成功
-   * @example $动作.按键HID("home", 200)
-   */
-  function 按键HID(
-    按键: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
-    持续时间?: 数字
-  ): 布尔值 | Promise<布尔值>;
-
-  /**
-   * 创建 动作构建器，支持链式调用构建复杂的多点触控动作
-   * @returns 动作构建器 实例
-   * @example const 动作构建器 = $动作.创建动作构建器()
-   */
-  function 创建动作构建器(): $动作构建器;
-
-  /**
-   * ActionBuilder 构建器接口
-   * 支持链式调用构建复杂的多点触控动作
-   */
-  interface $动作构建器 {
-    /**
-     * 添加一个指针（手指）
-     * @param id 指针编号，如 1-10
-     * @returns PointerBuilder 用于配置该指针的动作
-     * @example 动作构建器.添加手指(1).移动到(100, 100).点击(200, 200).完成()
-     */
-    添加手指(手指: 数字): $指针构建器;
-
-    /**
-     * 快速创建单点点击
-     * @param 坐标x
-     * @param 坐标y
-     * @param 持续时间 点击持续时间，如果未定义则默认为 20ms
-     * @returns 返回自身，支持链式调用
-     * @example 动作构建器.单指点击(100, 100, 50).执行()
-     */
-    单指点击(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $动作构建器;
-
-    /**
-     * 快速创建多点点击
-     * @param points 点击坐标数组，每个元素包含 x 和 y 坐标
-     * @param duration 点击持续时间，如果未定义则默认为 20ms
-     * @returns 返回自身，支持链式调用
-     * @example 动作构建器.多指点击([{x: 100, y: 100}, {x: 200, y: 200}], 50).执行()
-     */
-    多指点击(
-      坐标数组: Array<{ x: 数字; y: 数字 }>,
-      持续时间?: 数字
-    ): $动作构建器;
-
-    /**
-     * 执行构建的动作
-     * @returns 执行是否成功
-     * @example const 是否成功 = 动作构建器.执行()
-     */
-    执行(): 布尔值 | Promise<布尔值>;
-  }
-
-  /**
-   * 指针构建器接口
-   * 用于配置单个指针（手指）的动作序列
-   */
-  interface $指针构建器 {
-    /**
-     * 移动到指定坐标
-     * @param 坐标x
-     * @param 坐标y
-     * @param 持续时间 移动持续时间，如果未定义则默认为 0ms
-     * @returns 返回自身，支持链式调用
-     * @example 指针构建器.移动到(100, 100, 200)
-     */
-    移动到(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
-
-    /**
-     * 按下手指
-     * @returns 返回自身，支持链式调用
-     * @example 指针构建器.按下()
-     */
-    按下(): $指针构建器;
-
-    /**
-     * 抬起手指
-     * @returns 返回自身，支持链式调用
-     * @example 指针构建器.抬起()
-     */
-    抬起(): $指针构建器;
-
-    /**
-     * 延迟指定时间（暂停）
-     * @param 持续时间 延迟时间（毫秒），如果未定义则默认为 20ms
-     * @returns 返回自身，支持链式调用
-     * @example 指针构建器.停留(100)
-     */
-    停留(持续时间?: 数字): $指针构建器;
-
-    /**
-     * 执行点击动作（移动 -> 按下 -> 暂停 -> 抬起）
-     * @param 坐标x
-     * @param 坐标y
-     * @param 持续时间 按下持续时间，如果未定义则默认为 20ms
-     * @returns 返回自身，支持链式调用
-     * @example 指针构建器.点击(100, 100, 50)
-     */
-    点击(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
-
-    /**
-     * 完成当前指针配置，返回到主构建器
-     * @returns 返回 ActionBuilder，可以继续添加其他指针
-     * @example pointer.done().addPointer(2)
-     */
-    完成(): $动作构建器;
-  }
-}
+/// <reference path="全局模块.d.ts" />
+
+/**
+ * 动作模块 包含点击、滑动、长按滑动、返回首页等动作
+ */
+declare namespace $动作 {
+  /**
+   * 设置动作抖动值 点击、滑动等动作会在像素范围-5到5随机偏移
+   * @param value 抖动值
+   * @example $动作.设置抖动值(5)
+   */
+  function 设置抖动值(抖动值: 数字): 无返回值;
+  /**
+   * 点击
+   * @param 坐标x
+   * @param 坐标y
+   * @param 按下持续时间 默认20ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
+   * @returns 点击是否成功
+   * @example $动作.点击(100, 100, 20, true)
+   */
+  function 点击(
+    坐标x: 数字,
+    坐标y: 数字,
+    按下持续时间?: 数字,
+    抖动?: 布尔值
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 随机点击
+   * @param 区域左上角x坐标
+   * @param 区域左上角y坐标
+   * @param 区域右下角x坐标
+   * @param 区域右下角y坐标
+   * @param 按下持续时间 默认20ms
+   * @returns 随机点击是否成功
+   * @example $动作.点击随机范围(100, 100, 200, 200, 20)
+   */
+  function 点击随机范围(
+    区域左上角x坐标: 数字,
+    区域左上角y坐标: 数字,
+    区域右下角x坐标: 数字,
+    区域右下角y坐标: 数字,
+    按下持续时间?: 数字
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 双击
+   * @param 坐标x
+   * @param 坐标y
+   * @param 按下持续时间 默认20ms
+   * @param 间隔时间 默认20ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
+   * @returns 双击是否成功
+   * @example $动作.双击(100, 100, 20, 20, true)
+   */
+  function 双击(
+    坐标x: 数字,
+    坐标y: 数字,
+    按下持续时间?: 数字,
+    间隔时间?: 数字,
+    抖动?: 布尔值
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 随机双击
+   * @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坐标: 数字,
+    按下持续时间?: 数字,
+    间隔时间?: 数字
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 滑动
+   * @param 起始x坐标
+   * @param 起始y坐标
+   * @param 目标x坐标
+   * @param 目标y坐标
+   * @param 滑动持续时间 默认 100ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 滑动 默认false
+   * @param 步数 生成抖动点数量 默认6
+   * @returns 滑动是否成功
+   * @example $动作.滑动(100, 100, 200, 200, 500, true, 10)
+   */
+  function 滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    滑动持续时间?: 数字,
+    抖动?: 布尔值,
+    步数?: 数字
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 长按滑动
+   * @param 起始x坐标
+   * @param 起始y坐标
+   * @param 目标x坐标
+   * @param 目标y坐标
+   * @param 按下持续时间 默认500ms
+   * @param 移动持续时间 默认1000ms
+   * @param 松开持续时间 默认500ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 长按滑动 默认false
+   * @param 步数 生成抖动点数量 默认6
+   * @returns 长按滑动是否成功
+   * @example $动作.长按并滑动(100, 100, 200, 200, 500, 500, 500, true, 10)
+   */
+  function 长按并滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    按下持续时间?: 数字,
+    移动持续时间?: 数字,
+    松开持续时间?: 数字,
+    抖动?: 布尔值,
+    步数?: 数字
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 3点曲线滑动（先快后慢，拟人化轨迹）
+   * 使用二次贝塞尔曲线算法，添加随机偏移和时间抖动，模拟真实人手操作
+   * @param 起始x坐标
+   * @param 起始y坐标
+   * @param 中间点x坐标（控制曲线弯曲程度）
+   * @param 中间点y坐标（控制曲线弯曲程度）
+   * @param 目标x坐标
+   * @param 目标y坐标
+   * @param 滑动持续时间 总持续时间（毫秒），默认1000ms，实际执行时间会有随机变化
+   * @returns 曲线滑动是否成功
+   * @example $动作.曲线滑动(100, 100, 200, 150, 300, 200, 1000)
+   */
+  function 曲线滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    中间点x坐标: 数字,
+    中间点y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    滑动持续时间?: 数字
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 输入文本
+   * @param text 文本内容
+   * @returns 输入文本是否成功
+   * @example $动作.输入文本("123456")
+   */
+  function 输入文本(文本: 字符串): 布尔值 | Promise<布尔值>;
+  /**
+   * 删除文本
+   * @param 删除数量 默认为1
+   * @returns 删除文本是否成功
+   * @example $动作.删除文本(1)
+   */
+  function 删除文本(删除数量?: 数字): 布尔值 | Promise<布尔值>;
+  /**
+   * 调用回车
+   * @returns 调用回车是否成功
+   * @example $动作.回车()
+   */
+  function 回车(): 布尔值 | Promise<布尔值>;
+  /**
+   * 返回首页
+   * @returns 返回首页是否成功
+   * @example $动作.回到主页()
+   */
+  function 回到主页(): 布尔值 | Promise<布尔值>;
+  /**
+   * 按下按钮
+   * @param 按键 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
+   * @returns 按下按钮是否成功
+   * @example $动作.按键("home")
+   */
+  function 按键(
+    按键: "home" | "volumeup" | "volumedown"
+  ): 布尔值 | Promise<布尔值>;
+  /**
+   * 模拟按下HID按钮
+   * @param 按键 HID按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键 power 按下电源键 snapshot 按下截图键
+   * @param 持续时间 持续时间 单位毫秒 默认20ms
+   * @returns 按下HID按钮是否成功
+   * @example $动作.按键HID("home", 200)
+   */
+  function 按键HID(
+    按键: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
+    持续时间?: 数字
+  ): 布尔值 | Promise<布尔值>;
+
+  /**
+   * 创建 动作构建器，支持链式调用构建复杂的多点触控动作
+   * @returns 动作构建器 实例
+   * @example const 动作构建器 = $动作.创建动作构建器()
+   */
+  function 创建动作构建器(): $动作构建器;
+
+  /**
+   * ActionBuilder 构建器接口
+   * 支持链式调用构建复杂的多点触控动作
+   */
+  interface $动作构建器 {
+    /**
+     * 添加一个指针（手指）
+     * @param id 指针编号，如 1-10
+     * @returns PointerBuilder 用于配置该指针的动作
+     * @example 动作构建器.添加手指(1).移动到(100, 100).点击(200, 200).完成()
+     */
+    添加手指(手指: 数字): $指针构建器;
+
+    /**
+     * 快速创建单点点击
+     * @param 坐标x
+     * @param 坐标y
+     * @param 持续时间 点击持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 动作构建器.单指点击(100, 100, 50).执行()
+     */
+    单指点击(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $动作构建器;
+
+    /**
+     * 快速创建多点点击
+     * @param points 点击坐标数组，每个元素包含 x 和 y 坐标
+     * @param duration 点击持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 动作构建器.多指点击([{x: 100, y: 100}, {x: 200, y: 200}], 50).执行()
+     */
+    多指点击(
+      坐标数组: Array<{ x: 数字; y: 数字 }>,
+      持续时间?: 数字
+    ): $动作构建器;
+
+    /**
+     * 执行构建的动作
+     * @returns 执行是否成功
+     * @example const 是否成功 = 动作构建器.执行()
+     */
+    执行(): 布尔值 | Promise<布尔值>;
+  }
+
+  /**
+   * 指针构建器接口
+   * 用于配置单个指针（手指）的动作序列
+   */
+  interface $指针构建器 {
+    /**
+     * 移动到指定坐标
+     * @param 坐标x
+     * @param 坐标y
+     * @param 持续时间 移动持续时间，如果未定义则默认为 0ms
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.移动到(100, 100, 200)
+     */
+    移动到(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
+
+    /**
+     * 按下手指
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.按下()
+     */
+    按下(): $指针构建器;
+
+    /**
+     * 抬起手指
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.抬起()
+     */
+    抬起(): $指针构建器;
+
+    /**
+     * 延迟指定时间（暂停）
+     * @param 持续时间 延迟时间（毫秒），如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.停留(100)
+     */
+    停留(持续时间?: 数字): $指针构建器;
+
+    /**
+     * 执行点击动作（移动 -> 按下 -> 暂停 -> 抬起）
+     * @param 坐标x
+     * @param 坐标y
+     * @param 持续时间 按下持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.点击(100, 100, 50)
+     */
+    点击(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
+
+    /**
+     * 完成当前指针配置，返回到主构建器
+     * @returns 返回 ActionBuilder，可以继续添加其他指针
+     * @example pointer.done().addPointer(2)
+     */
+    完成(): $动作构建器;
+  }
+}