assistsx-js 0.0.1353 → 0.0.2002

package/dist/AssistsXAsync.js

@@ -0,0 +1,532 @@
+/**
+ * AssistsX 类
+ * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
+ */
+import { Node } from "./Node";
+import { CallMethod } from "./CallMethod";
+import { CallResponse } from "./CallResponse";
+import { Bounds } from "./Bounds";
+import { generateUUID } from "./Utils";
+import { callbacks } from "./AssistsX";
+export class AssistsXAsync {
+    /**
+     * 执行异步调用
+     * @param method 方法名
+     * @param args 参数对象
+     * @returns Promise<调用响应>
+     */
+    static async asyncCall(method, { args, node, nodes } = {}) {
+        const uuid = generateUUID();
+        const params = {
+            method,
+            arguments: args ? args : undefined,
+            node: node ? node : undefined,
+            nodes: nodes ? nodes : undefined,
+            callbackId: uuid,
+        };
+        const promise = new Promise((resolve) => {
+            callbacks[uuid] = (data) => {
+                resolve(data);
+            };
+            setTimeout(() => {
+                resolve(new CallResponse(0, null, uuid));
+            }, 10000);
+        });
+        const result = window.assistsxAsync.call(JSON.stringify(params));
+        const promiseResult = await promise;
+        if (typeof promiseResult === "string") {
+            const responseData = JSON.parse(promiseResult);
+            const response = new CallResponse(responseData.code, responseData.data, responseData.callbackId);
+            return response;
+        }
+        throw new Error("Call failed");
+    }
+    /**
+     * 设置悬浮窗标志
+     * @param flags 标志
+     * @returns 是否设置成功
+     */
+    static async setOverlayFlags(flags) {
+        const response = await this.asyncCall(CallMethod.setOverlayFlags, {
+            args: { flags: flags },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 设置悬浮窗标志
+     * @param flags 标志
+     * @returns 是否设置成功
+     */
+    static async setOverlayFlagList(flags) {
+        const response = await this.asyncCall(CallMethod.setOverlayFlags, {
+            args: { flags: flags },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
+     */
+    static async getAllNodes({ filterClass, filterViewId, filterDes, filterText, } = {}) {
+        const response = await this.asyncCall(CallMethod.getAllNodes, {
+            args: { filterClass, filterViewId, filterDes, filterText },
+        });
+        return Node.fromJSONArray(response.getDataOrDefault("[]"));
+    }
+    /**
+     * 设置节点文本
+     * @param node 目标节点
+     * @param text 要设置的文本
+     * @returns 是否设置成功
+     */
+    static async setNodeText(node, text) {
+        const response = await this.asyncCall(CallMethod.setNodeText, {
+            args: { text },
+            node,
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 对指定节点进行截图
+     * @param nodes 要截图的节点数组
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径数组
+     */
+    static async takeScreenshotNodes(nodes, overlayHiddenScreenshotDelayMillis = 250) {
+        const response = await this.asyncCall(CallMethod.takeScreenshot, {
+            nodes,
+            args: { overlayHiddenScreenshotDelayMillis },
+        });
+        const data = response.getDataOrDefault("");
+        return data.images;
+    }
+    static async scanQR() {
+        const response = await this.asyncCall(CallMethod.scanQR);
+        const data = response.getDataOrDefault({ value: "" });
+        return data.value;
+    }
+    static async loadWebViewOverlay(url, options = {}) {
+        const { initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, initialCenter, } = options;
+        const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
+            args: {
+                url,
+                initialWidth,
+                initialHeight,
+                minWidth,
+                minHeight,
+                maxWidth,
+                maxHeight,
+                initialCenter,
+            },
+        });
+        const data = response.getDataOrDefault({});
+        return data;
+    }
+    /**
+     * 点击节点
+     * @param node 要点击的节点
+     * @returns 是否点击成功
+     */
+    static async click(node) {
+        const response = await this.asyncCall(CallMethod.click, { node });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 长按节点
+     * @param node 要长按的节点
+     * @returns 是否长按成功
+     */
+    static async longClick(node) {
+        const response = await this.asyncCall(CallMethod.longClick, { node });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 启动应用
+     * @param packageName 应用包名
+     * @returns 是否启动成功
+     */
+    static async launchApp(packageName) {
+        const response = await this.asyncCall(CallMethod.launchApp, {
+            args: { packageName },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 获取当前应用包名
+     * @returns 包名
+     */
+    static async getPackageName() {
+        const response = await this.asyncCall(CallMethod.getPackageName);
+        return response.getDataOrDefault("");
+    }
+    /**
+     * 显示悬浮提示
+     * @param text 提示文本
+     * @param delay 显示时长(毫秒)
+     * @returns 是否显示成功
+     */
+    static async overlayToast(text, delay = 2000) {
+        const response = await this.asyncCall(CallMethod.overlayToast, {
+            args: { text, delay },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @param node 父节点范围
+     * @returns 节点数组
+     */
+    static async findById(id, { filterClass, filterText, filterDes, node, } = {}) {
+        const response = await this.asyncCall(CallMethod.findById, {
+            args: { id, filterClass, filterText, filterDes },
+            node,
+        });
+        return Node.fromJSONArray(response.getDataOrDefault("[]"));
+    }
+    /**
+     * 通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param node 父节点范围
+     * @returns 节点数组
+     */
+    static async findByText(text, { filterClass, filterViewId, filterDes, node, } = {}) {
+        const response = await this.asyncCall(CallMethod.findByText, {
+            args: { text, filterClass, filterViewId, filterDes },
+            node,
+        });
+        return Node.fromJSONArray(response.getDataOrDefault("[]"));
+    }
+    /**
+     * 通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param node 父节点范围
+     * @returns 节点数组
+     */
+    static async findByTags(className, { filterText, filterViewId, filterDes, node, } = {}) {
+        const response = await this.asyncCall(CallMethod.findByTags, {
+            args: { className, filterText, filterViewId, filterDes },
+            node,
+        });
+        return Node.fromJSONArray(response.getDataOrDefault("[]"));
+    }
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @returns 节点数组
+     */
+    static async findByTextAllMatch(text) {
+        const response = await this.asyncCall(CallMethod.findByTextAllMatch, {
+            args: { text },
+        });
+        return Node.fromJSONArray(response.getDataOrDefault("[]"));
+    }
+    /**
+     * 检查是否包含指定文本
+     * @param text 要检查的文本
+     * @returns 是否包含
+     */
+    static async containsText(text) {
+        const response = await this.asyncCall(CallMethod.containsText, {
+            args: { text },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 获取所有文本
+     * @returns 文本数组
+     */
+    static async getAllText() {
+        const response = await this.asyncCall(CallMethod.getAllText);
+        return response.getDataOrDefault("[]");
+    }
+    /**
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
+     */
+    static async findFirstParentByTags(node, className) {
+        const response = await this.asyncCall(CallMethod.findFirstParentByTags, {
+            args: { className },
+            node,
+        });
+        return Node.create(response.getDataOrDefault("{}"));
+    }
+    /**
+     * 获取节点的所有子节点
+     * @param node 父节点
+     * @returns 子节点数组
+     */
+    static async getNodes(node) {
+        const response = await this.asyncCall(CallMethod.getNodes, { node });
+        return Node.fromJSONArray(response.getDataOrDefault("[]"));
+    }
+    /**
+     * 获取节点的直接子节点
+     * @param node 父节点
+     * @returns 子节点数组
+     */
+    static async getChildren(node) {
+        const response = await this.asyncCall(CallMethod.getChildren, { node });
+        return Node.fromJSONArray(response.getDataOrDefault([]));
+    }
+    /**
+     * 查找第一个可点击的父节点
+     * @param node 起始节点
+     * @returns 可点击的父节点
+     */
+    static async findFirstParentClickable(node) {
+        const response = await this.asyncCall(CallMethod.findFirstParentClickable, {
+            node,
+        });
+        return Node.create(response.getDataOrDefault("{}"));
+    }
+    /**
+     * 获取节点在屏幕中的边界
+     * @param node 目标节点
+     * @returns 边界对象
+     */
+    static async getBoundsInScreen(node) {
+        const response = await this.asyncCall(CallMethod.getBoundsInScreen, {
+            node,
+        });
+        return Bounds.fromData(response.getDataOrDefault({}));
+    }
+    /**
+     * 检查节点是否可见
+     * @param node 目标节点
+     * @param compareNode 比较节点
+     * @param isFullyByCompareNode 是否完全可见
+     * @returns 是否可见
+     */
+    static async isVisible(node, { compareNode, isFullyByCompareNode, } = {}) {
+        const response = await this.asyncCall(CallMethod.isVisible, {
+            node,
+            args: { compareNode, isFullyByCompareNode },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 执行点击手势
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param duration 持续时间
+     * @returns 是否成功
+     */
+    static async clickByGesture(x, y, duration) {
+        const response = await this.asyncCall(CallMethod.clickByGesture, {
+            args: { x, y, duration },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 返回操作
+     * @returns 是否成功
+     */
+    static async back() {
+        const response = await this.asyncCall(CallMethod.back);
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 回到主页
+     * @returns 是否成功
+     */
+    static async home() {
+        const response = await this.asyncCall(CallMethod.home);
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 打开通知栏
+     * @returns 是否成功
+     */
+    static async notifications() {
+        const response = await this.asyncCall(CallMethod.notifications);
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 显示最近应用
+     * @returns 是否成功
+     */
+    static async recentApps() {
+        const response = await this.asyncCall(CallMethod.recentApps);
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 在节点中粘贴文本
+     * @param node 目标节点
+     * @param text 要粘贴的文本
+     * @returns 是否成功
+     */
+    static async paste(node, text) {
+        const response = await this.asyncCall(CallMethod.paste, {
+            args: { text },
+            node,
+        });
+        return response.getDataOrDefault(false);
+    }
+    static async focus(node) {
+        const response = await this.asyncCall(CallMethod.focus, { node });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 选择文本
+     * @param node 目标节点
+     * @param selectionStart 选择起始位置
+     * @param selectionEnd 选择结束位置
+     * @returns 是否成功
+     */
+    static async selectionText(node, selectionStart, selectionEnd) {
+        const response = await this.asyncCall(CallMethod.selectionText, {
+            args: { selectionStart, selectionEnd },
+            node,
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 向前滚动
+     * @param node 可滚动节点
+     * @returns 是否成功
+     */
+    static async scrollForward(node) {
+        const response = await this.asyncCall(CallMethod.scrollForward, {
+            node,
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 向后滚动
+     * @param node 可滚动节点
+     * @returns 是否成功
+     */
+    static async scrollBackward(node) {
+        const response = await this.asyncCall(CallMethod.scrollBackward, {
+            node,
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 对节点执行点击手势
+     * @param node 目标节点
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @returns 是否成功
+     */
+    static async clickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, } = {}) {
+        const response = await this.asyncCall(CallMethod.clickNodeByGesture, {
+            node,
+            args: { offsetX, offsetY, switchWindowIntervalDelay, clickDuration },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 对节点执行双击手势
+     * @param node 目标节点
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param clickInterval 点击间隔
+     * @returns 是否成功
+     */
+    static async doubleClickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, } = {}) {
+        const response = await this.asyncCall(CallMethod.doubleClickNodeByGesture, {
+            node,
+            args: {
+                offsetX,
+                offsetY,
+                switchWindowIntervalDelay,
+                clickDuration,
+                clickInterval,
+            },
+        });
+        return response.getDataOrDefault(false);
+    }
+    /**
+     * 执行线型手势
+     * @param startPoint
+     * @param endPoint
+     * @param param2
+     * @returns
+     */
+    static async performLinearGesture(startPoint, endPoint, { duration } = {}) {
+        const response = await this.asyncCall(CallMethod.performLinearGesture, {
+            args: { startPoint, endPoint, duration },
+        });
+        return response.getDataOrDefault(false);
+    }
+    static async longPressNodeByGestureAutoPaste(node, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
+        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, {
+            node,
+            args: {
+                text,
+                matchedPackageName,
+                matchedText,
+                timeoutMillis,
+                longPressDuration,
+            },
+        });
+        return response.getDataOrDefault(false);
+    }
+    static async longPressGestureAutoPaste(point, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
+        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, {
+            args: {
+                point,
+                text,
+                matchedPackageName,
+                matchedText,
+                timeoutMillis,
+                longPressDuration,
+            },
+        });
+        return response.getDataOrDefault(false);
+    }
+    static async getAppInfo(packageName) {
+        const response = await this.asyncCall(CallMethod.getAppInfo, {
+            args: { packageName },
+        });
+        return response.getDataOrDefault({});
+    }
+    static async getUniqueDeviceId() {
+        const response = await this.asyncCall(CallMethod.getUniqueDeviceId);
+        return response.getDataOrDefault("");
+    }
+    static async getAndroidID() {
+        const response = await this.asyncCall(CallMethod.getAndroidID);
+        return response.getDataOrDefault("");
+    }
+    static async getMacAddress() {
+        const response = await this.asyncCall(CallMethod.getMacAddress);
+        return response.getDataOrDefault({});
+    }
+    /**
+     * 获取屏幕尺寸
+     * @returns 屏幕尺寸对象
+     */
+    static async getScreenSize() {
+        const response = await this.asyncCall(CallMethod.getScreenSize);
+        return response.getDataOrDefault("{}");
+    }
+    /**
+     * 获取应用窗口尺寸
+     * @returns 应用窗口尺寸对象
+     */
+    static async getAppScreenSize() {
+        const response = await this.asyncCall(CallMethod.getAppScreenSize);
+        return response.getDataOrDefault("{}");
+    }
+}

package/dist/CallMethod.d.ts

@@ -22,6 +22,7 @@ export declare const CallMethod: {
     readonly notifications: "notifications";
     readonly recentApps: "recentApps";
     readonly paste: "paste";
+    readonly focus: "focus";
     readonly selectionText: "selectionText";
     readonly scrollForward: "scrollForward";
     readonly launchApp: "launchApp";

package/dist/CallMethod.js

@@ -23,6 +23,7 @@ export const CallMethod = {
     notifications: "notifications",
     recentApps: "recentApps",
     paste: "paste",
+    focus: "focus",
     selectionText: "selectionText",
     scrollForward: "scrollForward",
     launchApp: "launchApp",

package/dist/Node.d.ts

@@ -2,7 +2,8 @@
  * 节点类
  * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
  */
-import { Bounds } from './Bounds';
+import { Bounds } from "./Bounds";
+import { NodeAsync } from "./NodeAsync";
 export declare class Node {
     /**
      * 节点唯一标识
@@ -55,6 +56,13 @@ export declare class Node {
         isEnabled: boolean;
         stepId: string | undefined;
     });
+    get async(): NodeAsync;
+    /**
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
+     */
+    findFirstParentByTags(className: string): Node;
     /**
      * 对节点执行点击手势
      * @param offsetX X轴偏移
@@ -63,7 +71,7 @@ export declare class Node {
      * @param clickDuration 点击持续时间
      * @returns 是否点击成功
      */
-    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration }?: {
+    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
         offsetX?: number;
         offsetY?: number;
         switchWindowIntervalDelay?: number;
@@ -78,14 +86,14 @@ export declare class Node {
      * @param clickInterval 点击间隔
      * @returns 是否双击成功
      */
-    doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval }?: {
+    doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, }?: {
         offsetX?: number;
         offsetY?: number;
         switchWindowIntervalDelay?: number;
         clickDuration?: number;
         clickInterval?: number;
     }): Promise<boolean>;
-    longPressNodeByGestureAutoPaste(text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration }?: {
+    longPressNodeByGestureAutoPaste(text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
         matchedPackageName?: string;
         matchedText?: string;
         timeoutMillis?: number;
@@ -99,7 +107,7 @@ export declare class Node {
      * @param filterDes 描述过滤
      * @returns 节点数组
      */
-    findByTags(className: string, { filterText, filterViewId, filterDes }?: {
+    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
         filterText?: string;
         filterViewId?: string;
         filterDes?: string;
@@ -112,7 +120,7 @@ export declare class Node {
      * @param filterDes 描述过滤
      * @returns 节点数组
      */
-    findById(id: string, { filterClass, filterText, filterDes }?: {
+    findById(id: string, { filterClass, filterText, filterDes, }?: {
         filterClass?: string;
         filterText?: string;
         filterDes?: string;
@@ -125,7 +133,7 @@ export declare class Node {
      * @param filterDes 描述过滤
      * @returns 节点数组
      */
-    findByText(text: string, { filterClass, filterViewId, filterDes }?: {
+    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
@@ -146,7 +154,7 @@ export declare class Node {
      * @param isFullyByCompareNode 是否完全可见
      * @returns 是否可见
      */
-    isVisible({ compareNode, isFullyByCompareNode }?: {
+    isVisible({ compareNode, isFullyByCompareNode, }?: {
         compareNode?: Node;
         isFullyByCompareNode?: boolean;
     }): boolean;
@@ -163,6 +171,7 @@ export declare class Node {
      */
     setNodeText(text: string): boolean;
     paste(text: string): boolean;
+    focus(): boolean;
     /**
      * 点击节点
      * @returns 是否点击成功