Flutter中如何从各类PDA扫描设备获取条码？

问题描述 #

需将Flutter应用部署在Datalogic、Honeywell、ZKC等各类PDA设备上，实现扫描条码获取功能。当前使用RawKeyboardListener实现的代码在部分手持扫描器上可正常运行，但在Datalogic设备上event.data.keyLabel为空，无法获取条码。

解决方案 #

1. 兼容多设备的按键事件解析 #

部分PDA（如Datalogic）的按键事件不会通过keyLabel返回字符，需通过physicalKey或logicalKey映射字符，同时仅处理按键按下事件避免重复触发：

修改onKey回调逻辑：

onKey: (RawKeyEvent event) {
  // 仅处理按下事件，防止重复添加字符
  if (event is RawKeyDownEvent) {
    if (event.physicalKey == PhysicalKeyboardKey.enter) {
      setState(() {
        barcode = _chars;
        _chars = '';
      });
    } else {
      String? char = _getCharFromKeyEvent(event);
      if (char != null) {
        _chars += char;
      }
    }
  }
}

// 辅助函数：从按键事件中解析字符
String? _getCharFromKeyEvent(RawKeyDownEvent event) {
  // 优先读取keyLabel
  if (event.data.keyLabel.isNotEmpty) {
    return event.data.keyLabel;
  }
  // 针对Datalogic等设备，通过logicalKey映射字符
  final logicalKey = event.logicalKey;
  if (logicalKey == LogicalKeyboardKey.key0) return '0';
  if (logicalKey == LogicalKeyboardKey.key1) return '1';
  if (logicalKey == LogicalKeyboardKey.key2) return '2';
  if (logicalKey == LogicalKeyboardKey.key3) return '3';
  if (logicalKey == LogicalKeyboardKey.key4) return '4';
  if (logicalKey == LogicalKeyboardKey.key5) return '5';
  if (logicalKey == LogicalKeyboardKey.key6) return '6';
  if (logicalKey == LogicalKeyboardKey.key7) return '7';
  if (logicalKey == LogicalKeyboardKey.key8) return '8';
  if (logicalKey == LogicalKeyboardKey.key9) return '9';
  if (logicalKey == LogicalKeyboardKey.a) return 'A';
  if (logicalKey == LogicalKeyboardKey.b) return 'B';
  // 可继续补充字母、符号的映射规则
  return null;
}

2. 使用品牌专用扫描插件 #

对接PDA原生扫描API，避免键盘事件解析的兼容性问题：

• Datalogic设备：使用datalogic_scan插件，直接调用原生扫描接口获取结果
• Honeywell设备：使用honeywell_scanner插件，支持配置扫描参数并监听回调
• 通用场景：使用flutter_barcode_scanner等通用插件，部分定制PDA需额外适配

示例（datalogic_scan插件用法）：

import 'package:datalogic_scan/datalogic_scan.dart';

class MyWidgetState extends State<MyWidget> {
  String? barcode;
  late DatalogicScan _scanInstance;

  @override
  void initState() {
    super.initState();
    _scanInstance = DatalogicScan();
    // 监听扫描结果流
    _scanInstance.startScanStream().listen((result) {
      setState(() {
        barcode = result.barcode;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Text('Barcode: $barcode'),
    );
  }
}

3. 调整PDA扫描器系统设置 #

部分PDA可通过系统配置优化扫描输出：

• 将扫描器设置为键盘模拟模式（Keyboard Wedge），确保扫描后自动附加结束符（如Enter）
• Datalogic设备需在扫描配置工具中开启「Send as Keyboard Input」选项
• 检查是否存在特殊编码或字符过滤设置导致keyLabel为空

调试建议 #

• 在不同设备上打印完整RawKeyEvent日志，查看physicalKey、logicalKey等字段的实际值，针对性调整映射逻辑
• 测试多种条码类型（如Code128、QR码），验证字符解析的完整性

内容的提问来源于stack exchange，提问作者Ehsan Kalali