assistsx-js 0.0.2013 → 0.0.2015

package/dist/AccessibilityEventFilter.d.ts

@@ -0,0 +1,105 @@
+/**
+ * AccessibilityEvent过滤配置接口
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+export interface AccessibilityEventFilterConfig {
+    /**
+     * 包名过滤
+     * 如果为空或null，则处理所有包的事件
+     * 如果指定包名，则只处理该包的事件
+     */
+    packageName?: string | null;
+    /**
+     * 是否在子线程中处理AccessibilityEvent
+     * true: 在子线程中处理，避免阻塞主线程
+     * false: 在主线程中处理
+     */
+    processInBackground?: boolean;
+    /**
+     * 是否获取节点信息
+     * true: 获取并解析AccessibilityNodeInfo节点信息
+     * false: 不获取节点信息，提高处理性能
+     */
+    fetchNodeInfo?: boolean;
+    /**
+     * 是否启用日志输出
+     * true: 输出AccessibilityEvent处理日志
+     * false: 不输出日志
+     */
+    enableLogging?: boolean;
+    /**
+     * 事件类型过滤
+     * 如果为空，则处理所有类型的事件
+     * 如果指定类型，则只处理指定类型的事件
+     */
+    eventTypes?: Set<number> | null;
+    /**
+     * 是否启用事件去重
+     * true: 启用去重，避免重复处理相同事件
+     * false: 不启用去重
+     */
+    enableDeduplication?: boolean;
+}
+/**
+ * AccessibilityEvent过滤配置类
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+export declare class AccessibilityEventFilter {
+    /**
+     * 包名过滤
+     */
+    readonly packageName: string | null;
+    /**
+     * 是否在子线程中处理AccessibilityEvent
+     */
+    readonly processInBackground: boolean;
+    /**
+     * 是否获取节点信息
+     */
+    readonly fetchNodeInfo: boolean;
+    /**
+     * 是否启用日志输出
+     */
+    readonly enableLogging: boolean;
+    /**
+     * 事件类型过滤
+     */
+    readonly eventTypes: Set<number> | null;
+    /**
+     * 是否启用事件去重
+     */
+    readonly enableDeduplication: boolean;
+    constructor(config?: AccessibilityEventFilterConfig);
+    /**
+     * 检查是否应该处理指定包的事件
+     * @param targetPackageName 目标包名
+     * @returns true表示应该处理，false表示应该过滤
+     */
+    shouldProcessPackage(targetPackageName: string | null): boolean;
+    /**
+     * 检查是否应该处理指定类型的事件
+     * @param eventType 事件类型
+     * @returns true表示应该处理，false表示应该过滤
+     */
+    shouldProcessEventType(eventType: number): boolean;
+    /**
+     * 创建默认的过滤配置
+     * 所有包名，子线程处理，获取节点信息，启用日志
+     */
+    static createDefault(): AccessibilityEventFilter;
+    /**
+     * 创建高性能配置
+     * 不获取节点信息，不启用日志，启用去重
+     */
+    static createHighPerformance(): AccessibilityEventFilter;
+    /**
+     * 创建调试配置
+     * 启用所有功能，便于调试
+     */
+    static createDebug(): AccessibilityEventFilter;
+    /**
+     * 创建指定包名的过滤配置
+     * @param targetPackageName 目标包名
+     */
+    static createForPackage(targetPackageName: string): AccessibilityEventFilter;
+}

package/dist/AccessibilityEventFilter.js

@@ -0,0 +1,87 @@
+/**
+ * AccessibilityEvent过滤配置类
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+export class AccessibilityEventFilter {
+    constructor(config = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        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 = (_e = config.eventTypes) !== null && _e !== void 0 ? _e : null;
+        this.enableDeduplication = (_f = config.enableDeduplication) !== null && _f !== void 0 ? _f : false;
+    }
+    /**
+     * 检查是否应该处理指定包的事件
+     * @param targetPackageName 目标包名
+     * @returns true表示应该处理，false表示应该过滤
+     */
+    shouldProcessPackage(targetPackageName) {
+        return this.packageName === null || this.packageName === targetPackageName;
+    }
+    /**
+     * 检查是否应该处理指定类型的事件
+     * @param eventType 事件类型
+     * @returns true表示应该处理，false表示应该过滤
+     */
+    shouldProcessEventType(eventType) {
+        return this.eventTypes === null || this.eventTypes.has(eventType);
+    }
+    /**
+     * 创建默认的过滤配置
+     * 所有包名，子线程处理，获取节点信息，启用日志
+     */
+    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/AssistsX.d.ts

@@ -5,6 +5,7 @@
 import { Node } from "./Node";
 import { CallResponse } from "./CallResponse";
 import { Bounds } from "./Bounds";
