scanonweb 1.0.1 → 1.0.3

package/README.md

@@ -148,6 +148,7 @@ scanner.scaner_work_config = {
 - `getImageById(index)` - 获取指定索引的图像
 - `rotateImage(index, angle)` - 旋转图像
 - `deleteImageByIndex(index)` - 删除指定图像
+- `moveImage(oldIndex, newIndex)` - 调整图像顺序（将 oldIndex 移动到 newIndex）
 
 #### 上传功能
 - `uploadAllImageAsPdfToUrl(url, id, desc)` - 以PDF格式上传所有图像
@@ -196,6 +197,14 @@ MIT License
 
 ## 更新日志
 
+### 1.0.3
+- 添加了支持前端直接调整扫描结果图像顺序的能力,前端可以通过moveImage函数调整结果图像顺序
+
+
+### 1.0.2
+- 添加了对加载base64格式图像的支持
+- 远程加载图像除了支持pdf和tiff格式，现在也支持加载jpg、png等常见格式的图像
+
 ### 1.0.1
 - 初始版本发布
 - 支持基本扫描功能

package/dist/scanonweb.cjs.js

@@ -1,9 +1,9 @@
 /*!
- * scanonweb v1.0.1
+ * scanonweb v1.0.3
  * ScanOnWeb - 扫描控件 JavaScript SDK，用于与本地扫描服务程序通信
  * https://www.brainysoft.cn
  * 
- * Copyright (c) 2025 BrainySoft
+ * Copyright (c) 2026 BrainySoft
  * Licensed under the MIT license
  */
 'use strict';
@@ -11,7 +11,7 @@
 /**
  * ScanOnWeb - 扫描控件 JavaScript SDK
  * https://www.brainysoft.cn   扫描控件官方网站,如需更多文档帮助请访问官网
- * @version 1.0.1
+ * @version 1.0.3
  * @author BrainySoft
  * @license MIT
  */
@@ -204,6 +204,15 @@ class ScanOnWeb {
           }
           break;
         }
