assistsx-js 0.0.2038 → 0.0.2040

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 {
     /**
      * 执行异步调用
@@ -98,7 +108,7 @@ export declare class AssistsXAsync {
      * @param param0 识别参数
      * @returns 截图识别结果
      */
-    static recognizeTextInScreenshot(targetText: string, { rotationDegrees, overlayHiddenScreenshotDelayMillis, restoreOverlay, region, timeout, }: {
+    static recognizeTextInScreenshot(targetText: string, options?: {
         rotationDegrees?: number;
         overlayHiddenScreenshotDelayMillis?: number;
         restoreOverlay?: boolean;
@@ -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

@@ -124,7 +124,8 @@ export class AssistsXAsync {
      * @param param0 识别参数
      * @returns 截图识别结果
      */
-    static async recognizeTextInScreenshot(targetText, { rotationDegrees, overlayHiddenScreenshotDelayMillis, restoreOverlay = true, region, timeout, }) {
+    static async recognizeTextInScreenshot(targetText, options = {}) {
+        const { rotationDegrees = 0, overlayHiddenScreenshotDelayMillis = 250, restoreOverlay = true, region, timeout, } = options;
         const response = await this.asyncCall(CallMethod.recognizeTextInScreenshot, {
             args: {
                 targetText,
@@ -680,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/package.json

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

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 {
   /**
    * 执行异步调用
@@ -208,20 +219,22 @@ export class AssistsXAsync {
    */
   public static async recognizeTextInScreenshot(
     targetText: string,
-    {
-      rotationDegrees,
-      overlayHiddenScreenshotDelayMillis,
-      restoreOverlay = true,
-      region,
-      timeout,
-    }: {
+    options: {
       rotationDegrees?: number;
       overlayHiddenScreenshotDelayMillis?: number;
       restoreOverlay?: boolean;
       region?: RecognizeTextRegion;
       timeout?: number;
-    }
+    } = {}
   ): Promise<RecognizeTextInScreenshotResult> {
+    const {
+      rotationDegrees = 0,
+      overlayHiddenScreenshotDelayMillis = 250,
+      restoreOverlay = true,
+      region,
+      timeout,
+    } = options;
+
     const response = await this.asyncCall(
       CallMethod.recognizeTextInScreenshot,
       {
@@ -1028,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;
 
 // 导出类型定义