+import { AccessibilityEventFilter } from "AccessibilityEventFilter";
 /**
  * 无障碍事件数据结构
  */
@@ -363,6 +364,8 @@ export declare class AssistsX {
     static getUniqueDeviceId(): any;
     static getAndroidID(): any;
     static getMacAddress(): Promise<any>;
+    static setAccessibilityEventFilters(value: AccessibilityEventFilter[]): Promise<any>;
+    static addAccessibilityEventFilters(value: AccessibilityEventFilter): Promise<any>;
     /**
      * 获取屏幕尺寸
      * @returns 屏幕尺寸对象

package/dist/AssistsX.js

@@ -566,6 +566,18 @@ export class AssistsX {
         const response = await this.asyncCall(CallMethod.getMacAddress);
         return response.getDataOrDefault({});
     }
+    static async setAccessibilityEventFilters(value) {
+        const response = this.call(CallMethod.setAccessibilityEventFilters, {
+            args: value,
+        });
+        return response.getDataOrDefault({});
+    }
+    static async addAccessibilityEventFilters(value) {
+        const response = this.call(CallMethod.addAccessibilityEventFilters, {
+            args: value,
+        });
+        return response.getDataOrDefault({});
+    }
     /**
      * 获取屏幕尺寸
      * @returns 屏幕尺寸对象

package/dist/CallMethod.d.ts

@@ -42,5 +42,7 @@ export declare const CallMethod: {
     readonly getMacAddress: "getMacAddress";
     readonly getAndroidID: "getAndroidID";
     readonly getUniqueDeviceId: "getUniqueDeviceId";
+    readonly addAccessibilityEventFilters: "addAccessibilityEventFilters";
+    readonly setAccessibilityEventFilters: "setAccessibilityEventFilters";
 };
-export type CallMethodType = typeof CallMethod[keyof typeof CallMethod];
+export type CallMethodType = (typeof CallMethod)[keyof typeof CallMethod];

package/dist/CallMethod.js

@@ -43,4 +43,6 @@ export const CallMethod = {
     getMacAddress: "getMacAddress",
     getAndroidID: "getAndroidID",
     getUniqueDeviceId: "getUniqueDeviceId",
+    addAccessibilityEventFilters: "addAccessibilityEventFilters",
+    setAccessibilityEventFilters: "setAccessibilityEventFilters",
 };

package/dist/Step.js

@@ -105,9 +105,7 @@ export class Step {
             }
         }
         catch (e) {
-            if (Step.showLog) {
-                console.error(`步骤${implnName}执行出错`, e);
-            }
+            console.error(`步骤${implnName}执行出错`, e);
             //步骤执行出错
             const errorMsg = JSON.stringify({
                 impl: implnName,

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * from "./WindowFlags";
 export * from "./NodeAsync";
 export * from "./AssistsXAsync";
 export * from "./StepAsync";
+export * from "./AccessibilityEventFilter";

package/dist/index.js

@@ -11,3 +11,4 @@ export * from "./WindowFlags";
 export * from "./NodeAsync";
 export * from "./AssistsXAsync";
 export * from "./StepAsync";
+export * from "./AccessibilityEventFilter";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistsx-js",
-  "version": "0.0.2013",
+  "version": "0.0.2015",
   "description": "assistsx-js自动化开发SDK",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/AccessibilityEventFilter.ts

@@ -0,0 +1,172 @@
+/**
+ * AccessibilityEvent过滤配置接口
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+export interface AccessibilityEventFilterConfig {
+  /**
+   * 包名过滤
+   * 如果为空或null，则处理所有包的事件
+   * 如果指定包名，则只处理该包的事件
+   */
+  packageName?: string | null;
+
+  /**
+   * 是否在子线程中处理AccessibilityEvent
+   * true: 在子线程中处理，避免阻塞主线程
+   * false: 在主线程中处理
+   */
+  processInBackground?: boolean;
+
+  /**
+   * 是否获取节点信息
+   * true: 获取并解析AccessibilityNodeInfo节点信息
+   * false: 不获取节点信息，提高处理性能
+   */
+  fetchNodeInfo?: boolean;
+
+  /**
+   * 是否启用日志输出
+   * true: 输出AccessibilityEvent处理日志
+   * false: 不输出日志
+   */
+  enableLogging?: boolean;
+
+  /**
+   * 事件类型过滤
+   * 如果为空，则处理所有类型的事件
+   * 如果指定类型，则只处理指定类型的事件
+   */
+  eventTypes?: Set<number> | null;
+
+  /**
+   * 是否启用事件去重
+   * true: 启用去重，避免重复处理相同事件
+   * false: 不启用去重
+   */
+  enableDeduplication?: boolean;
+}
+
+/**
+ * AccessibilityEvent过滤配置类
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+export class AccessibilityEventFilter {
+  /**
+   * 包名过滤
+   */
+  public readonly packageName: string | null;
+
+  /**
+   * 是否在子线程中处理AccessibilityEvent
+   */
+  public readonly processInBackground: boolean;
+
+  /**
+   * 是否获取节点信息
+   */
+  public readonly fetchNodeInfo: boolean;
+
+  /**
+   * 是否启用日志输出
+   */
+  public readonly enableLogging: boolean;
+
+  /**
+   * 事件类型过滤
+   */
+  public readonly eventTypes: Set<number> | null;
+
+  /**
+   * 是否启用事件去重
+   */
+  public readonly enableDeduplication: boolean;
+
+  constructor(config: AccessibilityEventFilterConfig = {}) {
+    this.packageName = config.packageName ?? null;
+    this.processInBackground = config.processInBackground ?? true;
+    this.fetchNodeInfo = config.fetchNodeInfo ?? true;
+    this.enableLogging = config.enableLogging ?? false;
+    this.eventTypes = config.eventTypes ?? null;
+    this.enableDeduplication = config.enableDeduplication ?? false;
+  }
+
+  /**
+   * 检查是否应该处理指定包的事件
+   * @param targetPackageName 目标包名
+   * @returns true表示应该处理，false表示应该过滤
+   */
+  public shouldProcessPackage(targetPackageName: string | null): boolean {
+    return this.packageName === null || this.packageName === targetPackageName;
+  }
+
+  /**
+   * 检查是否应该处理指定类型的事件
+   * @param eventType 事件类型
+   * @returns true表示应该处理，false表示应该过滤
+   */
+  public shouldProcessEventType(eventType: number): boolean {
+    return this.eventTypes === null || this.eventTypes.has(eventType);
+  }
+
+  /**
+   * 创建默认的过滤配置
+   * 所有包名，子线程处理，获取节点信息，启用日志
+   */
+  public static createDefault(): AccessibilityEventFilter {
+    return new AccessibilityEventFilter({
+      packageName: null,
+      processInBackground: true,
+      fetchNodeInfo: true,
+      enableLogging: false,
+      eventTypes: null,
+      enableDeduplication: false,
+    });
+  }
+
+  /**
+   * 创建高性能配置
+   * 不获取节点信息，不启用日志，启用去重
+   */
+  public static createHighPerformance(): AccessibilityEventFilter {
+    return new AccessibilityEventFilter({
+      packageName: null,
+      processInBackground: true,
+      fetchNodeInfo: false,
+      enableLogging: false,
+      eventTypes: null,
+      enableDeduplication: true,
+    });
+  }
+
+  /**
+   * 创建调试配置
+   * 启用所有功能，便于调试
+   */
+  public static createDebug(): AccessibilityEventFilter {
+    return new AccessibilityEventFilter({
+      packageName: null,
+      processInBackground: true,
+      fetchNodeInfo: true,
+      enableLogging: true,
+      eventTypes: null,
+      enableDeduplication: false,
+    });
+  }
+
+  /**
+   * 创建指定包名的过滤配置
+   * @param targetPackageName 目标包名
+   */
+  public static createForPackage(
+    targetPackageName: string
+  ): AccessibilityEventFilter {
+    return new AccessibilityEventFilter({
+      packageName: targetPackageName,
+      processInBackground: true,
+      fetchNodeInfo: true,
+      enableLogging: false,
+      eventTypes: null,
+      enableDeduplication: false,
+    });
+  }
+}