+      case "loadImageFromBase64":
+        {
+          // 从Base64数据加载图片
+          this.imageCount = msg.imageCount;
+          if (this.isCallbackExist(this.onLoadImageFromBase64Event)) {
+            this.onLoadImageFromBase64Event(msg);
+          }
+          break;
+        }
       case "rotateImage":
         {
           // 旋转图片
@@ -385,12 +394,56 @@ class ScanOnWeb {
 
   /**
    * 发送指令远程加载服务器端的多页图像到托盘服务
+   * 支持PDF、TIFF以及常见图像格式（JPG、PNG、BMP等）
    * @param {string} url - 图像URL
+   * @param {string} [type] - 可选，指定文件类型：'pdf'、'tiff'、'image'，如果不指定则根据URL扩展名自动判断
    */
-  loadImageFromUrl(url) {
+  loadImageFromUrl(url, type) {
+    // 如果没有指定类型，则根据URL扩展名自动判断
+    if (!type) {
+      const extension = url.split('.').pop().toLowerCase();
+      if (extension === 'pdf') {
+        type = 'pdf';
+      } else if (extension === 'tiff' || extension === 'tif') {
+        type = 'tiff';
+      } else if (['jpg', 'jpeg', 'png', 'bmp', 'gif', 'webp'].includes(extension)) {
+        type = 'image';
+      } else {
+        // 默认当作普通图像处理
+        type = 'image';
+      }
+    }
     const cmdObj = {
       cmd_type: "loadImageFromUrl",
-      url: url
+      url: url,
+      type: type
+    };
+    this.sendWebSocketCommand(cmdObj);
+  }
+
+  /**
+   * 发送指令从Base64编码数据加载图像到托盘服务
+   * @param {string} base64Data - Base64编码的图像数据（不包含data:image/xxx;base64,前缀）
+   * @param {string} [format='jpg'] - 图像格式，如：'jpg'、'png'、'bmp'等，默认为'jpg'
+   */
+  loadImageFromBase64(base64Data, format = 'jpg') {
+    // 如果base64数据包含data URL前缀，则去除它
+    if (base64Data.startsWith('data:')) {
+      const base64Index = base64Data.indexOf('base64,');
+      if (base64Index !== -1) {
+        // 尝试从data URL中提取格式信息
+        const mimeMatch = base64Data.match(/data:image\/(\w+);/);
+        if (mimeMatch && mimeMatch[1] && !format) {
+          format = mimeMatch[1] === 'jpeg' ? 'jpg' : mimeMatch[1];
+        }
+        // 提取纯Base64数据
+        base64Data = base64Data.substring(base64Index + 7);
+      }
+    }
+    const cmdObj = {
+      cmd_type: "loadImageFromBase64",
+      base64Data: base64Data,
+      format: format
     };
     this.sendWebSocketCommand(cmdObj);
   }
@@ -433,6 +486,20 @@ class ScanOnWeb {
     this.sendWebSocketCommand(cmdObj);
   }
 
+  /**
+   * 前端调整扫描结果图像顺序
+   * @param {number} oldIndex - 原图像索引
+   * @param {number} newIndex - 目标图像索引
+   */
+  moveImage(oldIndex, newIndex) {
+    const cmdObj = {
+      cmd_type: "moveImage",
+      oldIndex: oldIndex,
+      newIndex: newIndex
+    };
+    this.sendWebSocketCommand(cmdObj);
+  }
+
   /**
    * 以pdf格式上传全部图像到服务器端
    * @param {string} url - 上传URL
@@ -565,6 +632,79 @@ class ScanOnWeb {
   closeWebSocket() {
     this.h5socket.close();
   }
+
+  /**
+   * 批量从Base64数据加载多个图像
+   * @param {Array} base64Images - Base64图像数组，每个元素为 {data: 'base64字符串', format: '格式'}
+   */
+  loadMultipleImagesFromBase64(base64Images) {
+    if (!Array.isArray(base64Images) || base64Images.length === 0) {
+      console.error('loadMultipleImagesFromBase64: 参数必须是非空数组');
+      return;
+    }
+
+    // 逐个加载图像
+    base64Images.forEach((image, index) => {
+      setTimeout(() => {
+        this.loadImageFromBase64(image.data, image.format || 'jpg');
+      }, index * 100); // 每个图像间隔100ms，避免同时发送过多数据
+    });
+  }
+
+  /**
+   * 从Canvas元素加载图像
+   * @param {HTMLCanvasElement} canvas - Canvas元素
+   * @param {string} [format='jpg'] - 图像格式
+   * @param {number} [quality=0.9] - 图像质量（0-1之间，仅对jpg格式有效）
+   */
+  loadImageFromCanvas(canvas, format = 'jpg', quality = 0.9) {
+    if (!canvas || !(canvas instanceof HTMLCanvasElement)) {
+      console.error('loadImageFromCanvas: 参数必须是有效的Canvas元素');
+      return;
+    }
+
+    // 将Canvas转换为Base64
+    const mimeType = format === 'jpg' ? 'image/jpeg' : `image/${format}`;
+    const dataUrl = canvas.toDataURL(mimeType, quality);
+
+    // 提取Base64数据部分
+    const base64Data = dataUrl.split(',')[1];
+
+    // 调用Base64加载方法
+    this.loadImageFromBase64(base64Data, format);
+  }
+
+  /**
+   * 从文件输入元素加载图像
+   * @param {HTMLInputElement} fileInput - 文件输入元素
+   */
+  loadImageFromFileInput(fileInput) {
+    if (!fileInput || !fileInput.files || fileInput.files.length === 0) {
+      console.error('loadImageFromFileInput: 没有选择文件');
+      return;
+    }
+    const files = Array.from(fileInput.files);
+    files.forEach((file, index) => {
+      // 检查是否为图像文件
+      if (!file.type.startsWith('image/')) {
+        console.warn(`跳过非图像文件: ${file.name}`);
+        return;
+      }
+      const reader = new FileReader();
+      reader.onload = e => {
+        const dataUrl = e.target.result;
+        // 获取文件扩展名
+        const extension = file.name.split('.').pop().toLowerCase();
+        const format = extension === 'jpeg' ? 'jpg' : extension;
+
+        // 延迟加载，避免同时处理过多文件
+        setTimeout(() => {
+          this.loadImageFromBase64(dataUrl, format);
+        }, index * 100);
+      };
+      reader.readAsDataURL(file);
+    });
+  }
 }
 
 // CommonJS 兼容性导出

package/dist/scanonweb.esm.js

@@ -1,15 +1,15 @@
 /*!
- * scanonweb v1.0.1
+ * scanonweb v1.0.3
  * ScanOnWeb - 扫描控件 JavaScript SDK，用于与本地扫描服务程序通信
  * https://www.brainysoft.cn
  * 
- * Copyright (c) 2025 BrainySoft
+ * Copyright (c) 2026 BrainySoft
  * Licensed under the MIT license
  */
 /**
  * ScanOnWeb - 扫描控件 JavaScript SDK
  * https://www.brainysoft.cn   扫描控件官方网站,如需更多文档帮助请访问官网
- * @version 1.0.1
+ * @version 1.0.3
  * @author BrainySoft
  * @license MIT
  */
@@ -202,6 +202,15 @@ class ScanOnWeb {
           }
           break;
         }
+      case "loadImageFromBase64":
+        {
+          // 从Base64数据加载图片
+          this.imageCount = msg.imageCount;
+          if (this.isCallbackExist(this.onLoadImageFromBase64Event)) {
+            this.onLoadImageFromBase64Event(msg);
+          }
+          break;
+        }
       case "rotateImage":
         {
           // 旋转图片
@@ -383,12 +392,56 @@ class ScanOnWeb {
 
   /**
    * 发送指令远程加载服务器端的多页图像到托盘服务
+   * 支持PDF、TIFF以及常见图像格式（JPG、PNG、BMP等）
    * @param {string} url - 图像URL
+   * @param {string} [type] - 可选，指定文件类型：'pdf'、'tiff'、'image'，如果不指定则根据URL扩展名自动判断
    */
-  loadImageFromUrl(url) {
+  loadImageFromUrl(url, type) {
+    // 如果没有指定类型，则根据URL扩展名自动判断
+    if (!type) {
+      const extension = url.split('.').pop().toLowerCase();
+      if (extension === 'pdf') {
+        type = 'pdf';
+      } else if (extension === 'tiff' || extension === 'tif') {
+        type = 'tiff';
+      } else if (['jpg', 'jpeg', 'png', 'bmp', 'gif', 'webp'].includes(extension)) {
+        type = 'image';
+      } else {
+        // 默认当作普通图像处理
+        type = 'image';
+      }
+    }
     const cmdObj = {
       cmd_type: "loadImageFromUrl",
-      url: url
+      url: url,
+      type: type
+    };
+    this.sendWebSocketCommand(cmdObj);
+  }
+
+  /**
+   * 发送指令从Base64编码数据加载图像到托盘服务
+   * @param {string} base64Data - Base64编码的图像数据（不包含data:image/xxx;base64,前缀）
+   * @param {string} [format='jpg'] - 图像格式，如：'jpg'、'png'、'bmp'等，默认为'jpg'
+   */
+  loadImageFromBase64(base64Data, format = 'jpg') {
+    // 如果base64数据包含data URL前缀，则去除它
+    if (base64Data.startsWith('data:')) {
+      const base64Index = base64Data.indexOf('base64,');
+      if (base64Index !== -1) {
+        // 尝试从data URL中提取格式信息
+        const mimeMatch = base64Data.match(/data:image\/(\w+);/);
+        if (mimeMatch && mimeMatch[1] && !format) {
+          format = mimeMatch[1] === 'jpeg' ? 'jpg' : mimeMatch[1];
+        }
+        // 提取纯Base64数据
+        base64Data = base64Data.substring(base64Index + 7);
+      }
+    }
+    const cmdObj = {
+      cmd_type: "loadImageFromBase64",
+      base64Data: base64Data,
+      format: format
     };
     this.sendWebSocketCommand(cmdObj);
   }
@@ -431,6 +484,20 @@ class ScanOnWeb {
     this.sendWebSocketCommand(cmdObj);
   }
 
+  /**
+   * 前端调整扫描结果图像顺序
+   * @param {number} oldIndex - 原图像索引
+   * @param {number} newIndex - 目标图像索引
+   */
+  moveImage(oldIndex, newIndex) {
+    const cmdObj = {
+      cmd_type: "moveImage",
+      oldIndex: oldIndex,
+      newIndex: newIndex
+    };
+    this.sendWebSocketCommand(cmdObj);
+  }
+
   /**
    * 以pdf格式上传全部图像到服务器端
    * @param {string} url - 上传URL
@@ -563,6 +630,79 @@ class ScanOnWeb {
   closeWebSocket() {
     this.h5socket.close();
   }
+
+  /**
+   * 批量从Base64数据加载多个图像
+   * @param {Array} base64Images - Base64图像数组，每个元素为 {data: 'base64字符串', format: '格式'}
+   */
+  loadMultipleImagesFromBase64(base64Images) {
+    if (!Array.isArray(base64Images) || base64Images.length === 0) {
+      console.error('loadMultipleImagesFromBase64: 参数必须是非空数组');
+      return;
+    }
+
+    // 逐个加载图像
+    base64Images.forEach((image, index) => {
+      setTimeout(() => {
+        this.loadImageFromBase64(image.data, image.format || 'jpg');
+      }, index * 100); // 每个图像间隔100ms，避免同时发送过多数据
+    });
+  }
+
+  /**
+   * 从Canvas元素加载图像
+   * @param {HTMLCanvasElement} canvas - Canvas元素
+   * @param {string} [format='jpg'] - 图像格式
+   * @param {number} [quality=0.9] - 图像质量（0-1之间，仅对jpg格式有效）
+   */
+  loadImageFromCanvas(canvas, format = 'jpg', quality = 0.9) {
+    if (!canvas || !(canvas instanceof HTMLCanvasElement)) {
+      console.error('loadImageFromCanvas: 参数必须是有效的Canvas元素');
+      return;
+    }
+
+    // 将Canvas转换为Base64
+    const mimeType = format === 'jpg' ? 'image/jpeg' : `image/${format}`;
+    const dataUrl = canvas.toDataURL(mimeType, quality);
+
+    // 提取Base64数据部分
+    const base64Data = dataUrl.split(',')[1];
+
+    // 调用Base64加载方法
+    this.loadImageFromBase64(base64Data, format);
+  }
+
+  /**
+   * 从文件输入元素加载图像
+   * @param {HTMLInputElement} fileInput - 文件输入元素
+   */
+  loadImageFromFileInput(fileInput) {
+    if (!fileInput || !fileInput.files || fileInput.files.length === 0) {
+      console.error('loadImageFromFileInput: 没有选择文件');
+      return;
+    }
+    const files = Array.from(fileInput.files);
+    files.forEach((file, index) => {
+      // 检查是否为图像文件
+      if (!file.type.startsWith('image/')) {
+        console.warn(`跳过非图像文件: ${file.name}`);
+        return;
+      }
+      const reader = new FileReader();
+      reader.onload = e => {
+        const dataUrl = e.target.result;
+        // 获取文件扩展名
+        const extension = file.name.split('.').pop().toLowerCase();
+        const format = extension === 'jpeg' ? 'jpg' : extension;
+
+        // 延迟加载，避免同时处理过多文件
+        setTimeout(() => {
+          this.loadImageFromBase64(dataUrl, format);
+        }, index * 100);
+      };
+      reader.readAsDataURL(file);
+    });
+  }
 }
 
 // CommonJS 兼容性导出

package/dist/scanonweb.umd.js

@@ -1,9 +1,9 @@
 /*!
- * scanonweb v1.0.1
+ * scanonweb v1.0.3
  * ScanOnWeb - 扫描控件 JavaScript SDK，用于与本地扫描服务程序通信
  * https://www.brainysoft.cn
  * 
- * Copyright (c) 2025 BrainySoft
+ * Copyright (c) 2026 BrainySoft
  * Licensed under the MIT license
  */
 (function (global, factory) {
@@ -15,7 +15,7 @@
   /**
    * ScanOnWeb - 扫描控件 JavaScript SDK
    * https://www.brainysoft.cn   扫描控件官方网站,如需更多文档帮助请访问官网
-   * @version 1.0.1
+   * @version 1.0.3
    * @author BrainySoft
    * @license MIT
    */
@@ -208,6 +208,15 @@
             }
             break;
           }
+        case "loadImageFromBase64":
+          {
+            // 从Base64数据加载图片
+            this.imageCount = msg.imageCount;
+            if (this.isCallbackExist(this.onLoadImageFromBase64Event)) {
+              this.onLoadImageFromBase64Event(msg);
+            }
+            break;
+          }
         case "rotateImage":
           {
             // 旋转图片
@@ -389,12 +398,56 @@
 
     /**
      * 发送指令远程加载服务器端的多页图像到托盘服务
+     * 支持PDF、TIFF以及常见图像格式（JPG、PNG、BMP等）
      * @param {string} url - 图像URL
+     * @param {string} [type] - 可选，指定文件类型：'pdf'、'tiff'、'image'，如果不指定则根据URL扩展名自动判断
      */
-    loadImageFromUrl(url) {
+    loadImageFromUrl(url, type) {
+      // 如果没有指定类型，则根据URL扩展名自动判断
+      if (!type) {
+        const extension = url.split('.').pop().toLowerCase();
+        if (extension === 'pdf') {
+          type = 'pdf';
+        } else if (extension === 'tiff' || extension === 'tif') {
+          type = 'tiff';
+        } else if (['jpg', 'jpeg', 'png', 'bmp', 'gif', 'webp'].includes(extension)) {
+          type = 'image';
+        } else {
+          // 默认当作普通图像处理
+          type = 'image';
+        }
+      }
       const cmdObj = {
         cmd_type: "loadImageFromUrl",
-        url: url
+        url: url,
+        type: type
+      };
+      this.sendWebSocketCommand(cmdObj);
+    }
+
+    /**
+     * 发送指令从Base64编码数据加载图像到托盘服务
+     * @param {string} base64Data - Base64编码的图像数据（不包含data:image/xxx;base64,前缀）
+     * @param {string} [format='jpg'] - 图像格式，如：'jpg'、'png'、'bmp'等，默认为'jpg'
+     */
+    loadImageFromBase64(base64Data, format = 'jpg') {
+      // 如果base64数据包含data URL前缀，则去除它
+      if (base64Data.startsWith('data:')) {
+        const base64Index = base64Data.indexOf('base64,');
+        if (base64Index !== -1) {
+          // 尝试从data URL中提取格式信息
+          const mimeMatch = base64Data.match(/data:image\/(\w+);/);
+          if (mimeMatch && mimeMatch[1] && !format) {
+            format = mimeMatch[1] === 'jpeg' ? 'jpg' : mimeMatch[1];
+          }
+          // 提取纯Base64数据
+          base64Data = base64Data.substring(base64Index + 7);
+        }
+      }
+      const cmdObj = {
+        cmd_type: "loadImageFromBase64",
+        base64Data: base64Data,
+        format: format
       };
       this.sendWebSocketCommand(cmdObj);
     }
@@ -437,6 +490,20 @@
       this.sendWebSocketCommand(cmdObj);
     }
 
+    /**
+     * 前端调整扫描结果图像顺序
+     * @param {number} oldIndex - 原图像索引
+     * @param {number} newIndex - 目标图像索引
+     */
+    moveImage(oldIndex, newIndex) {
+      const cmdObj = {
+        cmd_type: "moveImage",
+        oldIndex: oldIndex,
+        newIndex: newIndex
+      };
+      this.sendWebSocketCommand(cmdObj);
+    }
+
     /**
      * 以pdf格式上传全部图像到服务器端
      * @param {string} url - 上传URL
@@ -569,6 +636,79 @@
     closeWebSocket() {
       this.h5socket.close();
     }
+
+    /**
+     * 批量从Base64数据加载多个图像
+     * @param {Array} base64Images - Base64图像数组，每个元素为 {data: 'base64字符串', format: '格式'}
+     */
+    loadMultipleImagesFromBase64(base64Images) {
+      if (!Array.isArray(base64Images) || base64Images.length === 0) {
+        console.error('loadMultipleImagesFromBase64: 参数必须是非空数组');
+        return;
+      }
+
+      // 逐个加载图像
+      base64Images.forEach((image, index) => {
+        setTimeout(() => {
+          this.loadImageFromBase64(image.data, image.format || 'jpg');
+        }, index * 100); // 每个图像间隔100ms，避免同时发送过多数据
+      });
+    }
+
+    /**
+     * 从Canvas元素加载图像
+     * @param {HTMLCanvasElement} canvas - Canvas元素
+     * @param {string} [format='jpg'] - 图像格式
+     * @param {number} [quality=0.9] - 图像质量（0-1之间，仅对jpg格式有效）
+     */
+    loadImageFromCanvas(canvas, format = 'jpg', quality = 0.9) {
+      if (!canvas || !(canvas instanceof HTMLCanvasElement)) {
+        console.error('loadImageFromCanvas: 参数必须是有效的Canvas元素');
+        return;
+      }
+
+      // 将Canvas转换为Base64
+      const mimeType = format === 'jpg' ? 'image/jpeg' : `image/${format}`;
+      const dataUrl = canvas.toDataURL(mimeType, quality);
+
+      // 提取Base64数据部分
+      const base64Data = dataUrl.split(',')[1];
+
+      // 调用Base64加载方法
+      this.loadImageFromBase64(base64Data, format);
+    }
+
+    /**
+     * 从文件输入元素加载图像
+     * @param {HTMLInputElement} fileInput - 文件输入元素
+     */
+    loadImageFromFileInput(fileInput) {
+      if (!fileInput || !fileInput.files || fileInput.files.length === 0) {
+        console.error('loadImageFromFileInput: 没有选择文件');
+        return;
+      }
+      const files = Array.from(fileInput.files);
+      files.forEach((file, index) => {
+        // 检查是否为图像文件
+        if (!file.type.startsWith('image/')) {
+          console.warn(`跳过非图像文件: ${file.name}`);
+          return;
+        }
+        const reader = new FileReader();
+        reader.onload = e => {
+          const dataUrl = e.target.result;
+          // 获取文件扩展名
+          const extension = file.name.split('.').pop().toLowerCase();
+          const format = extension === 'jpeg' ? 'jpg' : extension;
+
+          // 延迟加载，避免同时处理过多文件
+          setTimeout(() => {
+            this.loadImageFromBase64(dataUrl, format);
+          }, index * 100);
+        };
+        reader.readAsDataURL(file);
+      });
+    }
   }
 
   // CommonJS 兼容性导出

package/dist/scanonweb.umd.min.js

@@ -1,9 +1,9 @@
 /*!
- * scanonweb v1.0.1
+ * scanonweb v1.0.3
  * ScanOnWeb - 扫描控件 JavaScript SDK，用于与本地扫描服务程序通信
  * https://www.brainysoft.cn
  * 
- * Copyright (c) 2025 BrainySoft
+ * Copyright (c) 2026 BrainySoft
  * Licensed under the MIT license
  */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).ScanOnWeb=t()}(this,(function(){"use strict";class e{constructor(){this.scaner_work_config={showUI:!1,dpi_x:300,dpi_y:300,deviceIndex:0,showDialog:!1,autoFeedEnable:!0,autoFeed:!1,dupxMode:!1,autoDeskew:!1,autoBorderDetection:!1,colorMode:"RGB",transMode:"memory"},this.h5socket=null,this.imageCount=0,this.tryConnect()}getConnectedServer(e){return console.log("尝试连接托盘扫描服务websocket服务器..."),new Promise(((t,o)=>{const s=new WebSocket(e[0]);s.onopen=()=>{t(s)},s.onerror=e=>{o(e)}})).then((e=>(console.log("连接websocket服务器成功!"),this.initWebsocketCallback(e),console.log("尝试获取扫描设备列表..."),this.loadDevices(),e)),(t=>{if(e.length>1)return this.getConnectedServer(e.slice(1));throw t}))}tryConnect(){this.getConnectedServer(["ws://127.0.0.1:1001","ws://127.0.0.1:2001","ws://127.0.0.1:3001","ws://127.0.0.1:4001","ws://127.0.0.1:5001"])}initWebsocketCallback(e){this.h5socket=e,this.h5socket.onerror=this.onSocketError.bind(this),this.h5socket.onmessage=this.onSocketMessage.bind(this)}onSocketError(e){alert("无法连接扫描服务程序,请检查扫描服务程序是否已经启动！"),console.log("WebSocket error: "+e.data)}isCallbackExist(e){return!(!e||void 0===e||void 0===e)&&"function"==typeof e}onSocketMessage(e){const t=JSON.parse(e.data);switch(t.cmd_type){case"getDevicesList":this.isCallbackExist(this.onGetDevicesListEvent)&&this.onGetDevicesListEvent(t);break;case"scanComplete":this.imageCount=t.imageCount,this.isCallbackExist(this.onScanFinishedEvent)&&this.onScanFinishedEvent(t);break;case"selectScanDevice":this.scaner_work_config.deviceIndex=t.currentIndex,this.scaner_work_config.showDialog=t.showDialog,this.scaner_work_config.autoFeedEnable=t.autoFeedEnable,this.scaner_work_config.autoFeed=t.autoFeed,this.scaner_work_config.dupxMode=t.dupxMode,this.scaner_work_config.autoDeskew=t.autoDeskew,this.scaner_work_config.autoBorderDetection=t.autoBorderDetection,this.isCallbackExist(this.onSelectScanDeviceEvent)&&this.onSelectScanDeviceEvent(t);break;case"getImageCount":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetImageCountEvent)&&this.onGetImageCountEvent(t);break;case"getAllImage":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetAllImageEvent)&&this.onGetAllImageEvent(t);break;case"getImageById":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetImageByIdEvent)&&this.onGetImageByIdEvent(t);break;case"loadImageFromUrl":this.imageCount=t.imageCount,this.isCallbackExist(this.onLoadImageFromUrlEvent)&&this.onLoadImageFromUrlEvent(t);break;case"rotateImage":this.imageCount=t.imageCount,this.isCallbackExist(this.onRotateImageEvent)&&this.onRotateImageEvent(t);break;case"getImageSize":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetImageSizeEvent)&&this.onGetImageSizeEvent(t);break;case"uploadAllImageAsPdfToUrl":this.isCallbackExist(this.onUploadAllImageAsPdfToUrlEvent)&&this.onUploadAllImageAsPdfToUrlEvent(t);break;case"uploadAllImageAsTiffToUrl":this.isCallbackExist(this.onUploadAllImageAsTiffToUrlEvent)&&this.onUploadAllImageAsTiffToUrlEvent(t);break;case"uploadJpgImageByIndex":this.isCallbackExist(this.onUploadJpgImageByIndexEvent)&&this.onUploadJpgImageByIndexEvent(t);break;case"upload":this.imageCount=t.imageCount,this.isCallbackExist(this.onUploadEvent)&&this.onUploadEvent(t);break;case"imageEdited":this.isCallbackExist(this.onImageEditedEvent)&&this.onImageEditedEvent(t);break;case"imageDrap":this.isCallbackExist(this.onImageDrapEvent)&&this.onImageDrapEvent(t)}}sendWebSocketCommand(e){try{1===this.h5socket.readyState?this.h5socket.send(JSON.stringify(e)):alert("发送扫描指令失败！请刷新页面或者检查托盘扫描程序是否已经正常运行!")}catch(e){alert("发送扫描指令失败！"+e)}}setLicenseKey(e,t,o,s){const n={cmd_type:"setLicenseKey",licenseMode:e,key1:t,key2:o,url:s};this.sendWebSocketCommand(n)}loadDevices(){this.sendWebSocketCommand({cmd_type:"getDevicesList"})}selectScanDevice(e){const t={cmd_type:"selectScanDevice",deviceIndex:e};this.sendWebSocketCommand(t)}startScan(){const e={cmd_type:"startScan",config:this.scaner_work_config};this.sendWebSocketCommand(e)}clearAll(){this.sendWebSocketCommand({cmd_type:"clearAll"})}getImageCount(){this.sendWebSocketCommand({cmd_type:"getImageCount"})}getAllImage(){this.sendWebSocketCommand({cmd_type:"getAllImage"})}getImageById(e){const t={cmd_type:"getImageById",index:e};this.sendWebSocketCommand(t)}loadImageFromUrl(e){const t={cmd_type:"loadImageFromUrl",url:e};this.sendWebSocketCommand(t)}rotateImage(e,t){const o={cmd_type:"rotateImage",index:e,angle:t};this.sendWebSocketCommand(o)}getImageSize(e){const t={cmd_type:"getImageSize",index:e};this.sendWebSocketCommand(t)}deleteImageByIndex(e){const t={cmd_type:"deleteImageByIndex",index:e};this.sendWebSocketCommand(t)}uploadAllImageAsPdfToUrl(e,t,o){const s={cmd_type:"uploadAllImageAsPdfToUrl",url:e,id:t,desc:o};this.sendWebSocketCommand(s)}uploadAllImageAsTiffToUrl(e,t,o){const s={cmd_type:"uploadAllImageAsTiffToUrl",url:e,id:t,desc:o};this.sendWebSocketCommand(s)}uploadJpgImageByIndex(e,t,o,s){const n={cmd_type:"uploadJpgImageByIndex",index:s,url:e,id:t,desc:o};this.sendWebSocketCommand(n)}saveAllImageToLocal(e){const t={cmd_type:"saveAllImageToLocal",filename:e};this.sendWebSocketCommand(t)}openClientLocalfile(){this.sendWebSocketCommand({cmd_type:"openClientLocalfile"})}ftpUploadAllImage(e,t,o,s,n,a){const i={cmd_type:"ftpUploadAllImage",serverIp:e,port:t,username:o,password:s,serverPath:n,filename:a};this.sendWebSocketCommand(i)}setUploadButtonVisible(e){const t={cmd_type:"setUploadButtonVisible",visible:e};this.sendWebSocketCommand(t)}setFocus(){this.sendWebSocketCommand({cmd_type:"focus"})}hidden(){this.sendWebSocketCommand({cmd_type:"hidden"})}closeWebSocket(){this.h5socket.close()}}return"undefined"!=typeof module&&module.exports&&(module.exports=e),"undefined"!=typeof window&&(window.ScanOnWeb=e),e}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).ScanOnWeb=t()}(this,(function(){"use strict";class e{constructor(){this.scaner_work_config={showUI:!1,dpi_x:300,dpi_y:300,deviceIndex:0,showDialog:!1,autoFeedEnable:!0,autoFeed:!1,dupxMode:!1,autoDeskew:!1,autoBorderDetection:!1,colorMode:"RGB",transMode:"memory"},this.h5socket=null,this.imageCount=0,this.tryConnect()}getConnectedServer(e){return console.log("尝试连接托盘扫描服务websocket服务器..."),new Promise(((t,o)=>{const a=new WebSocket(e[0]);a.onopen=()=>{t(a)},a.onerror=e=>{o(e)}})).then((e=>(console.log("连接websocket服务器成功!"),this.initWebsocketCallback(e),console.log("尝试获取扫描设备列表..."),this.loadDevices(),e)),(t=>{if(e.length>1)return this.getConnectedServer(e.slice(1));throw t}))}tryConnect(){this.getConnectedServer(["ws://127.0.0.1:1001","ws://127.0.0.1:2001","ws://127.0.0.1:3001","ws://127.0.0.1:4001","ws://127.0.0.1:5001"])}initWebsocketCallback(e){this.h5socket=e,this.h5socket.onerror=this.onSocketError.bind(this),this.h5socket.onmessage=this.onSocketMessage.bind(this)}onSocketError(e){alert("无法连接扫描服务程序,请检查扫描服务程序是否已经启动！"),console.log("WebSocket error: "+e.data)}isCallbackExist(e){return!(!e||void 0===e||void 0===e)&&"function"==typeof e}onSocketMessage(e){const t=JSON.parse(e.data);switch(t.cmd_type){case"getDevicesList":this.isCallbackExist(this.onGetDevicesListEvent)&&this.onGetDevicesListEvent(t);break;case"scanComplete":this.imageCount=t.imageCount,this.isCallbackExist(this.onScanFinishedEvent)&&this.onScanFinishedEvent(t);break;case"selectScanDevice":this.scaner_work_config.deviceIndex=t.currentIndex,this.scaner_work_config.showDialog=t.showDialog,this.scaner_work_config.autoFeedEnable=t.autoFeedEnable,this.scaner_work_config.autoFeed=t.autoFeed,this.scaner_work_config.dupxMode=t.dupxMode,this.scaner_work_config.autoDeskew=t.autoDeskew,this.scaner_work_config.autoBorderDetection=t.autoBorderDetection,this.isCallbackExist(this.onSelectScanDeviceEvent)&&this.onSelectScanDeviceEvent(t);break;case"getImageCount":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetImageCountEvent)&&this.onGetImageCountEvent(t);break;case"getAllImage":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetAllImageEvent)&&this.onGetAllImageEvent(t);break;case"getImageById":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetImageByIdEvent)&&this.onGetImageByIdEvent(t);break;case"loadImageFromUrl":this.imageCount=t.imageCount,this.isCallbackExist(this.onLoadImageFromUrlEvent)&&this.onLoadImageFromUrlEvent(t);break;case"loadImageFromBase64":this.imageCount=t.imageCount,this.isCallbackExist(this.onLoadImageFromBase64Event)&&this.onLoadImageFromBase64Event(t);break;case"rotateImage":this.imageCount=t.imageCount,this.isCallbackExist(this.onRotateImageEvent)&&this.onRotateImageEvent(t);break;case"getImageSize":this.imageCount=t.imageCount,this.isCallbackExist(this.onGetImageSizeEvent)&&this.onGetImageSizeEvent(t);break;case"uploadAllImageAsPdfToUrl":this.isCallbackExist(this.onUploadAllImageAsPdfToUrlEvent)&&this.onUploadAllImageAsPdfToUrlEvent(t);break;case"uploadAllImageAsTiffToUrl":this.isCallbackExist(this.onUploadAllImageAsTiffToUrlEvent)&&this.onUploadAllImageAsTiffToUrlEvent(t);break;case"uploadJpgImageByIndex":this.isCallbackExist(this.onUploadJpgImageByIndexEvent)&&this.onUploadJpgImageByIndexEvent(t);break;case"upload":this.imageCount=t.imageCount,this.isCallbackExist(this.onUploadEvent)&&this.onUploadEvent(t);break;case"imageEdited":this.isCallbackExist(this.onImageEditedEvent)&&this.onImageEditedEvent(t);break;case"imageDrap":this.isCallbackExist(this.onImageDrapEvent)&&this.onImageDrapEvent(t)}}sendWebSocketCommand(e){try{1===this.h5socket.readyState?this.h5socket.send(JSON.stringify(e)):alert("发送扫描指令失败！请刷新页面或者检查托盘扫描程序是否已经正常运行!")}catch(e){alert("发送扫描指令失败！"+e)}}setLicenseKey(e,t,o,a){const s={cmd_type:"setLicenseKey",licenseMode:e,key1:t,key2:o,url:a};this.sendWebSocketCommand(s)}loadDevices(){this.sendWebSocketCommand({cmd_type:"getDevicesList"})}selectScanDevice(e){const t={cmd_type:"selectScanDevice",deviceIndex:e};this.sendWebSocketCommand(t)}startScan(){const e={cmd_type:"startScan",config:this.scaner_work_config};this.sendWebSocketCommand(e)}clearAll(){this.sendWebSocketCommand({cmd_type:"clearAll"})}getImageCount(){this.sendWebSocketCommand({cmd_type:"getImageCount"})}getAllImage(){this.sendWebSocketCommand({cmd_type:"getAllImage"})}getImageById(e){const t={cmd_type:"getImageById",index:e};this.sendWebSocketCommand(t)}loadImageFromUrl(e,t){if(!t){const o=e.split(".").pop().toLowerCase();t="pdf"===o?"pdf":"tiff"===o||"tif"===o?"tiff":(["jpg","jpeg","png","bmp","gif","webp"].includes(o),"image")}const o={cmd_type:"loadImageFromUrl",url:e,type:t};this.sendWebSocketCommand(o)}loadImageFromBase64(e,t="jpg"){if(e.startsWith("data:")){const o=e.indexOf("base64,");if(-1!==o){const a=e.match(/data:image\/(\w+);/);a&&a[1]&&!t&&(t="jpeg"===a[1]?"jpg":a[1]),e=e.substring(o+7)}}const o={cmd_type:"loadImageFromBase64",base64Data:e,format:t};this.sendWebSocketCommand(o)}rotateImage(e,t){const o={cmd_type:"rotateImage",index:e,angle:t};this.sendWebSocketCommand(o)}getImageSize(e){const t={cmd_type:"getImageSize",index:e};this.sendWebSocketCommand(t)}deleteImageByIndex(e){const t={cmd_type:"deleteImageByIndex",index:e};this.sendWebSocketCommand(t)}moveImage(e,t){const o={cmd_type:"moveImage",oldIndex:e,newIndex:t};this.sendWebSocketCommand(o)}uploadAllImageAsPdfToUrl(e,t,o){const a={cmd_type:"uploadAllImageAsPdfToUrl",url:e,id:t,desc:o};this.sendWebSocketCommand(a)}uploadAllImageAsTiffToUrl(e,t,o){const a={cmd_type:"uploadAllImageAsTiffToUrl",url:e,id:t,desc:o};this.sendWebSocketCommand(a)}uploadJpgImageByIndex(e,t,o,a){const s={cmd_type:"uploadJpgImageByIndex",index:a,url:e,id:t,desc:o};this.sendWebSocketCommand(s)}saveAllImageToLocal(e){const t={cmd_type:"saveAllImageToLocal",filename:e};this.sendWebSocketCommand(t)}openClientLocalfile(){this.sendWebSocketCommand({cmd_type:"openClientLocalfile"})}ftpUploadAllImage(e,t,o,a,s,n){const i={cmd_type:"ftpUploadAllImage",serverIp:e,port:t,username:o,password:a,serverPath:s,filename:n};this.sendWebSocketCommand(i)}setUploadButtonVisible(e){const t={cmd_type:"setUploadButtonVisible",visible:e};this.sendWebSocketCommand(t)}setFocus(){this.sendWebSocketCommand({cmd_type:"focus"})}hidden(){this.sendWebSocketCommand({cmd_type:"hidden"})}closeWebSocket(){this.h5socket.close()}loadMultipleImagesFromBase64(e){Array.isArray(e)&&0!==e.length?e.forEach(((e,t)=>{setTimeout((()=>{this.loadImageFromBase64(e.data,e.format||"jpg")}),100*t)})):console.error("loadMultipleImagesFromBase64: 参数必须是非空数组")}loadImageFromCanvas(e,t="jpg",o=.9){if(!(e&&e instanceof HTMLCanvasElement))return void console.error("loadImageFromCanvas: 参数必须是有效的Canvas元素");const a="jpg"===t?"image/jpeg":`image/${t}`,s=e.toDataURL(a,o).split(",")[1];this.loadImageFromBase64(s,t)}loadImageFromFileInput(e){if(!e||!e.files||0===e.files.length)return void console.error("loadImageFromFileInput: 没有选择文件");Array.from(e.files).forEach(((e,t)=>{if(!e.type.startsWith("image/"))return void console.warn(`跳过非图像文件: ${e.name}`);const o=new FileReader;o.onload=o=>{const a=o.target.result,s=e.name.split(".").pop().toLowerCase(),n="jpeg"===s?"jpg":s;setTimeout((()=>{this.loadImageFromBase64(a,n)}),100*t)},o.readAsDataURL(e)}))}}return"undefined"!=typeof module&&module.exports&&(module.exports=e),"undefined"!=typeof window&&(window.ScanOnWeb=e),e}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scanonweb",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "ScanOnWeb - 扫描控件 JavaScript SDK，用于与本地扫描服务程序通信",
   "main": "dist/scanonweb.cjs.js",
   "module": "dist/scanonweb.esm.js",

