id-scanner-lib 1.3.3 → 1.5.0

package/src/qr-module.ts

@@ -1,179 +0,0 @@
-/**
- * @file 二维码和条形码扫描模块
- * @description 包含二维码和条形码扫描功能
- * @module IDScannerQR
- * @version 1.0.0
- * @license MIT
- */
-
-import { QRScanner, QRScannerOptions } from "./scanner/qr-scanner"
-import {
-  BarcodeScanner,
-  BarcodeScannerOptions,
-} from "./scanner/barcode-scanner"
-import { Camera, CameraOptions } from "./utils/camera"
-
-/**
- * 扫描模块配置选项
- */
-export interface ScannerModuleOptions {
-  cameraOptions?: CameraOptions
-  qrScannerOptions?: QRScannerOptions
-  barcodeScannerOptions?: BarcodeScannerOptions
-  onQRCodeScanned?: (result: string) => void
-  onBarcodeScanned?: (result: string) => void
-  onError?: (error: Error) => void
-}
-
-/**
- * 扫描模块类
- *
- * 提供独立的二维码和条形码扫描功能
- */
-export class ScannerModule {
-  private qrScanner: QRScanner
-  private barcodeScanner: BarcodeScanner
-  private camera: Camera
-  private scanMode: "qr" | "barcode" | null = null
-  private videoElement: HTMLVideoElement | null = null
-
-  /**
-   * 构造函数
-   * @param options 配置选项
-   */
-  constructor(private options: ScannerModuleOptions = {}) {
-    this.camera = new Camera(options.cameraOptions)
-    this.qrScanner = new QRScanner({
-      ...options.qrScannerOptions,
-      onScan: this.handleQRScan.bind(this),
-    })
-    this.barcodeScanner = new BarcodeScanner({
-      ...options.barcodeScannerOptions,
-      onScan: this.handleBarcodeScan.bind(this),
-    })
-  }
-
-  /**
-   * 启动二维码扫描
-   * @param videoElement HTML视频元素
-   */
-  async startQRScanner(videoElement: HTMLVideoElement): Promise<void> {
-    this.stop() // 确保先停止可能正在运行的扫描
-
-    this.videoElement = videoElement
-    this.scanMode = "qr"
-    await this.camera.start(videoElement)
-    this.qrScanner.start(videoElement)
-  }
-
-  /**
-   * 启动条形码扫描
-   * @param videoElement HTML视频元素
-   */
-  async startBarcodeScanner(videoElement: HTMLVideoElement): Promise<void> {
-    this.stop() // 确保先停止可能正在运行的扫描
-
-    this.videoElement = videoElement
-    this.scanMode = "barcode"
-    await this.camera.start(videoElement)
-    this.barcodeScanner.start(videoElement)
-  }
-
-  /**
-   * 停止扫描
-   */
-  stop(): void {
-    if (this.scanMode === "qr") {
-      this.qrScanner.stop()
-    } else if (this.scanMode === "barcode") {
-      this.barcodeScanner.stop()
-    }
-
-    if (this.videoElement) {
-      this.camera.stop()
-    }
-
-    this.scanMode = null
-  }
-
-  /**
-   * 处理二维码扫描结果
-   */
-  private handleQRScan(result: string): void {
-    if (this.options.onQRCodeScanned) {
-      this.options.onQRCodeScanned(result)
-    }
-  }
-
-  /**
-   * 处理条形码扫描结果
-   */
-  private handleBarcodeScan(result: string): void {
-    if (this.options.onBarcodeScanned) {
-      this.options.onBarcodeScanned(result)
-    }
-  }
-
-  /**
-   * 处理错误
-   */
-  private handleError(error: Error): void {
-    if (this.options.onError) {
-      this.options.onError(error)
-    } else {
-      console.error("ScannerModule error:", error)
-    }
-  }
-
-  /**
-   * 处理图像数据中的二维码
-   * @param imageData 要处理的图像数据
-   * @returns 返回Promise，解析为扫描结果
-   */
-  async processQRCodeImage(imageData: ImageData): Promise<string> {
-    try {
-      const result = this.qrScanner.processImageData(imageData)
-      if (result) {
-        // 如果需要，触发回调
-        if (this.options.onQRCodeScanned) {
-          this.options.onQRCodeScanned(result)
-        }
-        return result
-      }
-      throw new Error("未检测到二维码")
-    } catch (error) {
-      this.handleError(error as Error)
-      throw error
-    }
-  }
-
-  /**
-   * 处理图像数据中的条形码
-   * @param imageData 要处理的图像数据
-   * @returns 返回Promise，解析为扫描结果
-   */
-  async processBarcodeImage(imageData: ImageData): Promise<string> {
-    try {
-      const result = this.barcodeScanner.processImageData(imageData)
-      if (result) {
-        // 如果需要，触发回调
-        if (this.options.onBarcodeScanned) {
-          this.options.onBarcodeScanned(result)
-        }
-        return result
-      }
-      throw new Error("未检测到条形码")
-    } catch (error) {
-      this.handleError(error as Error)
-      throw error
-    }
-  }
-}
-
-// 导出相关类型和工具
-export { QRScanner, QRScannerOptions } from "./scanner/qr-scanner"
-export {
-  BarcodeScanner,
-  BarcodeScannerOptions,
-} from "./scanner/barcode-scanner"
-export { Camera, CameraOptions } from "./utils/camera"

