ms-types 0.0.64 → 0.0.66

package/types/zh//350/212/202/347/202/271/346/250/241/345/235/227.d.ts

@@ -0,0 +1,274 @@
+/// <reference path="全局模块.d.ts" />
+/**
+ * 节点模块 包含节点操作、节点内容读写等功能
+ */
+declare function $创建节点选择器(params?: {
+  /**
+   *  1 代表不管visible是true还是false都获取，2 代表只获取 visible=true的节点
+   */
+  visibleFilter: 1 | 2;
+  /**
+   *  1 代表不管label是否有值都获取，2 代表只获取label有值的节点
+   */
+  labelFilter: 1 | 2;
+  /**
+   *  1 代表不过滤 2 bounds 区域属性x,y,w,h都小于0就被过滤
+   */
+  boundsFilter: 1 | 2;
+  /**
+   * 代表要获取节点的层级，越少速度越快，建议 1 - 50
+   */
+  maxDepth: 数字;
+  /**
+   * 最大获取子节点数量，0代表不限制
+   */
+  maxChildCount: 数字;
+  /**
+   * 代表要过滤的属性，用英文逗号分割，可以增加抓取速度，例如 visible,enable
+   */
+  excludedAttributes: 字符串;
+}): $节点选择器;
+
+declare interface $节点位置信息 {
+  /**
+   * x坐标
+   */
+  x: 数字;
+  /**
+   * y坐标
+   */
+  y: 数字;
+  /**
+   * 宽度
+   */
+  width: 数字;
+  /**
+   * 高度
+   */
+  height: 数字;
+  /**
+   * 节点中心x坐标
+   */
+  centerX: 数字;
+  /**
+   * 节点中心y坐标
+   */
+  centerY: 数字;
+}
+
+declare interface $节点信息 {
+  id: 数字;
+  /**
+   * 节点标签
+   */
+  label: 字符串;
+  /**
+   * 节点类型
+   */
+  type: 字符串;
+  /**
+   * 节点值
+   */
+  value: 字符串;
+  /**
+   * 节点名称
+   */
+  name: 字符串;
+  /**
+   * 节点是否可见
+   */
+  visible: 布尔值;
+  /**
+   * 节点是否启用
+   */
+  enabled: 布尔值;
+  /**
+   * 节点是否可访问
+   */
+  accessible: 布尔值;
+  /**
+   * 节点位置
+   */
+  bounds: $节点位置信息;
+  /**
+   * 节点层级
+   */
+  depth: 数字;
+  /**
+   * 节点索引
+   */
+  index: 数字;
+  /**
+   * 父节点id
+   */
+  parentId: 数字;
+  /**
+   * 子节点数量
+   */
+  childCount: 数字;
+  /**
+   * 点击节点中心
+   */
+  clickCenter(): 布尔值;
+  /**
+   * 点击节点随机位置
+   */
+  clickRandom(): 布尔值;
+  /**
+   * 获取父节点
+   */
+  parent(): $节点信息 | null;
+  /**
+   * 获取子节点
+   * @param 索引 子节点索引
+   */
+  child(索引: 数字): $节点信息 | null;
+  /**
+   * 获取所有子节点
+   */
+  allChildren(): 数组<$节点信息>;
+  /**
+   * 获取所有兄弟节点
+   */
+  siblings(): 数组<$节点信息>;
+  /**
+   * 获取所有前兄弟节点
+   */
+  previousSiblings(): 数组<$节点信息>;
+  /**
+   * 获取所有后兄弟节点
+   */
+  nextSiblings(): 数组<$节点信息>;
+}
+
+/**
+ * 节点选择器 包含节点选择、节点操作等功能
+ */
+declare class $节点选择器 {
+  /**
+   * 获取节点信息
+   * @param 超时时间 单位毫秒 默认为 5000 毫秒
+   * @returns 节点信息数组
+   */
+  获取所有节点(超时时间?: 数字): 数组<$节点信息>;
+  /**
+   * 获取一个节点信息
+   * @param 超时时间 超时时间，单位毫秒 默认为 5000 毫秒
+   * @returns 节点信息
+   */
+  获取一个节点(超时时间?: 数字): $节点信息 | null;
+  /**
+   * 加载节点
+   * @param 超时时间 超时时间，单位毫秒 默认为 5000 毫秒
+   */
+  加载节点数据(超时时间?: 数字): $节点选择器;
+  /**
+   * 清除条件
+   */
+  清除所有选择条件(): $节点选择器;
+  /**
+   * 获取节点xpath
+   * @param xpath 节点xpath路径
+   * @returns 节点选择器
+   */
+  xpath(xpath: 字符串): $节点选择器;
+  /**
+   * 获取节点标签
+   * @param label 节点标签
+   * @returns 节点选择器
+   */
+  label(label: 字符串): $节点选择器;
+  /**
+   * 获取节点标签匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  labelMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点名称
+   * @param name 节点名称
+   * @returns 节点选择器
+   */
+  name(name: 字符串): $节点选择器;
+  /**
+   * 获取节点名称匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  nameMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点类型
+   * @param type 节点类型
+   * @returns 节点选择器
+   */
+  type(type: 字符串): $节点选择器;
+  /**
+   * 获取节点类型匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  typeMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点值
+   * @param value 节点值
+   * @returns 节点选择器
+   */
+  value(value: 字符串): $节点选择器;
+  /**
+   * 获取节点值匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  valueMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点是否启用
+   * @param enable 是否启用
+   * @returns 节点选择器
+   */
+  enable(enable: 布尔值): $节点选择器;
+  /**
+   * 获取节点是否可访问
+   * @param accessible 是否可访问
+   * @returns 节点选择器
+   */
+  accessible(accessible: 布尔值): $节点选择器;
+  /**
+   * 获取节点是否可见
+   * @param visible 是否可见
+   * @returns 节点选择器
+   */
+  visible(visible: 布尔值): $节点选择器;
+  /**
+   * 获取节点索引
+   * @param index 节点索引
+   * @returns 节点选择器
+   */
+  index(index: 数字): $节点选择器;
+  /**
+   * 获取节点层级
+   * @param depth 节点层级
+   * @returns 节点选择器
+   */
+  depth(depth: 数字): $节点选择器;
+  /**
+   * 获取节点是否选中
+   * @param selected 是否选中
+   * @returns 节点选择器
+   */
+  selected(selected: 布尔值): $节点选择器;
+  /**
+   * 获取节点子节点数量
+   * @param childCount 子节点数量
+   * @returns 节点选择器
+   */
+  childCount(childCount: 数字): $节点选择器;
+  /**
+   * 获取节点位置
+   * @param x x坐标
+   * @param y y坐标
+   * @param width 宽度
+   * @param height 高度
+   * @returns 节点选择器
+   */
+  bounds(x: 数字, y: 数字, width: 数字, height: 数字): $节点选择器;
+}