package/src/index.d.ts

@@ -196,6 +196,13 @@ export default class ScanOnWeb {
    */
   deleteImageByIndex(index: number): void;
 
+  /**
+   * 前端调整扫描结果图像顺序
+   * @param oldIndex 原图像索引
+   * @param newIndex 目标图像索引
+   */
+  moveImage(oldIndex: number, newIndex: number): void;
+
   /**
    * 以pdf格式上传全部图像到服务器端
    * @param url 上传URL

package/src/index.js

@@ -1,7 +1,7 @@
 /**
  * ScanOnWeb - 扫描控件 JavaScript SDK
  * https://www.brainysoft.cn   扫描控件官方网站,如需更多文档帮助请访问官网
- * @version 1.0.1
+ * @version 1.0.3
  * @author BrainySoft
  * @license MIT
  */
@@ -186,6 +186,14 @@ class ScanOnWeb {
         }
         break;
       }
+      case "loadImageFromBase64": {
+        // 从Base64数据加载图片
+        this.imageCount = msg.imageCount;
+        if (this.isCallbackExist(this.onLoadImageFromBase64Event)) {
+          this.onLoadImageFromBase64Event(msg);
+        }
+        break;
+      }
       case "rotateImage": {
         // 旋转图片
         this.imageCount = msg.imageCount;
@@ -361,12 +369,58 @@ class ScanOnWeb {
 
   /**
    * 发送指令远程加载服务器端的多页图像到托盘服务
+   * 支持PDF、TIFF以及常见图像格式（JPG、PNG、BMP等）
    * @param {string} url - 图像URL
+   * @param {string} [type] - 可选，指定文件类型：'pdf'、'tiff'、'image'，如果不指定则根据URL扩展名自动判断
    */
-  loadImageFromUrl(url) {
+  loadImageFromUrl(url, type) {
+    // 如果没有指定类型，则根据URL扩展名自动判断
+    if (!type) {
+      const extension = url.split('.').pop().toLowerCase();
+      if (extension === 'pdf') {
+        type = 'pdf';
+      } else if (extension === 'tiff' || extension === 'tif') {
+        type = 'tiff';
+      } else if (['jpg', 'jpeg', 'png', 'bmp', 'gif', 'webp'].includes(extension)) {
+        type = 'image';
+      } else {
+        // 默认当作普通图像处理
+        type = 'image';
+      }
+    }
+    
     const cmdObj = {
       cmd_type: "loadImageFromUrl",
       url: url,
+      type: type
+    };
+    this.sendWebSocketCommand(cmdObj);
+  }
+
+  /**
+   * 发送指令从Base64编码数据加载图像到托盘服务
+   * @param {string} base64Data - Base64编码的图像数据（不包含data:image/xxx;base64,前缀）
+   * @param {string} [format='jpg'] - 图像格式，如：'jpg'、'png'、'bmp'等，默认为'jpg'
+   */
+  loadImageFromBase64(base64Data, format = 'jpg') {
+    // 如果base64数据包含data URL前缀，则去除它
+    if (base64Data.startsWith('data:')) {
+      const base64Index = base64Data.indexOf('base64,');
+      if (base64Index !== -1) {
+        // 尝试从data URL中提取格式信息
+        const mimeMatch = base64Data.match(/data:image\/(\w+);/);
+        if (mimeMatch && mimeMatch[1] && !format) {
+          format = mimeMatch[1] === 'jpeg' ? 'jpg' : mimeMatch[1];
+        }
+        // 提取纯Base64数据
+        base64Data = base64Data.substring(base64Index + 7);
+      }
+    }
+    
+    const cmdObj = {
+      cmd_type: "loadImageFromBase64",
+      base64Data: base64Data,
+      format: format
     };
     this.sendWebSocketCommand(cmdObj);
   }
@@ -409,6 +463,20 @@ class ScanOnWeb {
     this.sendWebSocketCommand(cmdObj);
   }
 
+  /**
+   * 前端调整扫描结果图像顺序
+   * @param {number} oldIndex - 原图像索引
+   * @param {number} newIndex - 目标图像索引
+   */
+  moveImage(oldIndex, newIndex) {
+    const cmdObj = {
+      cmd_type: "moveImage",
+      oldIndex: oldIndex,
+      newIndex: newIndex,
+    };
+    this.sendWebSocketCommand(cmdObj);
+  }
+
   /**
    * 以pdf格式上传全部图像到服务器端
    * @param {string} url - 上传URL
@@ -541,6 +609,82 @@ class ScanOnWeb {
   closeWebSocket() {
     this.h5socket.close();
   }
+
+  /**
+   * 批量从Base64数据加载多个图像
+   * @param {Array} base64Images - Base64图像数组，每个元素为 {data: 'base64字符串', format: '格式'}
+   */
+  loadMultipleImagesFromBase64(base64Images) {
+    if (!Array.isArray(base64Images) || base64Images.length === 0) {
+      console.error('loadMultipleImagesFromBase64: 参数必须是非空数组');
+      return;
+    }
+    
+    // 逐个加载图像
+    base64Images.forEach((image, index) => {
+      setTimeout(() => {
+        this.loadImageFromBase64(image.data, image.format || 'jpg');
+      }, index * 100); // 每个图像间隔100ms，避免同时发送过多数据
+    });
+  }
+
+  /**
+   * 从Canvas元素加载图像
+   * @param {HTMLCanvasElement} canvas - Canvas元素
+   * @param {string} [format='jpg'] - 图像格式
+   * @param {number} [quality=0.9] - 图像质量（0-1之间，仅对jpg格式有效）
+   */
+  loadImageFromCanvas(canvas, format = 'jpg', quality = 0.9) {
+    if (!canvas || !(canvas instanceof HTMLCanvasElement)) {
+      console.error('loadImageFromCanvas: 参数必须是有效的Canvas元素');
+      return;
+    }
+    
+    // 将Canvas转换为Base64
+    const mimeType = format === 'jpg' ? 'image/jpeg' : `image/${format}`;
+    const dataUrl = canvas.toDataURL(mimeType, quality);
+    
+    // 提取Base64数据部分
+    const base64Data = dataUrl.split(',')[1];
+    
+    // 调用Base64加载方法
+    this.loadImageFromBase64(base64Data, format);
+  }
+
+  /**
+   * 从文件输入元素加载图像
+   * @param {HTMLInputElement} fileInput - 文件输入元素
+   */
+  loadImageFromFileInput(fileInput) {
+    if (!fileInput || !fileInput.files || fileInput.files.length === 0) {
+      console.error('loadImageFromFileInput: 没有选择文件');
+      return;
+    }
+    
+    const files = Array.from(fileInput.files);
+    
+    files.forEach((file, index) => {
+      // 检查是否为图像文件
+      if (!file.type.startsWith('image/')) {
+        console.warn(`跳过非图像文件: ${file.name}`);
+        return;
+      }
+      
+      const reader = new FileReader();
+      reader.onload = (e) => {
+        const dataUrl = e.target.result;
+        // 获取文件扩展名
+        const extension = file.name.split('.').pop().toLowerCase();
+        const format = extension === 'jpeg' ? 'jpg' : extension;
+        
+        // 延迟加载，避免同时处理过多文件
+        setTimeout(() => {
+          this.loadImageFromBase64(dataUrl, format);
+        }, index * 100);
+      };
+      reader.readAsDataURL(file);
+    });
+  }
 }
 
 // ES6 模块导出

package/dist/index.d.ts

@@ -1,266 +0,0 @@
-/**
- * ScanOnWeb - 扫描控件 JavaScript SDK
- * TypeScript 定义文件
- */
-
-/**
- * 扫描配置参数接口
- */
-export interface ScanConfig {
-  /** 是否显示扫描控件工作界面 */
-  showUI: boolean;
-  /** DPI 分辨率 X */
-  dpi_x: number;
-  /** DPI 分辨率 Y */
-  dpi_y: number;
-  /** 选中的扫描仪硬件设备id索引 */
-  deviceIndex: number;
-  /** 是否显示设备内置对话框 */
-  showDialog: boolean;
-  /** 是否使用自动进纸器 */
-  autoFeedEnable: boolean;
-  /** 是否自动装填纸张 */
-  autoFeed: boolean;
-  /** 是否使用双面扫描模式 */
-  dupxMode: boolean;
-  /** 是否使用自动纠偏模式 */
-  autoDeskew: boolean;
-  /** 是否使用自动边框检测 */
-  autoBorderDetection: boolean;
-  /** 色彩模式 */
-  colorMode: 'RGB' | 'BW' | 'GRAY';
-  /** 数据传输模式 */
-  transMode: 'memory' | 'file' | 'native';
-}
-
-/**
- * WebSocket 消息接口
- */
-export interface WebSocketMessage {
-  /** 命令类型 */
-  cmd_type: string;
-  /** 图像数量 */
-  imageCount?: number;
-  /** 当前设备索引 */
-  currentIndex?: number;
-  /** 其他属性 */
-  [key: string]: any;
-}
-
-/**
- * 扫描控件类
- */
-export default class ScanOnWeb {
-  /** 扫描配置参数 */
-  scaner_work_config: ScanConfig;
-  
-  /** WebSocket 连接对象 */
-  h5socket: WebSocket | null;
-  
-  /** 扫描结果图像总数 */
-  imageCount: number;
-
-  // 事件回调函数（可选）
-  onGetDevicesListEvent?: (msg: WebSocketMessage) => void;
-  onScanFinishedEvent?: (msg: WebSocketMessage) => void;
-  onSelectScanDeviceEvent?: (msg: WebSocketMessage) => void;
-  onGetImageCountEvent?: (msg: WebSocketMessage) => void;
-  onGetAllImageEvent?: (msg: WebSocketMessage) => void;
-  onGetImageByIdEvent?: (msg: WebSocketMessage) => void;
-  onLoadImageFromUrlEvent?: (msg: WebSocketMessage) => void;
-  onRotateImageEvent?: (msg: WebSocketMessage) => void;
-  onGetImageSizeEvent?: (msg: WebSocketMessage) => void;
-  onUploadAllImageAsPdfToUrlEvent?: (msg: WebSocketMessage) => void;
-  onUploadAllImageAsTiffToUrlEvent?: (msg: WebSocketMessage) => void;
-  onUploadJpgImageByIndexEvent?: (msg: WebSocketMessage) => void;
-  onUploadEvent?: (msg: WebSocketMessage) => void;
-  onImageEditedEvent?: (msg: WebSocketMessage) => void;
-  onImageDrapEvent?: (msg: WebSocketMessage) => void;
-
-  /**
-   * 构造函数
-   */
-  constructor();
-
-  /**
-   * 通过连接多个websocket server端口返回一个可用的websocket连接对象
-   * @param wssUrls WebSocket服务器URL数组
-   * @returns WebSocket连接Promise
-   */
-  getConnectedServer(wssUrls: string[]): Promise<WebSocket>;
-
-  /**
-   * 尝试检测websocket哪个端口可以成功连接
-   */
-  tryConnect(): void;
-
-  /**
-   * 初始化websocket相关的函数绑定
-   * @param server WebSocket服务器实例
-   */
-  initWebsocketCallback(server: WebSocket): void;
-
-  /**
-   * WebSocket错误处理
-   * @param event 错误事件
-   */
-  onSocketError(event: Event): void;
-
-  /**
-   * 判断回调函数是否存在
-   * @param f 要检查的函数
-   * @returns 函数是否存在且为函数类型
-   */
-  isCallbackExist(f: any): f is Function;
-
-  /**
-   * WebSocket消息处理
-   * @param event WebSocket消息事件
-   */
-  onSocketMessage(event: MessageEvent): void;
-
-  /**
-   * 通过websocket发送数据给webscoket服务端
-   * @param commandData 要发送的命令数据
-   */
-  sendWebSocketCommand(commandData: object): void;
-
-  /**
-   * 设置授权信息
-   * @param licenseMode 授权模式
-   * @param key1 授权密钥1
-   * @param key2 授权密钥2
-   * @param licenseServerUrl 授权服务器URL
-   */
-  setLicenseKey(licenseMode: string, key1: string, key2: string, licenseServerUrl: string): void;
-
-  /**
-   * 加载所有可用的扫描设备
-   */
-  loadDevices(): void;
-
-  /**
-   * 设置当前选中的扫描设备id
-   * @param deviceIndex 设备索引
-   */
-  selectScanDevice(deviceIndex: number): void;
-
-  /**
-   * 开始扫描
-   */
-  startScan(): void;
-
-  /**
-   * 清除全部扫描结果
-   */
-  clearAll(): void;
-
-  /**
-   * 获取图像总数
-   */
-  getImageCount(): void;
-
-  /**
-   * 获取所有图像
-   */
-  getAllImage(): void;
-
-  /**
-   * 发送指令获取某一页图像到托盘服务
-   * @param index 图像索引
-   */
-  getImageById(index: number): void;
-
-  /**
-   * 发送指令远程加载服务器端的多页图像到托盘服务
-   * @param url 图像URL
-   */
-  loadImageFromUrl(url: string): void;
-
-  /**
-   * 发送指令旋转某一页图像到托盘服务
-   * @param index 图像索引
-   * @param angle 旋转角度
-   */
-  rotateImage(index: number, angle: number): void;
-
-  /**
-   * 发送指令获取某一页图像的宽度到托盘服务
-   * @param index 图像索引
-   */
-  getImageSize(index: number): void;
-
-  /**
-   * 发送指令删除某一页图像到托盘服务
-   * @param index 图像索引
-   */
-  deleteImageByIndex(index: number): void;
-
-  /**
-   * 以pdf格式上传全部图像到服务器端
-   * @param url 上传URL
-   * @param id 标识ID
-   * @param desc 描述信息
-   */
-  uploadAllImageAsPdfToUrl(url: string, id: string, desc: string): void;
-
-  /**
-   * 以tiff格式上传全部图像到服务器端
-   * @param url 上传URL
-   * @param id 标识ID
-   * @param desc 描述信息
-   */
-  uploadAllImageAsTiffToUrl(url: string, id: string, desc: string): void;
-
-  /**
-   * 以jpg格式上传某一页图像到服务器端
-   * @param url 上传URL
-   * @param id 标识ID
-   * @param desc 描述信息
-   * @param index 图像索引
-   */
-  uploadJpgImageByIndex(url: string, id: string, desc: string, index: number): void;
-
-  /**
-   * 全部图像保存到客户端本地文件
-   * @param filename 文件名
-   */
-  saveAllImageToLocal(filename: string): void;
-
-  /**
-   * 从客户端本地读取图像,通过打开文件对话框选择图像文件
-   */
-  openClientLocalfile(): void;
-
-  /**
-   * ftp上传全部图像文件到服务器端
-   * @param serverIp 服务器IP
-   * @param port 端口
-   * @param username 用户名
-   * @param password 密码
-   * @param serverPath 服务器路径
-   * @param filename 文件名
-   */
-  ftpUploadAllImage(serverIp: string, port: number, username: string, password: string, serverPath: string, filename: string): void;
-
-  /**
-   * 设置上传按钮是否可见
-   * @param visible 是否可见
-   */
-  setUploadButtonVisible(visible: boolean): void;
-
-  /**
-   * 设置焦点
-   */
-  setFocus(): void;
-
-  /**
-   * 隐藏窗口
-   */
-  hidden(): void;
-
-  /**
-   * 关闭websocket连接
-   */
-  closeWebSocket(): void;
-}