package/src/scanner/barcode-scanner.ts

@@ -1,251 +0,0 @@
-/**
- * @file 条形码扫描模块
- * @description 提供实时条形码扫描和识别功能
- * @module BarcodeScanner
- */
-
-import { Camera } from "../utils/camera"
-import { ImageProcessor } from "../utils/image-processing"
-
-/**
- * 条形码扫描器配置选项
- *
- * @interface BarcodeScannerOptions
- * @property {number} [scanInterval] - 扫描间隔时间(毫秒)，默认为200ms
- * @property {Function} [onScan] - 扫描成功回调函数
- * @property {Function} [onError] - 错误处理回调函数
- */
-export interface BarcodeScannerOptions {
-  scanInterval?: number
-  onScan?: (result: string) => void
-  onError?: (error: Error) => void
-}
-
-/**
- * 条形码扫描器类
- *
- * 提供实时扫描和识别摄像头中的条形码的功能
- * 注意：当前实现是简化版，实际项目中建议集成专门的条形码识别库如ZXing或Quagga.js
- *
- * @example
- * ```typescript
- * // 创建条形码扫描器
- * const barcodeScanner = new BarcodeScanner({
- *   scanInterval: 100, // 每100ms扫描一次
- *   onScan: (result) => {
- *     console.log('扫描到条形码:', result);
- *   },
- *   onError: (error) => {
- *     console.error('扫描错误:', error);
- *   }
- * });
- *
- * // 启动扫描
- * const videoElement = document.getElementById('video') as HTMLVideoElement;
- * await barcodeScanner.start(videoElement);
- *
- * // 停止扫描
- * barcodeScanner.stop();
- * ```
- */
-export class BarcodeScanner {
-  private camera: Camera
-  private scanning = false
-  private scanTimer: number | null = null
-
-  /**
-   * 创建条形码扫描器实例
-   *
-   * @param {BarcodeScannerOptions} [options] - 扫描器配置选项
-   */
-  constructor(private options: BarcodeScannerOptions = {}) {
-    this.options = {
-      scanInterval: 200,
-      ...options,
-    }
-
-    this.camera = new Camera()
-  }
-
-  /**
-   * 启动条形码扫描
-   *
-   * 初始化相机并开始连续扫描视频帧中的条形码
-   *
-   * @param {HTMLVideoElement} videoElement - 用于显示相机画面的video元素
-   * @returns {Promise<void>} 启动完成的Promise
-   * @throws 如果无法访问相机，将通过onError回调报告错误
-   */
-  async start(videoElement: HTMLVideoElement): Promise<void> {
-    try {
-      await this.camera.initialize(videoElement)
-      this.scanning = true
-      this.scan()
-    } catch (error) {
-      if (this.options.onError) {
-        this.options.onError(
-          error instanceof Error ? error : new Error(String(error))
-        )
-      }
-    }
-  }
-
-  /**
-   * 执行一次条形码扫描
-   *
-   * 内部方法，捕获当前视频帧并尝试识别其中的条形码
-   *
-   * @private
-   */
-  private scan(): void {
-    if (!this.scanning) return
-
-    const imageData = this.camera.captureFrame()
-
-    if (imageData) {
-      try {
-        // 图像预处理，提高识别率
-        const enhancedImage = ImageProcessor.adjustBrightnessContrast(
-          ImageProcessor.toGrayscale(imageData),
-          10, // 亮度
-          20 // 对比度
-        )
-
-        // 这里实际项目中可以集成第三方条形码扫描库
-        // 如 ZXing 或 QuaggaJS
-        // 简化实现，这里仅为示例
-        this.detectBarcode(enhancedImage)
-      } catch (error) {
-        console.error("条形码扫描错误:", error)
-      }
-    }
-
-    this.scanTimer = window.setTimeout(
-      () => this.scan(),
-      this.options.scanInterval
-    )
-  }
-
-  /**
-   * 条形码检测方法
-   *
-   * 注意：这是一个简化实现，实际需要集成专门的条形码识别库
-   *
-   * @private
-   * @param {ImageData} imageData - 要检测条形码的图像数据
-   */
-  private detectBarcode(imageData: ImageData): void {
-    // 这里应集成条形码识别库
-    // 如 ZXing 或 QuaggaJS
-
-    // 简化示例，实际项目中请替换为真实实现
-    console.log("正在扫描条形码...")
-
-    // 模拟找到条形码
-    if (Math.random() > 0.95) {
-      const mockResult = "6901234567890" // 模拟条形码结果
-
-      if (this.options.onScan) {
-        this.options.onScan(mockResult)
-      }
-    }
-  }
-
-  /**
-   * 停止条形码扫描
-   *
-   * 停止扫描循环并释放相机资源
-   */
-  stop(): void {
-    this.scanning = false
-
-    if (this.scanTimer) {
-      clearTimeout(this.scanTimer)
-      this.scanTimer = null
-    }
-
-    this.camera.release()
-  }
-
-  /**
-   * 处理图像数据中的条形码
-   *
-   * @param {ImageData} imageData - 要处理的图像数据
-   * @returns {string | null} 识别到的条形码内容，如未识别到则返回null
-   */
-  processImageData(imageData: ImageData): string | null {
-    try {
-      if (
-        !imageData ||
-        !imageData.data ||
-        imageData.width <= 0 ||
-        imageData.height <= 0
-      ) {
-        throw new Error("无效的图像数据")
-      }
-
-      // 图像预处理，提高识别率
-      const enhancedImage = ImageProcessor.adjustBrightnessContrast(
-        ImageProcessor.toGrayscale(imageData),
-        10, // 亮度
-        20 // 对比度
-      )
-
-      // 注意：这里是简化实现
-      // 实际项目中，应该集成专门的条形码识别库如ZXing或Quagga.js
-
-      // 模拟条形码识别
-      // 在真实项目中，请替换为实际的条形码识别算法
-      const result = this.simulateBarcodeDetection(enhancedImage)
-      return result
-    } catch (error) {
-      if (this.options.onError) {
-        this.options.onError(
-          error instanceof Error ? error : new Error(String(error))
-        )
-      }
-      return null
-    }
-  }
-
-  /**
-   * 模拟条形码检测
-   * 仅用于演示，实际使用时应该替换为真实的条形码识别算法
-   *
-   * @private
-   * @param {ImageData} imageData - 要检测条形码的图像数据
-   * @returns {string | null} 模拟的条形码识别结果
-   */
-  private simulateBarcodeDetection(imageData: ImageData): string | null {
-    // 这里只是模拟，真实环境中应当使用条形码识别库进行识别
-
-    // 在中间区域检测到足够多垂直边缘时，认为可能存在条形码
-    const midX = Math.floor(imageData.width / 2)
-    const midY = Math.floor(imageData.height / 2)
-    const sampleWidth = Math.min(100, Math.floor(imageData.width / 3))
-
-    let edgeCount = 0
-    let lastPixel = 0
-
-    // 简单的边缘检测，统计中心水平线上像素变化次数
-    for (let x = midX - sampleWidth / 2; x < midX + sampleWidth / 2; x++) {
-      const pixelPos = (midY * imageData.width + x) * 4
-      const pixelValue = imageData.data[pixelPos]
-
-      if (Math.abs(pixelValue - lastPixel) > 30) {
-        edgeCount++
-      }
-
-      lastPixel = pixelValue
-    }
-
-    // 如果边缘变化次数在合理范围内，认为是条形码
-    // 实际的条形码具有规律的宽窄条纹
-    if (edgeCount > 10 && edgeCount < 50) {
-      // 生成一个模拟的条形码结果
-      return "690" + Math.floor(Math.random() * 10000000000)
-    }
-
-    return null
-  }
-}

