assistsx-js 0.1.41 → 0.2.0

package/dist/AssistsXAsync.js

@@ -1,874 +0,0 @@
-/**
- * AssistsX 类
- * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
- */
-import { Node } from "./Node";
-import { CallMethod } from "./CallMethod";
-import { CallResponse } from "./CallResponse";
-import { Bounds } from "./Bounds";
-import { generateUUID } from "./Utils";
-import { AppInfo } from "./AppInfo";
-import { DeviceInfo } from "./DeviceInfo";
-import { callbacks, } from "./AssistsX";
-export class AssistsXAsync {
-    /**
-     * 执行异步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<调用响应>
-     */
-    static async asyncCall(method, { args, node, nodes, timeout = 30, } = {}) {
-        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.set(uuid, (data) => {
-                resolve(data);
-            });
-            setTimeout(() => {
-                // 超时后删除回调函数
-                callbacks.delete(uuid);
-                resolve(new CallResponse(0, null, uuid));
-            }, timeout * 1000);
-        });
-        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 标志
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否设置成功
-     */
-    static async setOverlayFlags(flags, timeout) {
-        const response = await this.asyncCall(CallMethod.setOverlayFlags, {
-            args: { flags: flags },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否设置成功
-     */
-    static async setOverlayFlagList(flags, timeout) {
-        const response = await this.asyncCall(CallMethod.setOverlayFlags, {
-            args: { flags: flags },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 获取所有符合条件的节点
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param filterText 文本过滤
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 节点数组
-     */
-    static async getAllNodes({ filterClass, filterViewId, filterDes, filterText, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.getAllNodes, {
-            args: { filterClass, filterViewId, filterDes, filterText },
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.getAllNodes: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 设置节点文本
-     * @param node 目标节点
-     * @param text 要设置的文本
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否设置成功
-     */
-    static async setNodeText(node, text, timeout) {
-        const response = await this.asyncCall(CallMethod.setNodeText, {
-            args: { text },
-            node,
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 对指定节点进行截图
-     * @param nodes 要截图的节点数组
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 截图路径数组
-     */
-    static async takeScreenshotNodes(nodes, overlayHiddenScreenshotDelayMillis = 250, timeout) {
-        const response = await this.asyncCall(CallMethod.takeScreenshot, {
-            nodes,
-            args: { overlayHiddenScreenshotDelayMillis },
-            timeout,
-        });
-        const data = response.getDataOrDefault({ images: [] });
-        return data.images;
-    }
-    /**
-     * 保存全屏截图到文件
-     * @param options 截图保存选项
-     * @param options.filePath 文件路径（可选，不提供则自动生成）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
-     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns 保存的文件路径
-     */
-    static async takeScreenshotSave(options = {}) {
-        const { filePath, format = "PNG", overlayHiddenScreenshotDelayMillis = 250, timeout, } = options;
-        const response = await this.asyncCall(CallMethod.takeScreenshotSave, {
-            args: {
-                filePath,
-                format,
-                overlayHiddenScreenshotDelayMillis,
-            },
-            timeout,
-        });
-        const data = response.getDataOrDefault({ file: "" });
-        return data.file;
-    }
-    /**
-     * 保存截图到文件（支持多个节点）
-     * @param options 截图保存选项
-     * @param options.nodes 要截图的节点数组（可选，不提供则保存全屏截图）
-     * @param options.filePath 文件路径（可选，不提供则自动生成。多个节点时会自动添加索引后缀）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
-     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns 保存的文件路径数组
-     */
-    static async takeScreenshotToFile(options = {}) {
-        const { nodes, filePath, format = "PNG", overlayHiddenScreenshotDelayMillis = 250, timeout, } = options;
-        const response = await this.asyncCall(CallMethod.takeScreenshotToFile, {
-            nodes,
-            args: {
-                filePath,
-                format,
-                overlayHiddenScreenshotDelayMillis,
-            },
-            timeout,
-        });
-        const data = response.getDataOrDefault({ files: [] });
-        if (!Array.isArray(data.files)) {
-            throw new Error(`AssistsXAsync.takeScreenshotToFile: Expected files array, but got ${typeof data.files}. ` +
-                `Value: ${JSON.stringify(data.files)}`);
-        }
-        return data.files;
-    }
-    /**
-     * 截图识别文本
-     * @param param0 识别参数
-     * @returns 截图识别结果
-     */
-    static async recognizeTextInScreenshot(targetText, options = {}) {
-        const { rotationDegrees = 0, overlayHiddenScreenshotDelayMillis = 250, restoreOverlay = true, region, timeout, } = options;
-        const response = await this.asyncCall(CallMethod.recognizeTextInScreenshot, {
-            args: {
-                targetText,
-                rotationDegrees,
-                overlayHiddenScreenshotDelayMillis,
-                restoreOverlay,
-                region,
-            },
-            timeout,
-        });
-        return response.getDataOrDefault({
-            fullText: "",
-            processingTimeMillis: 0,
-            positions: [],
-        });
-    }
-    static async scanQR(timeout) {
-        const response = await this.asyncCall(CallMethod.scanQR, { timeout });
-        const data = response.getDataOrDefault({ value: "" });
-        return data.value;
-    }
-    static async loadWebViewOverlay(url, options = {}) {
-        const { initialWidth, initialHeight, initialX, initialY, minWidth, minHeight, maxWidth, maxHeight, initialCenter, showTopOperationArea, showBottomOperationArea, backgroundColor, timeout, } = options;
-        const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
-            args: {
-                url,
-                initialWidth,
-                initialHeight,
-                initialX,
-                initialY,
-                minWidth,
-                minHeight,
-                maxWidth,
-                maxHeight,
-                initialCenter,
-                showTopOperationArea,
-                showBottomOperationArea,
-                backgroundColor,
-            },
-            timeout,
-        });
-        const data = response.getDataOrDefault({});
-        return data;
-    }
-    /**
-     * 关闭当前 WebView 悬浮窗
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否关闭成功（当前页面在悬浮窗内时返回 true，否则 false）
-     */
-    static async closeOverlay(timeout) {
-        const response = await this.asyncCall(CallMethod.closeOverlay, {
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 点击节点
-     * @param node 要点击的节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否点击成功
-     */
-    static async click(node, timeout) {
-        const response = await this.asyncCall(CallMethod.click, { node, timeout });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 长按节点
-     * @param node 要长按的节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否长按成功
-     */
-    static async longClick(node, timeout) {
-        const response = await this.asyncCall(CallMethod.longClick, {
-            node,
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 启动应用
-     * @param packageName 应用包名
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否启动成功
-     */
-    static async launchApp(packageName, timeout) {
-        const response = await this.asyncCall(CallMethod.launchApp, {
-            args: { packageName },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 获取当前应用包名
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 包名
-     */
-    static async getPackageName(timeout) {
-        const response = await this.asyncCall(CallMethod.getPackageName, {
-            timeout,
-        });
-        return response.getDataOrDefault("");
-    }
-    /**
-     * 显示悬浮提示
-     * @param text 提示文本
-     * @param delay 显示时长(毫秒)
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否显示成功
-     */
-    static async overlayToast(text, delay = 2000, timeout) {
-        const response = await this.asyncCall(CallMethod.overlayToast, {
-            args: { text, delay },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 节点数组
-     */
-    static async findById(id, { filterClass, filterText, filterDes, node, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.findById, {
-            args: { id, filterClass, filterText, filterDes },
-            node,
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.findById: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 节点数组
-     */
-    static async findByText(text, { filterClass, filterViewId, filterDes, node, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.findByText, {
-            args: { text, filterClass, filterViewId, filterDes },
-            node,
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.findByText: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 节点数组
-     */
-    static async findByTags(className, { filterText, filterViewId, filterDes, node, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.findByTags, {
-            args: { className, filterText, filterViewId, filterDes },
-            node,
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.findByTags: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 查找所有匹配文本的节点
-     * @param text 要查找的文本
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 节点数组
-     */
-    static async findByTextAllMatch(text, timeout) {
-        const response = await this.asyncCall(CallMethod.findByTextAllMatch, {
-            args: { text },
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.findByTextAllMatch: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 检查是否包含指定文本
-     * @param text 要检查的文本
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否包含
-     */
-    static async containsText(text, timeout) {
-        const response = await this.asyncCall(CallMethod.containsText, {
-            args: { text },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 获取所有文本
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 文本数组
-     */
-    static async getAllText(timeout) {
-        const response = await this.asyncCall(CallMethod.getAllText, { timeout });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.getAllText: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return data;
-    }
-    /**
-     * 查找第一个匹配标签的父节点
-     * @param className 类名
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 父节点
-     */
-    static async findFirstParentByTags(node, className, timeout) {
-        const response = await this.asyncCall(CallMethod.findFirstParentByTags, {
-            args: { className },
-            node,
-            timeout,
-        });
-        return Node.create(response.getDataOrDefault({}));
-    }
-    /**
-     * 获取节点的所有子节点
-     * @param node 父节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 子节点数组
-     */
-    static async getNodes(node, timeout) {
-        const response = await this.asyncCall(CallMethod.getNodes, {
-            node,
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.getNodes: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 获取节点的直接子节点
-     * @param node 父节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 子节点数组
-     */
-    static async getChildren(node, timeout) {
-        const response = await this.asyncCall(CallMethod.getChildren, {
-            node,
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.getChildren: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return Node.fromJSONArray(data);
-    }
-    /**
-     * 查找第一个可点击的父节点
-     * @param node 起始节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 可点击的父节点
-     */
-    static async findFirstParentClickable(node, timeout) {
-        const response = await this.asyncCall(CallMethod.findFirstParentClickable, {
-            node,
-            timeout,
-        });
-        return Node.create(response.getDataOrDefault({}));
-    }
-    /**
-     * 获取节点在屏幕中的边界
-     * @param node 目标节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 边界对象
-     */
-    static async getBoundsInScreen(node, timeout) {
-        const response = await this.asyncCall(CallMethod.getBoundsInScreen, {
-            node,
-            timeout,
-        });
-        return Bounds.fromData(response.getDataOrDefault({}));
-    }
-    /**
-     * 检查节点是否可见
-     * @param node 目标节点
-     * @param compareNode 比较节点
-     * @param isFullyByCompareNode 是否完全可见
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否可见
-     */
-    static async isVisible(node, { compareNode, isFullyByCompareNode, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.isVisible, {
-            node,
-            args: { compareNode, isFullyByCompareNode },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 执行点击手势
-     * @param x 横坐标
-     * @param y 纵坐标
-     * @param duration 持续时间
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async clickByGesture(x, y, duration, timeout) {
-        const response = await this.asyncCall(CallMethod.clickByGesture, {
-            args: { x, y, duration },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 返回操作
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async back(timeout) {
-        const response = await this.asyncCall(CallMethod.back, { timeout });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 回到主页
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async home(timeout) {
-        const response = await this.asyncCall(CallMethod.home, { timeout });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 打开通知栏
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async notifications(timeout) {
-        const response = await this.asyncCall(CallMethod.notifications, {
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 显示最近应用
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async recentApps(timeout) {
-        const response = await this.asyncCall(CallMethod.recentApps, { timeout });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 在节点中粘贴文本
-     * @param node 目标节点
-     * @param text 要粘贴的文本
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async paste(node, text, timeout) {
-        const response = await this.asyncCall(CallMethod.paste, {
-            args: { text },
-            node,
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    static async focus(node, timeout) {
-        const response = await this.asyncCall(CallMethod.focus, { node, timeout });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 选择文本
-     * @param node 目标节点
-     * @param selectionStart 选择起始位置
-     * @param selectionEnd 选择结束位置
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async selectionText(node, selectionStart, selectionEnd, timeout) {
-        const response = await this.asyncCall(CallMethod.selectionText, {
-            args: { selectionStart, selectionEnd },
-            node,
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 向前滚动
-     * @param node 可滚动节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async scrollForward(node, timeout) {
-        const response = await this.asyncCall(CallMethod.scrollForward, {
-            node,
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 向后滚动
-     * @param node 可滚动节点
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async scrollBackward(node, timeout) {
-        const response = await this.asyncCall(CallMethod.scrollBackward, {
-            node,
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 对节点执行点击手势
-     * @param node 目标节点
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async clickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.clickNodeByGesture, {
-            node,
-            args: { offsetX, offsetY, switchWindowIntervalDelay, clickDuration },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 对节点执行双击手势
-     * @param node 目标节点
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param clickInterval 点击间隔
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static async doubleClickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, timeout, } = {}) {
-        const response = await this.asyncCall(CallMethod.doubleClickNodeByGesture, {
-            node,
-            args: {
-                offsetX,
-                offsetY,
-                switchWindowIntervalDelay,
-                clickDuration,
-                clickInterval,
-            },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 执行线型手势
-     * @param startPoint
-     * @param endPoint
-     * @param param2
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns
-     */
-    static async performLinearGesture(startPoint, endPoint, { duration, timeout } = {}) {
-        const response = await this.asyncCall(CallMethod.performLinearGesture, {
-            args: { startPoint, endPoint, duration },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    static async longPressNodeByGestureAutoPaste(node, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
-        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, {
-            node,
-            args: {
-                text,
-                matchedPackageName,
-                matchedText,
-                timeoutMillis,
-                longPressDuration,
-            },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    static async longPressGestureAutoPaste(point, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
-        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, {
-            args: {
-                point,
-                text,
-                matchedPackageName,
-                matchedText,
-                timeoutMillis,
-                longPressDuration,
-            },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    static async getAppInfo(packageName, timeout) {
-        const response = await this.asyncCall(CallMethod.getAppInfo, {
-            args: { packageName },
-            timeout,
-        });
-        return AppInfo.fromJSON(response.getDataOrDefault({}));
-    }
-    static async getUniqueDeviceId(timeout) {
-        const response = await this.asyncCall(CallMethod.getUniqueDeviceId, {
-            timeout,
-        });
-        return response.getDataOrDefault("");
-    }
-    static async getAndroidID(timeout) {
-        const response = await this.asyncCall(CallMethod.getAndroidID, { timeout });
-        return response.getDataOrDefault("");
-    }
-    static async getMacAddress(timeout) {
-        const response = await this.asyncCall(CallMethod.getMacAddress, {
-            timeout,
-        });
-        return response.getDataOrDefault({});
-    }
-    static async getDeviceInfo(timeout) {
-        const response = await this.asyncCall(CallMethod.getDeviceInfo, {
-            timeout,
-        });
-        return DeviceInfo.fromJSON(response.getDataOrDefault({}));
-    }
-    /**
-     * 获取屏幕尺寸
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 屏幕尺寸对象
-     */
-    static async getScreenSize(timeout) {
-        const response = await this.asyncCall(CallMethod.getScreenSize, {
-            timeout,
-        });
-        return response.getDataOrDefault({});
-    }
-    /**
-     * 获取应用窗口尺寸
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 应用窗口尺寸对象
-     */
-    static async getAppScreenSize(timeout) {
-        const response = await this.asyncCall(CallMethod.getAppScreenSize, {
-            timeout,
-        });
-        return response.getDataOrDefault({});
-    }
-    /**
-     * 在浏览器中打开URL
-     * @param url 要打开的URL
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功打开
-     */
-    static async openUrlInBrowser(url, timeout) {
-        const response = await this.asyncCall(CallMethod.openUrlInBrowser, {
-            args: { url },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    static async download(url, timeout) {
-        const response = await this.asyncCall(CallMethod.download, {
-            args: { url },
-            timeout,
-        });
-        return response.getDataOrDefault(null);
-    }
-    static async audioPlayFromFile(filePath, { volume = undefined, useAbsoluteVolume = false, timeout = 30, }) {
-        const response = await this.asyncCall(CallMethod.audioPlayFromFile, {
-            args: { filePath, volume, useAbsoluteVolume },
-            timeout,
-        });
-        return response.getDataOrDefault(null);
-    }
-    static async audioStop({ timeout = 30, }) {
-        const response = await this.asyncCall(CallMethod.audioStop, {
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 播放系统电话铃声
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 播放结果消息
-     */
-    static async audioPlayRingtone({ timeout = 30, }) {
-        const response = await this.asyncCall(CallMethod.audioPlayRingtone, {
-            timeout,
-        });
-        return response.getDataOrDefault("");
-    }
-    /**
-     * 停止播放系统电话铃声
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 停止结果消息
-     */
-    static async audioStopRingtone({ timeout = 30, }) {
-        const response = await this.asyncCall(CallMethod.audioStopRingtone, {
-            timeout,
-        });
-        return response.getDataOrDefault("");
-    }
-    /**
-     * 添加联系人
-     * @param name 联系人姓名（必填）
-     * @param phoneNumber 电话号码（必填）
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否添加成功
-     */
-    static async addContact(name, phoneNumber, timeout) {
-        const response = await this.asyncCall(CallMethod.addContact, {
-            args: { name, phoneNumber },
-            timeout,
-        });
-        return response.getDataOrDefault(false);
-    }
-    /**
-     * 获取所有联系人
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 联系人列表
-     */
-    static async getAllContacts(timeout) {
-        const response = await this.asyncCall(CallMethod.getAllContacts, {
-            timeout,
-        });
-        const data = response.getDataOrDefault([]);
-        if (!Array.isArray(data)) {
-            throw new Error(`AssistsXAsync.getAllContacts: Expected array, but got ${typeof data}. ` +
-                `Value: ${JSON.stringify(data)}`);
-        }
-        return data;
-    }
-    /**
-     * 保存根节点树为JSON文件
-     * @param options 保存选项
-     * @param options.filePath 文件路径（可选，不提供则自动生成）
-     * @param options.prettyPrint 是否格式化输出，默认为 true
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns 保存的文件路径
-     */
-    static async saveRootNodeTreeJson(options = {}) {
-        const { filePath, prettyPrint = true, timeout, } = options;
-        const response = await this.asyncCall(CallMethod.saveRootNodeTreeJson, {
-            args: {
-                filePath,
-                prettyPrint,
-            },
-            timeout,
-        });
-        const data = response.getDataOrDefault({ file: "" });
-        return data.file;
-    }
-    /**
-     * 获取剪贴板文本内容
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 剪贴板文本内容，如果获取失败则返回空字符串
-     */
-    static async getClipboardText(timeout) {
-        const response = await this.asyncCall(CallMethod.getClipboardText, {
-            timeout,
-        });
-        const data = response.getDataOrDefault({ text: "" });
-        return data.text || "";
-    }
-}