Flutter蓝牙条码扫描器应用内返回错误字符及回调失效问题

一、乱码问题（返回符号而非数字） #

问题根源 #

蓝牙条码扫描器本质是模拟键盘输入，系统会用当前激活的输入法布局解析扫描的按键码。你遇到的法语键盘正常、其他键盘出符号的情况，说明扫描器默认输出的是法语键盘对应的按键码，换其他布局就会映射错误。

解决办法 #

• 强制切换输入法：让用户把系统输入法改成英文（美式）键盘，绝大多数条码扫描器默认输出美式键盘的按键码，能直接匹配数字/字符。
• 手动按键映射：如果不能强制用户切换键盘，就用RawKeyboardListener监听原始按键事件，自己做字符映射。比如把扫描器输出的法语键盘按键码，转换成对应的数字：

  // 示例：法语键盘按键码到数字的映射表
  final Map<String, String> keyMap = {
    '&': '1',
    'é': '2',
    '-': '3',
    // 补充其他需要映射的字符
  };
  

  在监听按键时，用这个表把扫描到的符号转成正确数字。

二、打开软键盘后回调不触发 #

问题根源 #

flutter_barcode_listener默认需要检测到Enter键才会触发onBarcodeScanned回调。打开软键盘后，要么扫描器的Enter键没被插件捕获，要么软键盘抢占了焦点，导致插件监听不到全局按键。

解决办法 #

1. 调整缓冲区时长：把bufferDuration从200ms调大到500ms，打开软键盘后系统处理按键的延迟会增加，避免还没等到Enter键就提前结束缓冲区。
2. 锁定焦点到监听组件：在BarcodeKeyboardListener外层包裹FocusScope，确保焦点始终在监听组件上，不让软键盘抢占：

   Widget mainMenu() {
     final FocusNode _focusNode = FocusNode();
     return FocusScope(
       node: FocusScopeNode(),
       child: BarcodeKeyboardListener(
         focusNode: _focusNode,
         bufferDuration: const Duration(milliseconds: 500),
         onBarcodeScanned: (barcode)async {
           print('barcode*** ${barcode}');
           // 扫描完成后重新请求焦点，避免软键盘抢占
           _focusNode.requestFocus();
         },
         child: Stack(...)
       ),
     );
   }
   

3. 自定义扫描完成逻辑：放弃依赖Enter键，改用「按键间隔超时」判断扫描完成。直接用RawKeyboardListener实现自己的缓冲区，当连续输入的间隔超过300ms，就认为扫描完成（代码示例如下）：

   class CustomBarcodeScanner extends StatefulWidget {
     const CustomBarcodeScanner({super.key});
   
     @override
     State<CustomBarcodeScanner> createState() => _CustomBarcodeScannerState();
   }
   
   class _CustomBarcodeScannerState extends State<CustomBarcodeScanner> {
     final FocusNode _focusNode = FocusNode();
     final StringBuffer _barcodeBuffer = StringBuffer();
     Timer? _bufferTimer;
   
     @override
     void initState() {
       super.initState();
       _focusNode.requestFocus();
     }
   
     @override
     void dispose() {
       _bufferTimer?.cancel();
       _focusNode.dispose();
       super.dispose();
     }
   
     void _handleKeyPress(RawKeyEvent event) {
       if (event is RawKeyDownEvent) {
         final key = event.logicalKey;
         // 收集数字、字母等条码常用字符
         if ((key >= LogicalKeyboardKey.digit0 && key <= LogicalKeyboardKey.digit9) ||
             (key >= LogicalKeyboardKey.keyA && key <= LogicalKeyboardKey.keyZ)) {
           _barcodeBuffer.write(key.keyLabel);
         }
   
         // 重置定时器，超过300ms无输入则触发扫描完成
         _bufferTimer?.cancel();
         _bufferTimer = Timer(const Duration(milliseconds: 300), () {
           if (_barcodeBuffer.isNotEmpty) {
             print('barcode*** ${_barcodeBuffer.toString()}');
             _barcodeBuffer.clear();
             _focusNode.requestFocus(); // 重新锁定焦点
           }
         });
       }
     }
   
     @override
     Widget build(BuildContext context) {
       return RawKeyboardListener(
         focusNode: _focusNode,
         onKey: _handleKeyPress,
         child: Stack(...),
       );
     }
   }
   

4. 检查扫描器设置：部分蓝牙扫描器可以配置「扫描后发送Enter键」功能，扫描扫描器说明书里的设置条码，开启这个选项，让扫描器在扫完条码后主动发送Enter，适配插件的触发逻辑。

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