Flutter 鸿蒙条形码识别实现：图像识别与格式解析

欢迎加入开源鸿蒙跨平台社区！ https://openharmonycrossplatform.csdn.net

效果展示

条形码识别演示

支持格式

• EAN-13：欧洲商品码
• EAN-8：欧洲商品码
• UPC-A：美国商品码
• Code128：工业条码
• Code39：工业条码

识别功能

• 实时扫描识别
• 格式自动检测
• 商品信息查询
• 历史记录管理

识别结果展示

结果详情

• 条码格式
• 条码内容
• 商品类型
• 操作选项

实现步骤

1. 条码识别器实现

核心类设计

class BarcodeScanner {
  final BarcodeDetector detector;
  
  Future<BarcodeResult> scan(InputImage image) async {
    final barcodes = await detector.processImage(image);
    
    if (barcodes.isNotEmpty) {
      final barcode = barcodes.first;
      return BarcodeResult(
        format: barcode.format,
        value: barcode.rawValue,
        type: detectType(barcode.rawValue),
      );
    }
    return BarcodeResult.empty();
  }
}

2. 格式检测

条码格式识别

String detectBarcodeFormat(String content) {
  if (RegExp(r'^\d{13}$').hasMatch(content)) {
    return 'EAN-13';
  } else if (RegExp(r'^\d{8}$').hasMatch(content)) {
    return 'EAN-8';
  } else if (RegExp(r'^\d{12}$').hasMatch(content)) {
    return 'UPC-A';
  } else if (RegExp(r'^\d{6}$').hasMatch(content)) {
    return 'UPC-E';
  } else if (content.contains('*')) {
    return 'Code39';
  } else {
    return 'Code128';
  }
}

3. 商品类型识别

地区判断

String detectBarcodeType(String content) {
  if (content.startsWith('69') && content.length == 13) {
    return '中国商品';
  } else if (content.startsWith('0') && content.length == 12) {
    return '美国商品';
  } else if (content.startsWith('45') || content.startsWith('49')) {
    return '日本商品';
  } else if (RegExp(r'^\d+$').hasMatch(content)) {
    return '商品条码';
  } else {
    return '工业条码';
  }
}

4. 扫描界面

扫描区域

Container(
  height: 180,
  decoration: BoxDecoration(
    border: Border.all(color: Colors.cyan, width: 3),
  ),
  child: Stack(
    children: [
      CameraPreview(controller),
      ScannerOverlay(),
      AnimatedScanLine(),
    ],
  ),
)

功能特性

1. 多格式支持

条码格式

final supportedFormats = {
  'EAN-13': '欧洲商品码 (13位)',
  'EAN-8': '欧洲商品码 (8位)',
  'UPC-A': '美国商品码 (12位)',
  'UPC-E': '美国商品码 (6位)',
  'Code128': '工业条码',
  'Code39': '工业条码',
  'Code93': '工业条码',
  'Codabar': '库德巴码',
  'ITF': '交叉二五码',
};

2. 扫描控制

开始/停止

void startScanning() {
  setState(() {
    isScanning = true;
    scanResult = '';
  });
  
  scanTimer = Timer.periodic(
    Duration(milliseconds: 16),
    updateScanLine,
  );
}

3. 结果处理

复制与查询

void copyResult() {
  Clipboard.setData(ClipboardData(text: scanResult));
}

void searchProduct() {
  launchUrl(Uri.parse('https://www.google.com/search?q=$scanResult'));
}

4. 历史记录

记录存储

void addToHistory(String content, String format) {
  scanHistory.insert(0, {
    'time': DateTime.now(),
    'content': content,
    'format': format,
  });
}

使用说明

基本使用

1. 启动扫描

   • 点击开始扫描
   • 对准条形码
   • 等待识别

2. 查看结果

   • 显示条码格式
   • 显示条码内容
   • 显示商品类型

3. 后续操作

   • 复制条码
   • 查询商品
   • 查看历史

高级功能

模拟扫描

void simulateScan(String content) {
  final format = detectBarcodeFormat(content);
  final type = detectBarcodeType(content);
  
  setState(() {
    scanResult = content;
    barcodeFormat = format;
    barcodeType = type;
  });
}

技术要点

1. 条码结构

EAN-13结构

| 前缀码 | 厂商代码 | 商品代码 | 校验码 |
|  3位   |   4-5位  |   4-5位  |  1位   |

2. 校验算法

校验位计算

int calculateChecksum(String data) {
  var sum = 0;
  for (var i = 0; i < data.length; i++) {
    final digit = int.parse(data[i]);
    sum += digit * (i.isEven ? 1 : 3);
  }
  return (10 - (sum % 10)) % 10;
}

3. 性能优化

快速解码

// 使用硬件加速
final options = BarcodeScannerOptions(
  formats: [
    BarcodeFormat.ean13,
    BarcodeFormat.upcA,
    BarcodeFormat.code128,
  ],
);

最佳实践

1. 用户体验

扫描引导

• 对准条形码提示
• 保持稳定提示
• 光线不足提示

2. 错误处理

异常情况

if (result.isEmpty) {
  showWarning('未能识别条形码，请重试');
}

if (!isValidBarcode(result)) {
  showError('无效的条形码格式');
}

3. 数据验证

格式验证

bool isValidEAN13(String code) {
  if (code.length != 13) return false;
  if (!RegExp(r'^\d{13}$').hasMatch(code)) return false;
  
  final expectedChecksum = calculateChecksum(code.substring(0, 12));
  return code[12] == expectedChecksum.toString();
}

应用场景

1. 商品查询

价格比较

void searchProduct(String barcode) {
  final url = 'https://price-compare.com/search?code=$barcode';
  launchUrl(Uri.parse(url));
}

2. 库存管理

入库扫描

void addToInventory(String barcode) {
  inventory.add(InventoryItem(
    barcode: barcode,
    timestamp: DateTime.now(),
  ));
}

3. 物流追踪

包裹识别

void trackPackage(String trackingCode) {
  logisticsService.track(trackingCode);
}

总结

Flutter鸿蒙条形码识别功能实现了完整的条码识别解决方案，包括：

• ✅ 多种条码格式支持
• ✅ 自动格式检测
• ✅ 商品类型识别
• ✅ 历史记录管理
• ✅ 商品查询功能

该功能为Flutter for OpenHarmony应用提供了专业的条形码识别能力，适用于商品管理、库存盘点等场景。