assistsx-js 0.1.41 → 0.2.0

package/dist/AccessibilityEventFilter.js

@@ -1,89 +0,0 @@
-/**
- * AccessibilityEvent过滤配置类
- * 用于配置AccessibilityEvent的处理方式和过滤条件
- */
-export class AccessibilityEventFilter {
-    constructor(config = {}) {
-        var _a, _b, _c, _d, _e;
-        this.packageName = (_a = config.packageName) !== null && _a !== void 0 ? _a : null;
-        this.processInBackground = (_b = config.processInBackground) !== null && _b !== void 0 ? _b : true;
-        this.fetchNodeInfo = (_c = config.fetchNodeInfo) !== null && _c !== void 0 ? _c : true;
-        this.enableLogging = (_d = config.enableLogging) !== null && _d !== void 0 ? _d : false;
-        this.eventTypes = config.eventTypes;
-        this.enableDeduplication = (_e = config.enableDeduplication) !== null && _e !== void 0 ? _e : false;
-    }
-    /**
-     * 检查是否应该处理指定包的事件
-     * @param targetPackageName 目标包名
-     * @returns true表示应该处理，false表示应该过滤
-     */
-    shouldProcessPackage(targetPackageName) {
-        return this.packageName === null || this.packageName === targetPackageName;
-    }
-    /**
-     * 检查是否应该处理指定类型的事件
-     * @param eventType 事件类型
-     * @returns true表示应该处理，false表示应该过滤
-     */
-    shouldProcessEventType(eventType) {
-        var _a, _b;
-        return (this.eventTypes === null ||
-            ((_b = (_a = this.eventTypes) === null || _a === void 0 ? void 0 : _a.includes(eventType)) !== null && _b !== void 0 ? _b : false));
-    }
-    /**
-     * 创建默认的过滤配置
-     * 所有包名，子线程处理，获取节点信息，启用日志
-     */
-    static createDefault() {
-        return new AccessibilityEventFilter({
-            packageName: null,
-            processInBackground: true,
-            fetchNodeInfo: true,
-            enableLogging: false,
-            eventTypes: null,
-            enableDeduplication: false,
-        });
-    }
-    /**
-     * 创建高性能配置
-     * 不获取节点信息，不启用日志，启用去重
-     */
-    static createHighPerformance() {
-        return new AccessibilityEventFilter({
-            packageName: null,
-            processInBackground: true,
-            fetchNodeInfo: false,
-            enableLogging: false,
-            eventTypes: null,
-            enableDeduplication: true,
-        });
-    }
-    /**
-     * 创建调试配置
-     * 启用所有功能，便于调试
-     */
-    static createDebug() {
-        return new AccessibilityEventFilter({
-            packageName: null,
-            processInBackground: true,
-            fetchNodeInfo: true,
-            enableLogging: true,
-            eventTypes: null,
-            enableDeduplication: false,
-        });
-    }
-    /**
-     * 创建指定包名的过滤配置
-     * @param targetPackageName 目标包名
-     */
-    static createForPackage(targetPackageName) {
-        return new AccessibilityEventFilter({
-            packageName: targetPackageName,
-            processInBackground: true,
-            fetchNodeInfo: true,
-            enableLogging: false,
-            eventTypes: null,
-            enableDeduplication: false,
-        });
-    }
-}

package/dist/AppInfo.d.ts

@@ -1,45 +0,0 @@
-/**
- * 应用信息实体类
- */
-export declare class AppInfo {
-    /**
-     * 是否为系统应用
-     */
-    isSystem: boolean;
-    /**
-     * 最低SDK版本
-     */
-    minSdkVersion: number;
-    /**
-     * 应用名称
-     */
-    name: string;
-    /**
-     * 应用包名
-     */
-    packageName: string;
-    /**
-     * 目标SDK版本
-     */
-    targetSdkVersion: number;
-    /**
-     * 版本号
-     */
-    versionCode: number;
-    /**
-     * 版本名称
-     */
-    versionName: string;
-    constructor(isSystem?: boolean, minSdkVersion?: number, name?: string, packageName?: string, targetSdkVersion?: number, versionCode?: number, versionName?: string);
-    /**
-     * 从JSON对象创建AppInfo实例
-     * @param data JSON对象
-     * @returns AppInfo实例
-     */
-    static fromJSON(data: any): AppInfo;
-    /**
-     * 转换为JSON对象
-     * @returns JSON对象
-     */
-    toJSON(): any;
-}

package/dist/AppInfo.js

