assistsx-js 0.0.2048 → 0.0.2050

package/dist/AssistsX.d.ts

@@ -420,6 +420,18 @@ export declare class AssistsX {
     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>;
     /**

package/dist/AssistsX.js

@@ -637,6 +637,28 @@ export class AssistsX {
         });
         return response.getDataOrDefault({});
     }
+    /**
+     * 播放系统电话铃声
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 播放结果消息
+     */
+    static async audioPlayRingtone(timeout) {
+        const response = await this.asyncCall(CallMethod.audioPlayRingtone, {
+            timeout,
+        });
+        return response.getDataOrDefault("");
+    }
+    /**
+     * 停止播放系统电话铃声
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 停止结果消息
+     */
+    static async audioStopRingtone(timeout) {
+        const response = await this.asyncCall(CallMethod.audioStopRingtone, {
+            timeout,
+        });
+        return response.getDataOrDefault("");
+    }
     static async setAccessibilityEventFilters(value) {
         const response = this.call(CallMethod.setAccessibilityEventFilters, {
             args: { value },

package/dist/AssistsXAsync.d.ts

@@ -442,6 +442,22 @@ export declare class AssistsXAsync {
     static audioStop({ timeout, }: {
         timeout?: number;
     }): Promise<boolean | null | undefined>;
+    /**
+     * 播放系统电话铃声
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 播放结果消息
+     */
+    static audioPlayRingtone({ timeout, }: {
+        timeout?: number;
+    }): Promise<string>;
+    /**
+     * 停止播放系统电话铃声
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 停止结果消息
+     */
+    static audioStopRingtone({ timeout, }: {
+        timeout?: number;
+    }): Promise<string>;
     /**
      * 添加联系人
      * @param name 联系人姓名（必填）

package/dist/AssistsXAsync.js

@@ -681,6 +681,28 @@ export class AssistsXAsync {
         });
         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 联系人姓名（必填）

package/dist/CallMethod.d.ts

@@ -56,6 +56,8 @@ export declare const CallMethod: {
     readonly download: "download";
     readonly audioPlayFromFile: "audioPlayFromFile";
     readonly audioStop: "audioStop";
+    readonly audioPlayRingtone: "audioPlayRingtone";
+    readonly audioStopRingtone: "audioStopRingtone";
     readonly addContact: "addContact";
     readonly getAllContacts: "getAllContacts";
 };

package/dist/CallMethod.js

@@ -57,6 +57,8 @@ export const CallMethod = {
     download: "download",
     audioPlayFromFile: "audioPlayFromFile",
     audioStop: "audioStop",
+    audioPlayRingtone: "audioPlayRingtone",
+    audioStopRingtone: "audioStopRingtone",
     // 通讯录相关方法
     addContact: "addContact",
     getAllContacts: "getAllContacts",

package/dist/Step.d.ts

@@ -1,4 +1,5 @@
 import { Node } from "./Node";
+import { StepError } from "./StepError";
 import { StepAsync } from "./StepAsync";
 export type StepResult = Step | undefined;
 export type StepImpl = (step: Step) => Promise<StepResult>;
@@ -16,6 +17,10 @@ export declare class Step {
      * 步骤拦截器列表
      */
     private static _interceptors;
+    /**
+     * 步骤异常变量，默认为空
+     */
+    static exception: StepError | undefined;
     /**
      * 运行步骤实现
      * @param impl 步骤实现函数
@@ -46,8 +51,9 @@ export declare class Step {
     static assignIdsToNodes(nodes: Node[], stepId: string | undefined): void;
     /**
      * 停止当前步骤执行
+     * @param exception 可选的异常对象，如果传入则使用该异常，否则使用默认的StepStopError
      */
-    static stop(): void;
+    static stop(exception?: StepError): void;
     /**
      * 添加步骤拦截器
      * @param interceptor 拦截器函数

package/dist/Step.js

@@ -5,7 +5,7 @@
 import { AssistsX } from "./AssistsX";
 import { useStepStore } from "./StepStateStore";
 import { generateUUID } from "./Utils";
-import { StepError } from "./StepError";
+import { StepError, StepStopError } from "./StepError";
 import { StepAsync } from "./StepAsync";
 export class Step {
     /**
@@ -17,6 +17,7 @@ export class Step {
      */
     static async run(impl, { stepId, tag, data, delayMs = Step.delayMsDefault, } = {}) {
         var _a, _b, _c, _d, _e, _f;
+        this.exception = undefined;
         const stepStore = useStepStore();
         let implnName = impl.name;
         let currentStep;
@@ -131,7 +132,7 @@ export class Step {
                 error: (_f = e === null || e === void 0 ? void 0 : e.message) !== null && _f !== void 0 ? _f : String(e),
             });
             stepStore.setError(errorMsg);
-            throw new StepError(errorMsg, implnName, tag, data, e, currentStep || undefined);
+            throw e;
         }
         //步骤执行结束
         stepStore.completeStep();
@@ -148,11 +149,12 @@ export class Step {
      * @param stepId 要验证的步骤ID
      */
     static assert(stepId) {
+        // 检查异常变量，如果不为空则直接抛出
+        if (Step.exception) {
+            throw Step.exception;
+        }
         if (stepId && Step.stepId != stepId) {
-            if (Step.stepId === "STEP_STOP") {
-                throw new Error("主动中断步骤");
-            }
-            throw new Error("StepId mismatch");
+            throw new StepError("StepId mismatch", { stepId, currentStepId: Step.stepId });
         }
     }
     /**
@@ -169,9 +171,16 @@ export class Step {
     }
     /**
      * 停止当前步骤执行
+     * @param exception 可选的异常对象，如果传入则使用该异常，否则使用默认的StepStopError
      */
-    static stop() {
+    static stop(exception) {
         this._stepId = "STEP_STOP";
+        if (exception) {
+            this.exception = exception;
+        }
+        else {
+            this.exception = new StepStopError("主动中断步骤", { stepId: this._stepId });
+        }
     }
     /**
      * 添加步骤拦截器
@@ -622,3 +631,7 @@ Step._stepId = undefined;
  * 步骤拦截器列表
  */
 Step._interceptors = [];
+/**
+ * 步骤异常变量，默认为空
+ */
+Step.exception = undefined;

package/dist/StepError.d.ts

@@ -1,27 +1,35 @@
 /**
  * 步骤执行错误类
  * 用于携带步骤执行过程中的错误信息和当前步骤对象
+ * 支持传入可选数据：message，data任何类型的数据
  */
 export declare class StepError extends Error {
     /**
      * 步骤实现函数名
      */
-    readonly impl: string;
+    readonly impl?: string;
     /**
      * 步骤标签
      */
-    readonly tag: string | undefined;
+    readonly tag?: string | undefined;
     /**
-     * 步骤数据
+     * 步骤数据，可以是任何类型
      */
-    readonly data: any | undefined;
+    readonly data?: any;
     /**
      * 原始错误
      */
-    readonly originalError: any;
+    readonly originalError?: any;
     /**
      * 当前步骤对象
      */
-    readonly currentStep: any | undefined;
-    constructor(message: string, impl: string, tag: string | undefined, data: any | undefined, originalError: any, currentStep: any | undefined);
+    readonly currentStep?: any;
+    constructor(message?: string, data?: any, impl?: string, tag?: string | undefined, originalError?: any, currentStep?: any | undefined);
+}
+/**
+ * 主动停止异常类
+ * 用于表示步骤被主动停止执行
+ */
+export declare class StepStopError extends StepError {
+    constructor(message?: string, data?: any);
 }

package/dist/StepError.js

@@ -1,15 +1,26 @@
 /**
  * 步骤执行错误类
  * 用于携带步骤执行过程中的错误信息和当前步骤对象
+ * 支持传入可选数据：message，data任何类型的数据
  */
 export class StepError extends Error {
-    constructor(message, impl, tag, data, originalError, currentStep) {
+    constructor(message, data, impl, tag, originalError, currentStep) {
         super(message);
         this.name = "StepError";
+        this.data = data;
         this.impl = impl;
         this.tag = tag;
-        this.data = data;
         this.originalError = originalError;
         this.currentStep = currentStep;
     }
 }
+/**
+ * 主动停止异常类
+ * 用于表示步骤被主动停止执行
+ */
+export class StepStopError extends StepError {
+    constructor(message, data) {
+        super(message || "主动中断步骤", data);
+        this.name = "StepStopError";
+    }
+}

package/package.json

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