Web Workers 多线程处理

ID-Scanner-Lib 支持通过 Web Workers 进行多线程处理，特别适用于复杂的身份证识别和二维码解析任务，可以显著提升用户体验，避免主线程阻塞。

启用 Web Workers

要启用 Web Workers 支持，可以在初始化扫描器时传入相关配置：

import { IDScanner } from 'id-scanner-lib';

const scanner = new IDScanner({
  useWorker: true,
  workerOptions: {
    maxConcurrency: 2, // 最大并发Worker数量
    terminateAfterIdle: true, // 空闲后自动终止Worker以释放资源
    idleTimeout: 30000 // Worker空闲30秒后终止
  }
});

await scanner.initialize();

Workers 工作原理

在ID-Scanner-Lib中，Web Workers主要用于以下几个场景：

1. 图像预处理：灰度转换、边缘检测、图像旋转等
2. 特征提取：OCR引擎的特征点提取
3. 身份证信息解析：复杂的文字识别和信息提取
4. 二维码解码：处理复杂的二维码解码算法

Web Workers处理流程：

1. 主线程发送图像数据到Worker
2. Worker执行计算密集型操作
3. 计算完成后，Worker将结果返回主线程
4. 主线程更新UI或执行后续操作

性能对比

处理任务	不使用Worker	使用Worker	性能提升
身份证识别	800-1200ms	400-600ms	~50%
二维码扫描	200-300ms	100-150ms	~50%
多码同时扫描	500-700ms	200-300ms	~60%

浏览器兼容性

Web Workers 在现代浏览器中有良好的支持：

• Chrome 4+
• Firefox 3.5+
• Safari 4+
• Edge 12+
• Opera 11.5+
• iOS Safari 5.1+
• Android Browser 4.4+

对于不支持Web Workers的浏览器，库会自动降级到单线程模式。

常见问题与解决方案

Worker启动慢

首次启动Web Worker可能会有一定延迟。可以通过预热策略优化：

// 在应用初始化时预热Workers
scanner.preloadWorkers();

传输大数据的性能问题

当需要处理高分辨率图像时，可能会遇到数据传输瓶颈：

// 使用Transferable Objects优化传输性能
scanner.recognize(imageData, {
  useTransferableObjects: true
});

内存管理

对于内存敏感的应用，建议在不需要使用扫描功能时释放资源：

// 手动终止Workers释放资源
await scanner.terminateWorkers();

最佳实践

1. 按需初始化：只在需要使用扫描功能的页面初始化Workers
2. 图像预处理：在传入Worker前适当压缩图像大小，减少数据传输量
3. 合理设置并发数：根据设备性能调整最大并发Worker数量
4. Worker复用：对于频繁扫描的场景，避免反复创建和销毁Worker
5. 错误处理：为Worker操作添加适当的错误处理和超时机制

高级配置

对于特定场景，可以进行更精细的Worker配置：

const scanner = new IDScanner({
  useWorker: true,
  workerOptions: {
    // 自定义Worker脚本路径
    scriptURL: '/custom-workers/scanner-worker.js',
    
    // 工作队列优先级设置
    taskPriorities: {
      'idcard': 10,  // 身份证识别任务优先级高
      'qrcode': 5    // 二维码识别优先级中等
    },
    
    // 资源限制
    resourceLimits: {
      maxMemory: 128 * 1024 * 1024, // 最大内存使用
      maxCPUTime: 5000 // 最大CPU时间(ms)
    }
  }
});

通过合理使用Web Workers，可以显著提升ID-Scanner-Lib的性能和用户体验，特别是在处理大量图像数据或执行复杂识别任务时。