@@ -1,38 +0,0 @@
-/**
- * 应用信息实体类
- */
-export class AppInfo {
-    constructor(isSystem = false, minSdkVersion = 0, name = "", packageName = "", targetSdkVersion = 0, versionCode = 0, versionName = "") {
-        this.isSystem = isSystem;
-        this.minSdkVersion = minSdkVersion;
-        this.name = name;
-        this.packageName = packageName;
-        this.targetSdkVersion = targetSdkVersion;
-        this.versionCode = versionCode;
-        this.versionName = versionName;
-    }
-    /**
-     * 从JSON对象创建AppInfo实例
-     * @param data JSON对象
-     * @returns AppInfo实例
-     */
-    static fromJSON(data) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        return new AppInfo((_a = data.isSystem) !== null && _a !== void 0 ? _a : false, (_b = data.minSdkVersion) !== null && _b !== void 0 ? _b : 0, (_c = data.name) !== null && _c !== void 0 ? _c : "", (_d = data.packageName) !== null && _d !== void 0 ? _d : "", (_e = data.targetSdkVersion) !== null && _e !== void 0 ? _e : 0, (_f = data.versionCode) !== null && _f !== void 0 ? _f : 0, (_g = data.versionName) !== null && _g !== void 0 ? _g : "");
-    }
-    /**
-     * 转换为JSON对象
-     * @returns JSON对象
-     */
-    toJSON() {
-        return {
-            isSystem: this.isSystem,
-            minSdkVersion: this.minSdkVersion,
-            name: this.name,
-            packageName: this.packageName,
-            targetSdkVersion: this.targetSdkVersion,
-            versionCode: this.versionCode,
-            versionName: this.versionName,
-        };
-    }
-}

package/dist/AssistsX.d.ts