package/types/zh//350/213/271/346/236/234OCR.d.ts

@@ -0,0 +1,104 @@
+/// <reference path="全局模块.d.ts" />
+
+/**
+ * Apple OCR模块 使用Apple Vision框架进行文本识别
+ */
+declare namespace $苹果OCR {
+  /**
+   * OCR识别结果接口
+   */
+  interface OCR识别结果 {
+    /** 识别的文本内容 */
+    text: 字符串;
+    /** 识别置信度 (0-1) */
+    confidence: 数字;
+    /** 文本区域左上角 x 坐标 */
+    x: 数字;
+    /** 文本区域左上角 y 坐标 */
+    y: 数字;
+    /** 文本区域右下角 x 坐标 */
+    ex: 数字;
+    /** 文本区域右下角 y 坐标 */
+    ey: 数字;
+    /** 文本区域宽度 */
+    width: 数字;
+    /** 文本区域高度 */
+    height: 数字;
+    /** 文本区域中心点 x 坐标 */
+    centerX: 数字;
+    /** 文本区域中心点 y 坐标 */
+    centerY: 数字;
+  }
+
+  /**
+   * 执行OCR识别（使用Apple Vision框架）
+   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
+   * @param 图片边界框左上角x坐标 图片边界框左上角x坐标
+   * @param 图片边界框左上角y坐标 图片边界框左上角y坐标
+   * @param 图片边界框右下角x坐标 图片边界框右下角x坐标
+   * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
+   * @param 识别语言数组 识别语言数组，默认为["zh-Hans", "en-US"]
+   * @returns 识别结果数组，包含文本、置信度、坐标等信息
+   * @example
+   * const 检查结果数组 = $苹果OCR.识别("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * 检查结果数组.forEach(目标 => {
+   *   $打印信息日志(`文本: ${目标.text}, 置信度: ${目标.confidence}`)
+   * })
+   */
+  function 识别(
+    输入源: 字符串,
+    图片边界框左上角x坐标?: 数字,
+    图片边界框左上角y坐标?: 数字,
+    图片边界框右下角x坐标?: 数字,
+    图片边界框右下角y坐标?: 数字,
+    识别语言数组?: Array<字符串>
+  ): 数组<OCR识别结果>;
+
+  /**
+   * 执行OCR识别（仅识别数字）0-9.,+-
+   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
+   * @param 图片边界框左上角x坐标 图片边界框左上角x坐标
+   * @param 图片边界框左上角y坐标 图片边界框左上角y坐标
+   * @param 图片边界框右下角x坐标 图片边界框右下角x坐标
+   * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
+   * @returns 识别结果数组，包含文本、置信度、坐标等信息
+   * @example
+   * const 检查结果数组 = $苹果OCR.识别数字("screen", 0, 0, 100, 100)
+   * 检查结果数组.forEach(目标 => {
+   *   $打印信息日志(`文本: ${目标.text}, 置信度: ${目标.confidence}`)
+   * })
+   */
+  function 识别数字(
+    输入源: 字符串,
+    图片边界框左上角x坐标?: 数字,
+    图片边界框左上角y坐标?: 数字,
+    图片边界框右下角x坐标?: 数字,
+    图片边界框右下角y坐标?: 数字
+  ): 数组<OCR识别结果>;
+
+  /**
+   * 执行OCR识别（查找指定文本）
+   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
+   * @param 要查找的文本数组 要查找的文本数组
+   * @param 图片边界框左上角x坐标 图片边界框左上角x坐标
+   * @param 图片边界框左上角y坐标 图片边界框左上角y坐标
+   * @param 图片边界框右下角x坐标 图片边界框右下角x坐标
+   * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
+   * @param 识别语言数组 识别语言数组，默认为["zh-Hans", "en-US"]
+   * @returns 识别结果数组，包含文本、置信度、坐标等信息
+   * @example
+   * const 检查结果数组 = $苹果OCR.查找文本("screen", ["123", "456"], 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * 检查结果数组.forEach(目标 => {
+   *   $打印信息日志(`文本: ${目标.text}, 置信度: ${目标.confidence}`)
+   * })
+   */
+  function 查找文本(
+    输入源: 字符串,
+    要查找的文本数组: 数组<字符串>,
+    图片边界框左上角x坐标?: 数字,
+    图片边界框左上角y坐标?: 数字,
+    图片边界框右下角x坐标?: 数字,
+    图片边界框右下角y坐标?: 数字,
+    识别语言数组?: 数组<字符串>
+  ): 数组<OCR识别结果>;
+}

