ms-types 0.2.2 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/system.d.ts

@@ -221,4 +221,56 @@ declare namespace system {
      */
     screenshotQuality?: number;
   }): boolean;
+
+  /**
+   * 启动 Agent 服务
+   * @returns 是否启动成功
+   * @example
+   * const started = system.startAgent()
+   * if (started) {
+   *   logi("Agent 启动成功")
+   * }
+   */
+  function startAgent(): boolean;
+  /**
+   * 获取 Agent 状态
+   * @returns Agent 是否正在运行
+   * @example
+   * const isRunning = system.getAgentStatus()
+   * if (isRunning) {
+   *   logi("Agent 服务正在运行")
+   * } else {
+   *   logi("Agent 服务未运行")
+   * }
+   */
+  function getAgentStatus(): boolean;
+
+  /**
+   * 设置 Agent 设置项
+   * @param params Agent 设置项参数
+   * @returns 是否设置成功
+   * @example
+   * const set = system.setAgentSettings({
+   *   mjpegServerScreenshotQuality: 50,
+   *   mjpegServerFramerate: 20,
+   *   screenshotQuality: 1,
+   * })
+   * if (set) {
+   *   logi("Agent 设置成功")
+   * }
+   */
+  function setAgentSettings(params: {
+    /**
+     * 视频截图质量，范围 1-100，默认 25
+     */
+    mjpegServerScreenshotQuality?: number;
+    /**
+     * 视频截图帧率，范围 1-60，默认 10
+     */
+    mjpegServerFramerate?: number;
+    /**
+     * 截图质量，范围 0 PNG 高质量 1 JPEG 高质量 2 JPEG 低质量
+     */
+    screenshotQuality?: number;
+  }): boolean;
 }

package/types/ui.d.ts

@@ -80,6 +80,18 @@ declare namespace ms {
    */
   function startWDA(): Promise<boolean>;
 
+  /**
+   * 获取Agent状态
+   * @returns 如果Agent正在运行返回true，否则返回false
+   */
+  function getAgentStatus(): Promise<boolean>;
+
+  /**
+   * 启动Agent服务
+   * @returns 如果调用成功返回true，否则返回false。注意：返回值仅表示调用是否成功，不代表Agent服务是否启动成功
+   */
+  function startAgent(): Promise<boolean>;
+
   /**
    * 打开URL
    * @param url URL地址
@@ -114,7 +126,7 @@ declare namespace ui {
    *   name: "快点JS",
    * })
    */
-  function call(key: string, data: any): void;
+  function call(key: string, data: Record<string, any>): void;
 
   /**
    * 显示Toast提示消息

package/types/zh//347/263/273/347/273/237/346/250/241/345/235/227.d.ts

@@ -220,4 +220,57 @@ declare namespace $系统 {
      */
     screenshotQuality?: number;
   }): 布尔值;
+
+  /**
+   * 启动 Agent 服务
+   * @returns 是否启动成功
+   * @example
+   * const 是否启动成功 = $系统.启动Agent服务()
+   * if (是否启动成功) {
+   *   $打印信息日志("Agent 启动成功")
+   * }
+   */
+  function 启动Agent服务(): 布尔值;
+
+  /**
+   * 获取 Agent 状态
+   * @returns Agent 是否正在运行
+   * @example
+   * const 是否运行 = $系统.获取Agent状态()
+   * if (是否运行) {
+   *   $打印信息日志("Agent 服务正在运行")
+   * } else {
+   *   $打印信息日志("Agent 服务未运行")
+   * }
+   */
+  function 获取Agent状态(): 布尔值;
+
+  /**
+   * 设置 Agent 设置项
+   * @param params Agent 设置项参数
+   * @returns 是否设置成功
+   * @example
+   * const 是否设置成功 = $系统.设置Agent设置项({
+   *   mjpegServerScreenshotQuality: 50,
+   *   mjpegServerFramerate: 20,
+   *   screenshotQuality: 1,
+   * })
+   * if (是否设置成功) {
+   *   $打印信息日志("Agent 设置成功")
+   * }
+   */
+  function 设置Agent设置项(params: {
+    /**
+     * 视频截图质量，范围 1-100，默认 25
+     */
+    mjpegServerScreenshotQuality?: number;
+    /**
+     * 视频截图帧率，范围 1-60，默认 10
+     */
+    mjpegServerFramerate?: number;
+    /**
+     * 截图质量，范围 0 PNG 高质量 1 JPEG 高质量 2 JPEG 低质量
+     */
+    screenshotQuality?: number;
+  }): 布尔值;
 }