@@ -1,484 +0,0 @@
-/**
- * AssistsX 类
- * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
- */
-import { Node } from "./Node";
-import { CallResponse } from "./CallResponse";
-import { Bounds } from "./Bounds";
-import { AccessibilityEventFilter } from "AccessibilityEventFilter";
-import { AppInfo } from "./AppInfo";
-import { DeviceInfo } from "./DeviceInfo";
-/**
- * 无障碍事件数据结构
- */
-export interface AccessibilityEventData {
-    packageName: string;
-    className: string;
-    eventType: number;
-    action: number;
-    texts: string[];
-    node: Node | null;
-}
-/**
- * 无障碍事件完整结构
- */
-export interface AccessibilityEvent {
-    callbackId: string;
-    code: number;
-    data: AccessibilityEventData;
-    message: string;
-}
-/**
- * 无障碍事件监听器类型
- */
-export type AccessibilityEventListener = (event: AccessibilityEvent) => void;
-/**
- * Web浮动窗口选项接口定义
- */
-export interface WebFloatingWindowOptions {
-    initialWidth?: number;
-    initialHeight?: number;
-    /** Initial window X position (default 0) */
-    initialX?: number;
-    /** Initial window Y position (default 0) */
-    initialY?: number;
-    minWidth?: number;
-    minHeight?: number;
-    maxWidth?: number;
-    maxHeight?: number;
-    initialCenter?: boolean;
-    /** Whether to show top operation area (title bar, close button, etc.) */
-    showTopOperationArea?: boolean;
-    /** Whether to show bottom operation area (zoom, back/forward/refresh, etc.) */
-    showBottomOperationArea?: boolean;
-    /** Background color: hex string (e.g. "#ffffff") or Android color int */
-    backgroundColor?: string | number;
-}
-export declare const callbacks: Map<string, (data: string) => void>;
-export declare const accessibilityEventListeners: AccessibilityEventListener[];
-/**
- * 屏幕尺寸类型（width/height 为整型像素值）
- */
-export interface Screen {
-    width: number;
-    height: number;
-}
-/** 全局屏幕尺寸，在 assistsxCallback 初始化后自动加载 */
-export declare let screen: Screen | null;
-export declare class AssistsX {
-    /**
-     * 屏幕尺寸（与全局变量 screen 同源）
-     * @deprecated 已过时，请使用全局变量 {@link screen}
-     */
-    static get screenSize(): any;
-    /**
-     * 执行同步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @returns 调用响应
-     */
-    static call(method: string, { args, node }?: {
-        args?: any;
-        node?: Node;
-    }): CallResponse;
-    /**
-     * 执行异步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<调用响应>
-     */
-    static asyncCall(method: string, { args, node, nodes, timeout, }?: {
-        args?: any;
-        node?: Node;
-        nodes?: Node[];
-        timeout?: number;
-    }): Promise<CallResponse>;
-    /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @returns 是否设置成功
-     */
-    static setOverlayFlags(flags: number): boolean;
-    /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @returns 是否设置成功
-     */
-    static setOverlayFlagList(flags: number[]): boolean;
-    /**
-     * 获取所有符合条件的节点
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param filterText 文本过滤
-     * @returns 节点数组
-     */
-    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        filterText?: string;
-    }): Node[];
-    /**
-     * 设置节点文本
-     * @param node 目标节点
-     * @param text 要设置的文本
-     * @returns 是否设置成功
-     */
-    static setNodeText(node: Node, text: string): boolean;
-    /**
-     * 获取剪贴板最新文本
-     * @returns 剪贴板最新文本
-     */
-    static getClipboardLatestText(): any;
-    /**
-     * 获取剪贴板文本内容（异步）
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 剪贴板文本内容，如果获取失败则返回空字符串
-     */
-    static getClipboardText(timeout?: number): Promise<string>;
-    /**
-     * 在浏览器中打开URL
-     * @param url 要打开的URL
-     * @returns 是否成功打开
-     */
-    static openUrlInBrowser(url: string): boolean;
-    /**
-     * 保持屏幕常亮
-     * @param tip 提示文本
-     * @returns 是否保持屏幕常亮成功
-     */
-    static keepScreenOn(tip?: string): boolean;
-    static clearKeepScreenOn(): boolean;
-    static isAppInstalled(packageName: string): boolean;
-    /**
-     * 对指定节点进行截图
-     * @param nodes 要截图的节点数组
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 截图路径数组
-     */
-    static takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number, timeout?: number): Promise<string[]>;
-    static scanQR(timeout?: number): Promise<string>;
-    static loadWebViewOverlay(url: string, options?: WebFloatingWindowOptions & {
-        timeout?: number;
-    }): Promise<any>;
-    /**
-     * 点击节点
-     * @param node 要点击的节点
-     * @returns 是否点击成功
-     */
-    static click(node: Node): boolean;
-    /**
-     * 长按节点
-     * @param node 要长按的节点
-     * @returns 是否长按成功
-     */
-    static longClick(node: Node): boolean;
-    /**
-     * 启动应用
-     * @param packageName 应用包名
-     * @returns 是否启动成功
-     */
-    static launchApp(packageName: string): boolean;
-    /**
-     * 获取当前应用包名
-     * @returns 包名
-     */
-    static getPackageName(): string;
-    /**
-     * 显示悬浮提示
-     * @param text 提示文本
-     * @param delay 显示时长(毫秒)
-     * @returns 是否显示成功
-     */
-    static overlayToast(text: string, delay?: number): boolean;
-    /**
-     * 通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @returns 节点数组
-     */
-    static findById(id: string, { filterClass, filterText, filterDes, node, }?: {
-        filterClass?: string;
-        filterText?: string;
-        filterDes?: string;
-        node?: Node;
-    }): Node[];
-    /**
-     * 通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @returns 节点数组
-     */
-    static findByText(text: string, { filterClass, filterViewId, filterDes, node, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        node?: Node;
-    }): Node[];
-    /**
-     * 通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @returns 节点数组
-     */
-    static findByTags(className: string, { filterText, filterViewId, filterDes, node, }?: {
-        filterText?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        node?: Node;
-    }): Node[];
-    /**
-     * 查找所有匹配文本的节点
-     * @param text 要查找的文本
-     * @returns 节点数组
-     */
-    static findByTextAllMatch(text: string): Node[];
-    /**
-     * 检查是否包含指定文本
-     * @param text 要检查的文本
-     * @returns 是否包含
-     */
-    static containsText(text: string): boolean;
-    /**
-     * 获取所有文本
-     * @returns 文本数组
-     */
-    static getAllText(): string[];
-    /**
-     * 查找第一个匹配标签的父节点
-     * @param className 类名
-     * @returns 父节点
-     */
-    static findFirstParentByTags(node: Node, className: string): Node;
-    /**
-     * 获取节点的所有子节点
-     * @param node 父节点
-     * @returns 子节点数组
-     */
-    static getNodes(node: Node): Node[];
-    /**
-     * 获取节点的直接子节点
-     * @param node 父节点
-     * @returns 子节点数组
-     */
-    static getChildren(node: Node): Node[];
-    /**
-     * 查找第一个可点击的父节点
-     * @param node 起始节点
-     * @returns 可点击的父节点
-     */
-    static findFirstParentClickable(node: Node): Node;
-    /**
-     * 获取节点在屏幕中的边界
-     * @param node 目标节点
-     * @returns 边界对象
-     */
-    static getBoundsInScreen(node: Node): Bounds;
-    /**
-     * 检查节点是否可见
-     * @param node 目标节点
-     * @param compareNode 比较节点
-     * @param isFullyByCompareNode 是否完全可见
-     * @returns 是否可见
-     */
-    static isVisible(node: Node, { compareNode, isFullyByCompareNode, }?: {
-        compareNode?: Node;
-        isFullyByCompareNode?: boolean;
-    }): boolean;
-    /**
-     * 执行点击手势
-     * @param x 横坐标
-     * @param y 纵坐标
-     * @param duration 持续时间
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static clickByGesture(x: number, y: number, duration: number, timeout?: number): Promise<boolean>;
-    /**
-     * 返回操作
-     * @returns 是否成功
-     */
-    static back(): boolean;
-    /**
-     * 回到主页
-     * @returns 是否成功
-     */
-    static home(): boolean;
-    /**
-     * 打开通知栏
-     * @returns 是否成功
-     */
-    static notifications(): boolean;
-    /**
-     * 显示最近应用
-     * @returns 是否成功
-     */
-    static recentApps(): boolean;
-    /**
-     * 在节点中粘贴文本
-     * @param node 目标节点
-     * @param text 要粘贴的文本
-     * @returns 是否成功
-     */
-    static paste(node: Node, text: string): boolean;
-    static focus(node: Node): boolean;
-    /**
-     * 选择文本
-     * @param node 目标节点
-     * @param selectionStart 选择起始位置
-     * @param selectionEnd 选择结束位置
-     * @returns 是否成功
-     */
-    static selectionText(node: Node, selectionStart: number, selectionEnd: number): boolean;
-    /**
-     * 向前滚动
-     * @param node 可滚动节点
-     * @returns 是否成功
-     */
-    static scrollForward(node: Node): boolean;
-    /**
-     * 向后滚动
-     * @param node 可滚动节点
-     * @returns 是否成功
-     */
-    static scrollBackward(node: Node): boolean;
-    /**
-     * 对节点执行点击手势
-     * @param node 目标节点
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static clickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, timeout, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * 对节点执行双击手势
-     * @param node 目标节点
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param clickInterval 点击间隔
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static doubleClickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, timeout, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-        clickInterval?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * 执行线型手势
-     * @param startPoint
-     * @param endPoint
-     * @param param2
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns
-     */
-    static performLinearGesture(startPoint: {
-        x: number;
-        y: number;
-    }, endPoint: {
-        x: number;
-        y: number;
-    }, { duration, timeout }?: {
-        duration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static longPressNodeByGestureAutoPaste(node: Node, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static longPressGestureAutoPaste(point: {
-        x: number;
-        y: number;
-    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static getAppInfo(packageName: string, timeout?: number): Promise<AppInfo>;
-    static getUniqueDeviceId(): any;
-    static getAndroidID(): any;
-    static getMacAddress(timeout?: number): Promise<any>;
-    static getDeviceInfo(timeout?: number): Promise<DeviceInfo>;
-    static getNetworkType(timeout?: number): Promise<any>;
-    /**
-     * 播放系统电话铃声
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 播放结果消息
-     */
-    static audioPlayRingtone(timeout?: number): Promise<string>;
-    /**
-     * 停止播放系统电话铃声
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 停止结果消息
-     */
-    static audioStopRingtone(timeout?: number): Promise<string>;
-    static setAccessibilityEventFilters(value: AccessibilityEventFilter[]): Promise<any>;
-    static addAccessibilityEventFilter(value: AccessibilityEventFilter): Promise<any>;
-    /**
-     * 获取屏幕尺寸
-     * @returns 屏幕尺寸对象（width, height）
-     */
-    static getScreenSize(): Screen | null;
-    /**
-     * 获取应用窗口尺寸
-     * @returns 应用窗口尺寸对象
-     */
-    static getAppScreenSize(): any;
-    /**
-     * 添加无障碍事件监听器
-     * @param listener 监听器函数
-     */
-    static addAccessibilityEventListener(listener: AccessibilityEventListener): void;
-    /**
-     * 判断是否包含无障碍事件监听器
-     * @param listener 监听器函数
-     * @returns 是否包含
-     */
-    static containsAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
-    /**
-     * 移除无障碍事件监听器
-     * @param listener 要移除的监听器函数
-     * @returns 是否移除成功
-     */
-    static removeAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
-    /**
-     * 移除所有无障碍事件监听器
-     */
-    static removeAllAccessibilityEventListeners(): void;
-    /**
-     * 获取当前注册的无障碍事件监听器数量
-     * @returns 监听器数量
-     */
-    static getAccessibilityEventListenerCount(): number;
-}