package/types/zh//350/247/206/345/233/276/346/250/241/345/235/227.d.ts

@@ -0,0 +1,167 @@
+/// <reference path="全局模块.d.ts" />
+
+declare namespace $快点 {
+  /**
+   * 注册UI函数 网页页面使用，给主进程调用
+   * @param name 函数名称
+   * @param func 函数
+   */
+  function registerUIFunc(
+    name: string,
+    func: (data: Record<string, any>) => void
+  ): void;
+
+  /**
+   * 发送事件 网页页面使用 给主进程发送事件
+   * @param event 事件名称
+   * @param data 事件参数
+   */
+  function emitEvent(event: string, data: Record<string, any>): void;
+
+  /**
+   * 启动脚本 网页页面使用
+   * @returns 如果启动成功返回true，否则返回false
+   */
+  function startTask(): Promise<boolean>;
+
+  /**
+   * 停止脚本 网页页面使用
+   * @returns 如果停止成功返回false，否则返回true
+   */
+  function stopTask(): Promise<boolean>;
+
+  /**
+   * 检查脚本是否正在运行 网页页面使用
+   * @returns 如果脚本正在运行返回true，否则返回false
+   */
+  function isTaskRunning(): Promise<boolean>;
+
+  /**
+   * 设置配置项
+   * @param key 配置项键
+   * @param value 配置项值
+   * @returns 如果设置成功返回true，否则返回false
+   */
+  function setConfig(key: string, value: any): Promise<boolean>;
+
+  /**
+   * 获取配置项
+   * @param key 配置项键
+   * @returns 配置项值
+   */
+  function getConfig(key: string): Promise<any>;
+
+  /**
+   * 移除配置项
+   * @param key 配置项键
+   * @returns 如果移除成功返回true，否则返回false
+   */
+  function removeConfig(key: string): Promise<boolean>;
+
+  /**
+   * 获取所有配置的字典
+   * @returns 包含所有配置的字典
+   */
+  function getAllConfig(): Promise<Record<string, any>>;
+
+  /**
+   * 获取服务器设备ID
+   * @returns 服务器设备ID
+   */
+  function getServerDeviceId(): Promise<string>;
+
+  /**
+   * 获取WDA状态
+   * @returns 如果WDA正在运行返回true，否则返回false
+   */
+  function getWDAStatus(): Promise<boolean>;
+
+  /**
+   * 启动WDA服务
+   * @returns 如果调用成功返回true，否则返回false。注意：返回值仅表示调用是否成功，不代表WDA服务是否启动成功
+   */
+  function startWDA(): Promise<boolean>;
+
+  /**
+   * 打开URL
+   * @param url URL地址
+   * @returns 如果调用成功返回true，否则返回false
+   */
+  function openURL(url: string): Promise<boolean>;
+}
+
+/**
+ * UI模块 提供WebView相关功能
+ */
+declare namespace $视图 {
+  /**
+   * 设置事件回调函数
+   * @param onEvent 事件回调函数
+   * @example
+   * $视图.监听事件回调((事件名称, 数据) => {
+   *   // 接收网页发送的事件
+   *   $打印信息日志(`事件名称: ${事件名称}, 数据: ${JSON.stringify(数据)}`)
+   * })
+   */
+  function 监听事件回调(
+    回调函数: (事件名称: string, 数据: 字典<任意类型>) => 无返回值
+  ): 无返回值;
+
+  /**
+   * 调用WebView中的JavaScript函数
+   * @param 函数名 registerUIFunc 注册的函数名
+   * @param 数据
+   * @example
+   * $视图.调用函数("jsMethod", {
+   *   name: "快点JS",
+   * })
+   */
+  function 调用函数(函数名: 字符串, 数据: 任意类型): 无返回值;
+
+  /**
+   * 显示Toast提示消息
+   * @param 消息内容 提示消息内容
+   * @example
+   * $视图.显示Toast提示("操作成功");
+   */
+  function 显示Toast提示(消息内容: 字符串): 无返回值;
+
+  /**
+   * 显示确认对话框
+   * @param title 对话框标题
+   * @param message 对话框内容
+   * @returns 用户选择结果，确定返回true，取消返回false
+   * @example
+   * const 是否确认 = $视图.显示确认对话框("确认", "是否继续操作？");
+   * if (是否确认) {
+   *   $打印信息日志("用户点击了确定");
+   * } else {
+   *   $打印信息日志("用户点击了取消");
+   * }
+   */
+  function 显示确认对话框(标题: 字符串, 消息内容: 字符串): 布尔值;
+
+  /**
+   * 显示输入对话框
+   * @param 标题 对话框标题
+   * @param 消息内容 对话框内容
+   * @returns 用户输入的内容，取消返回空字符串
+   * @example
+   * const 输入内容 = $视图.显示输入对话框("输入", "请输入您的姓名：");
+   * if (输入内容) {
+   *   $打印信息日志(`用户输入了：${输入内容}`);
+   * } else {
+   *   $打印信息日志("用户取消了输入");
+   * }
+   */
+  function 显示输入对话框(标题: 字符串, 消息内容: 字符串): 字符串;
+
+  /**
+   * 显示警告对话框
+   * @param 标题 对话框标题
+   * @param 消息内容 对话框内容
+   * @example
+   * $视图.显示警告对话框("警告", "操作失败，请重试！");
+   */
+  function 显示警告对话框(标题: 字符串, 消息内容: 字符串): 无返回值;
+}

