assistsx-js 0.0.2039 → 0.0.2041

package/dist/AssistsXAsync.d.ts

@@ -38,6 +38,16 @@ export interface RecognizeTextRegion {
     width?: number;
     height?: number;
 }
+/**
+ * 联系人信息
+ */
+export interface Contact {
+    id: string;
+    name: string;
+    phoneNumbers: string[];
+    emails: string[];
+    address: string;
+}
 export declare class AssistsXAsync {
     /**
      * 执行异步调用
@@ -432,4 +442,18 @@ export declare class AssistsXAsync {
     static audioStop({ timeout, }: {
         timeout?: number;
     }): Promise<boolean | null | undefined>;
+    /**
+     * 添加联系人
+     * @param name 联系人姓名（必填）
+     * @param phoneNumber 电话号码（必填）
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 是否添加成功
+     */
+    static addContact(name: string, phoneNumber: string, timeout?: number): Promise<boolean>;
+    /**
+     * 获取所有联系人
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 联系人列表
+     */
+    static getAllContacts(timeout?: number): Promise<Contact[]>;
 }

package/dist/AssistsXAsync.js

@@ -681,4 +681,29 @@ export class AssistsXAsync {
         });
         return response.getDataOrDefault(false);
     }
+    /**
+     * 添加联系人
+     * @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,
+        });
+        return response.getDataOrDefault([]);
+    }
 }

package/dist/CallMethod.d.ts

@@ -56,5 +56,7 @@ export declare const CallMethod: {
     readonly download: "download";
     readonly audioPlayFromFile: "audioPlayFromFile";
     readonly audioStop: "audioStop";
+    readonly addContact: "addContact";
+    readonly getAllContacts: "getAllContacts";
 };
 export type CallMethodType = (typeof CallMethod)[keyof typeof CallMethod];

package/dist/CallMethod.js

@@ -57,4 +57,7 @@ export const CallMethod = {
     download: "download",
     audioPlayFromFile: "audioPlayFromFile",
     audioStop: "audioStop",
+    // 通讯录相关方法
+    addContact: "addContact",
+    getAllContacts: "getAllContacts",
 };

package/dist/Step.d.ts

@@ -101,6 +101,7 @@ export declare class Step {
      * 步骤标签
      */
     tag: string | undefined;
+    isEnd: boolean;
     /**
      * 步骤数据
      */