package/src/AssistsX.ts

@@ -7,6 +7,7 @@ import { CallMethod } from "./CallMethod";
 import { CallResponse } from "./CallResponse";
 import { Bounds } from "./Bounds";
 import { decodeBase64UTF8, generateUUID } from "./Utils";
+import { AccessibilityEventFilter } from "AccessibilityEventFilter";
 
 /**
  * 无障碍事件数据结构
@@ -798,6 +799,22 @@ export class AssistsX {
     const response = await this.asyncCall(CallMethod.getMacAddress);
     return response.getDataOrDefault({});
   }
+  public static async setAccessibilityEventFilters(
+    value: AccessibilityEventFilter[]
+  ): Promise<any> {
+    const response = this.call(CallMethod.setAccessibilityEventFilters, {
+      args: value,
+    });
+    return response.getDataOrDefault({});
+  }
+  public static async addAccessibilityEventFilters(
+    value: AccessibilityEventFilter
+  ): Promise<any> {
+    const response = this.call(CallMethod.addAccessibilityEventFilters, {
+      args: value,
+    });
+    return response.getDataOrDefault({});
+  }
 
   /**
    * 获取屏幕尺寸

package/src/CallMethod.ts

@@ -1,51 +1,54 @@
 // CallMethod 常量对象
 export const CallMethod = {
-    takeScreenshot: "takeScreenshot",
-    overlayToast: "overlayToast",
-    setNodeText: "setNodeText",
-    findByTags: "findByTags",
-    findById: "findById",
-    findByText: "findByText",
-    findByTextAllMatch: "findByTextAllMatch",
-    containsText: "containsText",
-    getAllText: "getAllText",
-    findFirstParentByTags: "findFirstParentByTags",
-    getAllNodes: "getAllNodes",
-    getNodes: "getNodes",
-    findFirstParentClickable: "findFirstParentClickable",
-    getChildren: "getChildren",
-    getBoundsInScreen: "getBoundsInScreen",
-    isVisible: "isVisible",
-    click: "click",
-    longClick: "longClick",
-    back: "back",
-    home: "home",
-    notifications: "notifications",
-    recentApps: "recentApps",
-    paste: "paste",
-    focus: "focus",
-    selectionText: "selectionText",
-    scrollForward: "scrollForward",
-    launchApp: "launchApp",
-    getPackageName: "getPackageName",
-    getScreenSize: "getScreenSize",
-    getAppScreenSize: "getAppScreenSize",
-    scrollBackward: "scrollBackward",
-    setOverlayFlags: "setOverlayFlags",
-    scanQR: "scanQR",
-    loadWebViewOverlay: "loadWebViewOverlay",
+  takeScreenshot: "takeScreenshot",
+  overlayToast: "overlayToast",
+  setNodeText: "setNodeText",
+  findByTags: "findByTags",
+  findById: "findById",
+  findByText: "findByText",
+  findByTextAllMatch: "findByTextAllMatch",
+  containsText: "containsText",
+  getAllText: "getAllText",
+  findFirstParentByTags: "findFirstParentByTags",
+  getAllNodes: "getAllNodes",
+  getNodes: "getNodes",
+  findFirstParentClickable: "findFirstParentClickable",
+  getChildren: "getChildren",
+  getBoundsInScreen: "getBoundsInScreen",
+  isVisible: "isVisible",
+  click: "click",
+  longClick: "longClick",
+  back: "back",
+  home: "home",
+  notifications: "notifications",
+  recentApps: "recentApps",
+  paste: "paste",
+  focus: "focus",
+  selectionText: "selectionText",
+  scrollForward: "scrollForward",
+  launchApp: "launchApp",
+  getPackageName: "getPackageName",
+  getScreenSize: "getScreenSize",
+  getAppScreenSize: "getAppScreenSize",
+  scrollBackward: "scrollBackward",
+  setOverlayFlags: "setOverlayFlags",
+  scanQR: "scanQR",
+  loadWebViewOverlay: "loadWebViewOverlay",
 
-    clickByGesture: "clickByGesture",
-    clickNodeByGesture: "clickNodeByGesture",
-    doubleClickNodeByGesture: "doubleClickNodeByGesture",
-    performLinearGesture: "performLinearGesture",
-    longPressGestureAutoPaste: "longPressGestureAutoPaste",
+  clickByGesture: "clickByGesture",
+  clickNodeByGesture: "clickNodeByGesture",
+  doubleClickNodeByGesture: "doubleClickNodeByGesture",
+  performLinearGesture: "performLinearGesture",
+  longPressGestureAutoPaste: "longPressGestureAutoPaste",
 
-    getAppInfo: "getAppInfo",
-    getMacAddress: "getMacAddress",
-    getAndroidID: "getAndroidID",
-    getUniqueDeviceId: "getUniqueDeviceId",
+  getAppInfo: "getAppInfo",
+  getMacAddress: "getMacAddress",
+  getAndroidID: "getAndroidID",
+  getUniqueDeviceId: "getUniqueDeviceId",
+
+  addAccessibilityEventFilters: "addAccessibilityEventFilters",
+  setAccessibilityEventFilters: "setAccessibilityEventFilters",
 } as const;
 
 // 导出类型定义
-export type CallMethodType = typeof CallMethod[keyof typeof CallMethod];
+export type CallMethodType = (typeof CallMethod)[keyof typeof CallMethod];

package/src/Step.ts

@@ -153,9 +153,7 @@ export class Step {
         }
       }
     } catch (e: any) {
-      if (Step.showLog) {
-        console.error(`步骤${implnName}执行出错`, e);
-      }
+      console.error(`步骤${implnName}执行出错`, e);
       //步骤执行出错
       const errorMsg = JSON.stringify({
         impl: implnName,

package/src/index.ts

@@ -11,3 +11,4 @@ export * from "./WindowFlags";
 export * from "./NodeAsync";
 export * from "./AssistsXAsync";
 export * from "./StepAsync";
+export * from "./AccessibilityEventFilter";