Flutter Zebra MC3300条码扫描仅重启后可用问题求助

针对Zebra MC3300设备上Flutter应用条码扫描仅在页面重启后生效的问题，以下是针对性解决方案：

1. 确保扫描区域获取焦点 #

Zebra扫描器采用键盘模拟模式，需要输入框获得焦点才能捕获扫描内容。初始加载时焦点未绑定会导致扫描事件丢失：

修改BarcodeScannerField的状态类，添加焦点管理：

class _BarcodeScannerFieldState extends State<BarcodeScannerField> {
  String? _barcode;
  TextEditingController _textFieldController = TextEditingController();
  bool _isReadOnly = true;
  final FocusNode _focusNode = FocusNode(); // 添加焦点节点

  @override
  void initState() {
    super.initState();
    _textFieldController = TextEditingController();
    // 页面渲染完成后请求焦点
    WidgetsBinding.instance.addPostFrameCallback((_) {
      FocusScope.of(context).requestFocus(_focusNode);
    });
  }

  @override
  void dispose() {
    _focusNode.dispose(); // 释放焦点资源
    _textFieldController.dispose();
    super.dispose();
  }

  // 其余代码不变...

  @override
  Widget build(BuildContext context) {
    // ...
    child: TextField(
      controller: _textFieldController,
      focusNode: _focusNode, // 绑定焦点节点
      readOnly: _isReadOnly,
      // 其余属性不变...
    ),
    // ...
  }
}

2. 调整扫描缓冲时长 #

Zebra扫描器的字符输出速率与Cipherlabs不同，默认200ms缓冲可能无法完整捕获条码：

修改CodeScanListener的bufferDuration参数：

CodeScanListener(
  bufferDuration: const Duration(milliseconds: 300), // 增大缓冲时长
  onBarcodeScanned: (barcode) {
    // 原有逻辑不变
  },
  // 其余代码不变...
)

3. 添加TextField输入监听作为 fallback #

如果CodeScanListener未捕获到扫描内容，直接监听TextField输入确保不丢失：

在TextField中添加onChanged回调：

TextField(
  // 其余属性不变...
  onChanged: (value) {
    if (_isReadOnly && value.isNotEmpty) { // 仅在只读模式下处理扫描输入
      String cleanedBarcode = value.replaceAll(RegExp(r'[\]\[]'), '');
      setState(() {
        _barcode = cleanedBarcode;
        _textFieldController.text = cleanedBarcode;
      });
    }
  },
)

4. 检查Zebra设备扫描器配置 #

• 确认扫描器设置为键盘楔形模式（Keyboard Wedge）
• 配置扫描后自动添加回车符作为后缀，确保输入完成后触发完整扫描事件
• 开启"批量发送字符"选项，避免条码字符被分批输出

5. 强制触发扫描组件重建 #

若以上方案无效，可通过全局Key强制重建扫描组件，确保初始化绑定：

将StockLookupScreen改为StatefulWidget：

class StockLookupScreen extends StatefulWidget {
  final String title;

  const StockLookupScreen({Key? key, required this.title}) : super(key: key);

  @override
  _StockLookupScreenState createState() => _StockLookupScreenState();
}

class _StockLookupScreenState extends State<StockLookupScreen> {
  final GlobalKey<BarcodeScannerFieldState> _scanKey = GlobalKey();

  @override
  void initState() {
    super.initState();
    // 延迟触发组件重建
    Future.delayed(const Duration(milliseconds: 500), () {
      setState(() {});
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: CustomAppBar(
        title: "Stock LookUp",
        showSettingsIcon: false,
        showLogoutIcon: true,
        showBackButton: true,
        onBackButtonPressed: () {
          Get.back();
        },
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.start,
          children: [
            Padding(
              padding: const EdgeInsets.all(5.0),
              child: BarcodeScannerField(
                key: _scanKey, // 绑定全局Key
                onSubmitted: (searchText) {
                  print('Search text: $searchText');
                  Get.to(() => StockLookupResults(searchText));
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}

同时修改BarcodeScannerField的状态类访问权限：

class BarcodeScannerField extends StatefulWidget {
  final Function(String) onSubmitted;

  const BarcodeScannerField({required this.onSubmitted, Key? key}) : super(key: key);

  @override
  State<BarcodeScannerField> createState() => _BarcodeScannerFieldState();
}

// 状态类保持原有逻辑即可
class _BarcodeScannerFieldState extends State<BarcodeScannerField> {
  // ...原有代码
}

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