package/src/scanner/qr-scanner.ts

@@ -1,167 +0,0 @@
-/**
- * @file 二维码扫描模块
- * @description 提供实时二维码扫描和识别功能
- * @module QRScanner
- */
-
-import jsQR from "jsqr"
-import { Camera } from "../utils/camera"
-
-/**
- * 二维码扫描器配置选项
- *
- * @interface QRScannerOptions
- * @property {number} [scanInterval] - 扫描间隔时间(毫秒)，默认为200ms
- * @property {Function} [onScan] - 扫描成功回调函数
- * @property {Function} [onError] - 错误处理回调函数
- */
-export interface QRScannerOptions {
-  scanInterval?: number
-  onScan?: (result: string) => void
-  onError?: (error: Error) => void
-}
-
-/**
- * 二维码扫描器类
- *
- * 提供实时扫描和识别摄像头中的二维码的功能
- *
- * @example
- * ```typescript
- * // 创建二维码扫描器
- * const qrScanner = new QRScanner({
- *   scanInterval: 100, // 每100ms扫描一次
- *   onScan: (result) => {
- *     console.log('扫描到二维码:', result);
- *   },
- *   onError: (error) => {
- *     console.error('扫描错误:', error);
- *   }
- * });
- *
- * // 启动扫描
- * const videoElement = document.getElementById('video') as HTMLVideoElement;
- * await qrScanner.start(videoElement);
- *
- * // 停止扫描
- * qrScanner.stop();
- * ```
- */
-export class QRScanner {
-  private camera: Camera
-  private scanning = false
-  private scanTimer: number | null = null
-
-  /**
-   * 创建二维码扫描器实例
-   *
-   * @param {QRScannerOptions} [options] - 扫描器配置选项
-   */
-  constructor(private options: QRScannerOptions = {}) {
-    this.options = {
-      scanInterval: 200,
-      ...options,
-    }
-
-    this.camera = new Camera()
-  }
-
-  /**
-   * 启动二维码扫描
-   *
-   * 初始化相机并开始连续扫描视频帧中的二维码
-   *
-   * @param {HTMLVideoElement} videoElement - 用于显示相机画面的video元素
-   * @returns {Promise<void>} 启动完成的Promise
-   * @throws 如果无法访问相机，将通过onError回调报告错误
-   */
-  async start(videoElement: HTMLVideoElement): Promise<void> {
-    try {
-      await this.camera.initialize(videoElement)
-      this.scanning = true
-      this.scan()
-    } catch (error) {
-      if (this.options.onError) {
-        this.options.onError(
-          error instanceof Error ? error : new Error(String(error))
-        )
-      }
-    }
-  }
-
-  /**
-   * 执行一次二维码扫描
-   *
-   * 内部方法，捕获当前视频帧并尝试识别其中的二维码
-   *
-   * @private
-   */
-  private scan(): void {
-    if (!this.scanning) return
-
-    const imageData = this.camera.captureFrame()
-
-    if (imageData) {
-      const code = jsQR(imageData.data, imageData.width, imageData.height)
-
-      if (code && this.options.onScan) {
-        this.options.onScan(code.data)
-      }
-    }
-
-    this.scanTimer = window.setTimeout(
-      () => this.scan(),
-      this.options.scanInterval
-    )
-  }
-
-  /**
-   * 停止二维码扫描
-   *
-   * 停止扫描循环并释放相机资源
-   */
-  stop(): void {
-    this.scanning = false
-
-    if (this.scanTimer) {
-      clearTimeout(this.scanTimer)
-      this.scanTimer = null
-    }
-
-    this.camera.release()
-  }
-
-  /**
-   * 处理图像数据中的二维码
-   *
-   * @param {ImageData} imageData - 要处理的图像数据
-   * @returns {string | null} 识别到的二维码内容，如未识别到则返回null
-   */
-  processImageData(imageData: ImageData): string | null {
-    try {
-      if (
-        !imageData ||
-        !imageData.data ||
-        imageData.width <= 0 ||
-        imageData.height <= 0
-      ) {
-        throw new Error("无效的图像数据")
-      }
-
-      const code = jsQR(imageData.data, imageData.width, imageData.height)
-
-      if (code && code.data) {
-        return code.data
-      }
-
-      return null
-    } catch (error) {
-      if (this.options.onError) {
-        this.options.onError(
-          error instanceof Error ? error : new Error(String(error))
-        )
-      }
-      return null
-    }
-  }
-}