@@ -121,13 +122,14 @@ export declare class Step {
      * @param data 步骤数据
      * @param delayMs 步骤延迟时间(毫秒)
      */
-    constructor({ stepId, impl, tag, data, delayMs, repeatCountMax, }: {
+    constructor({ stepId, impl, tag, data, delayMs, repeatCountMax, isEnd, }: {
         stepId: string;
         impl: StepImpl;
         tag?: string | undefined;
         data?: any | undefined;
         delayMs?: number;
         repeatCountMax?: number;
+        isEnd?: boolean;
     });
     get async(): StepAsync;
     /**
@@ -144,6 +146,12 @@ export declare class Step {
         delayMs?: number;
         repeatCountMax?: number;
     }): Step;
+    end(impl: StepImpl, { tag, data, delayMs, repeatCountMax, }?: {
+        tag?: string | undefined;
+        data?: any | undefined;
+        delayMs?: number;
+        repeatCountMax?: number;
+    }): Step;
     /**
      * 重复当前步骤
      * @param stepId 步骤ID

package/dist/Step.js

@@ -98,6 +98,12 @@ export class Step {
                 Step.assert(currentStep.stepId);
                 if (nextStep) {
                     currentStep = nextStep;
+                    if (currentStep.isEnd) {
+                        if (Step.showLog) {
+                            console.log(`步骤${implnName}结束`);
+                        }
+                        break;
+                    }
                 }
                 else {
                     break;
@@ -132,6 +138,9 @@ export class Step {
      */
     static assert(stepId) {
         if (stepId && Step.stepId != stepId) {
+            if (Step.stepId === "STEP_STOP") {
+                throw new Error("主动中断步骤");
+            }
             throw new Error("StepId mismatch");
         }
     }
@@ -151,7 +160,7 @@ export class Step {
      * 停止当前步骤执行
      */
     static stop() {
-        this._stepId = undefined;
+        this._stepId = "STEP_STOP";
     }
     /**
      * 添加步骤拦截器
@@ -236,7 +245,7 @@ export class Step {
      * @param data 步骤数据
      * @param delayMs 步骤延迟时间(毫秒)
      */
-    constructor({ stepId, impl, tag, data, delayMs = Step.delayMsDefault, repeatCountMax = Step.repeatCountMaxDefault, }) {
+    constructor({ stepId, impl, tag, data, delayMs = Step.delayMsDefault, repeatCountMax = Step.repeatCountMaxDefault, isEnd = false, }) {
         /**
          * 步骤ID
          */
@@ -249,6 +258,7 @@ export class Step {
          * 步骤重复执行最大次数,默认不限制
          */
         this.repeatCountMax = Step.repeatCountMaxDefault;
+        this.isEnd = false;
         /**
          * 步骤延迟时间(毫秒)
          */
@@ -259,6 +269,7 @@ export class Step {
         this.impl = impl;
         this.delayMs = delayMs;
         this.repeatCountMax = repeatCountMax;
+        this.isEnd = isEnd;
     }
     get async() {
         return new StepAsync(this);
@@ -282,6 +293,18 @@ export class Step {
             repeatCountMax,
         });
     }
+    end(impl, { tag, data, delayMs = Step.delayMsDefault, repeatCountMax = Step.repeatCountMaxDefault, } = {}) {
+        Step.assert(this.stepId);
+        return new Step({
+            stepId: this.stepId,
+            impl,
+            tag,
+            data: data !== null && data !== void 0 ? data : this.data,
+            delayMs,
+            repeatCountMax,
+            isEnd: true,
+        });
+    }
     /**
      * 重复当前步骤
      * @param stepId 步骤ID

package/package.json

@@ -1,43 +1,43 @@
 {
-  "name": "assistsx-js",
-  "version": "0.0.2039",
-  "description": "assistsx-js自动化开发SDK",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "src"
-  ],
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+    "name": "assistsx-js",
+    "version": "0.0.2041",
+    "description": "assistsx-js自动化开发SDK",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "src"
+    ],
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc",
+        "prepublish": "npm run build",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": [
+        "assistsx",
+        "assists",
+        "android assistsx",
+        "assistsx webview",
+        "AccessibilityService",
+        "dev"
+    ],
+    "author": "Ven",
+    "license": "MIT",
+    "devDependencies": {
+        "typescript": "^5.3.3"
+    },
+    "dependencies": {
+        "pinia": "^3.0.3"
     }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "prepublish": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [
-    "assistsx",
-    "assists",
-    "android assistsx",
-    "assistsx webview",
-    "AccessibilityService",
-    "dev"
-  ],
-  "author": "Ven",
-  "license": "MIT",
-  "devDependencies": {
-    "typescript": "^5.3.3"
-  },
-  "dependencies": {
-    "pinia": "^3.0.3"
-  }
-}
+}

package/src/AssistsXAsync.ts

@@ -51,6 +51,17 @@ export interface RecognizeTextRegion {
   height?: number;
 }
 
+/**
+ * 联系人信息
+ */
+export interface Contact {
+  id: string;
+  name: string;
+  phoneNumbers: string[];
+  emails: string[];
+  address: string;
+}
+
 export class AssistsXAsync {
   /**
    * 执行异步调用
@@ -1030,6 +1041,37 @@ export class AssistsXAsync {
     return response.getDataOrDefault(false);
   }
 
+  /**
+   * 添加联系人
+   * @param name 联系人姓名（必填）
+   * @param phoneNumber 电话号码（必填）
+   * @param timeout 超时时间(秒)，默认30秒
+   * @returns 是否添加成功
+   */
+  public static async addContact(
+    name: string,
+    phoneNumber: string,
+    timeout?: number
+  ): Promise<boolean> {
+    const response = await this.asyncCall(CallMethod.addContact, {
+      args: { name, phoneNumber },
+      timeout,
+    });
+    return response.getDataOrDefault(false);
+  }
+
+  /**
+   * 获取所有联系人
+   * @param timeout 超时时间(秒)，默认30秒
+   * @returns 联系人列表
+   */
+  public static async getAllContacts(timeout?: number): Promise<Contact[]> {
+    const response = await this.asyncCall(CallMethod.getAllContacts, {
+      timeout,
+    });
+    return response.getDataOrDefault([]);
+  }
+
   /**
    * 发送HTTP请求
    * @param options 请求选项

package/src/CallMethod.ts

@@ -61,6 +61,10 @@ export const CallMethod = {
   download: "download",
   audioPlayFromFile: "audioPlayFromFile",
   audioStop: "audioStop",
+
+  // 通讯录相关方法
+  addContact: "addContact",
+  getAllContacts: "getAllContacts",
 } as const;
 
 // 导出类型定义