package/types/zh//350/256/276/345/244/207/346/250/241/345/235/227.d.ts

@@ -0,0 +1,106 @@
+/// <reference path="全局模块.d.ts" />
+/**
+ * 设备模块 包含获取设备信息、设备操作等功能
+ */
+declare namespace $设备 {
+  /**
+   * 获取电池信息
+   * @returns 电池信息
+   * @example $设备.获取电池状态()
+   */
+  function 获取电池状态(): {
+    /**
+     * 电池电量
+     */
+    level: number;
+    /**
+     * 是否充电
+     */
+    isCharging: boolean;
+  };
+  /**
+   * 获取设备ID
+   * @returns 设备ID
+   * @example $设备.获取设备ID()
+   */
+  function 获取设备ID(): 字符串;
+  /**
+   * 获取服务器设备ID
+   * @returns 服务器设备ID
+   * @example $设备.获取服务器设备ID()
+   */
+  function 获取服务器设备ID(): 字符串;
+  /**
+   * 获取设备名称
+   * @returns 设备名称
+   * @example $设备.获取设备名称()
+   */
+  function 获取设备名称(): 字符串;
+  /**
+   * 获取设备型号
+   * @returns 设备型号
+   * @example $设备.获取设备型号()
+   */
+  function 获取设备型号(): 字符串;
+  /**
+   * 获取屏幕大小
+   * @returns 屏幕大小
+   * @example $设备.获取屏幕宽高()
+   */
+  function 获取屏幕宽高(): {
+    /**
+     * 屏幕宽度
+     */
+    width: number;
+    /**
+     * 屏幕高度
+     */
+    height: number;
+  };
+  /**
+   * 获取屏幕实际大小
+   * @returns 屏幕实际大小
+   * @example $设备.获取屏幕实际宽高()
+   */
+  function 获取屏幕实际宽高(): {
+    /**
+     * 屏幕宽度
+     */
+    width: number;
+    /**
+     * 屏幕高度
+     */
+    height: number;
+  };
+  /**
+   * 获取屏幕缩放比例
+   * @returns 屏幕缩放比例
+   * @example $设备.获取屏幕缩放比例()
+   */
+  function 获取屏幕缩放比例(): number;
+  /**
+   * 获取设备方向 PORTRAIT 竖屏 LANDSCAPE 横屏
+   * @returns 设备方向
+   * @example $设备.获取设备方向()
+   */
+  function 获取设备方向(): "PORTRAIT" | "LANDSCAPE";
+  /**
+   * 获取系统版本 例如 16.7.11
+   * @returns 系统版本
+   * @example $设备.获取系统版本()
+   */
+  function 获取系统版本(): 字符串;
+  /**
+   * 获取局域网IP 例如 192.168.1.100
+   * @returns 局域网IP
+   * @example $设备.获取局域网IP()
+   */
+  function 获取局域网IP(): 字符串;
+  /**
+   * 振动
+   * @param 持续时间 持续时间 单位毫秒
+   * @param 强度 强度 0.0-1.0
+   * @example $设备.震动(1000, 0.5)
+   */
+  function 震动(持续时间: 数字, 强度: 数字): 无返回值;
+}