Flutter集成Athesi AP5705S嵌入式扫码器获取数据异常求助

1. 先排查设备扫码器的输入模式设置 #

这类集成式扫码器通常默认是HID模拟键盘输入模式，但部分设备在系统键盘唤起时会抢占输入通道，导致Flutter无法捕获扫码内容：

• 进入设备的扫码器设置界面，查找「后台扫码」「焦点无关输入」或「键盘激活时允许扫码」这类选项并开启，确保扫码器输入不被系统键盘拦截。
• 确认扫码器的后缀设置：如果之前设置了TAB/ENTER后缀，暂时保留（用来触发结果回调），后续可以根据需求调整。

2. 让TextField保持焦点但隐藏系统键盘 #

既然「退出再进入应用、TextField选中时能正常扫码」，说明焦点存在但无系统键盘时输入通道是通的。可以通过代码强制隐藏键盘并维持焦点：

import 'package:flutter/services.dart';
import 'package:flutter/material.dart';

class ScanPage extends StatefulWidget {
  const ScanPage({super.key});

  @override
  State<ScanPage> createState() => _ScanPageState();
}

class _ScanPageState extends State<ScanPage> {
  final FocusNode _scanFocusNode = FocusNode();
  final TextEditingController _scanController = TextEditingController();

  @override
  void initState() {
    super.initState();
    // 焦点获取时自动隐藏系统键盘
    _scanFocusNode.addListener(() {
      if (_scanFocusNode.hasFocus) {
        SystemChannels.textInput.invokeMethod('TextInput.hide');
      }
    });
    // 页面初始化时自动获取焦点
    WidgetsBinding.instance.addPostFrameCallback((_) {
      FocusScope.of(context).requestFocus(_scanFocusNode);
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: TextField(
          focusNode: _scanFocusNode,
          controller: _scanController,
          decoration: const InputDecoration(hintText: "扫码此处"),
        ),
      ),
    );
  }
}

3. 用原生插件替代RawKeyboardListener（核心解决方案） #

RawKeyboardListener无法捕获扫码内容但能抓到后缀按键，说明Flutter层面的按键监听对扫码器的快速连续输入支持不佳。直接在原生层监听按键事件，再通过MethodChannel传给Flutter：

Android端原生代码示例（简化版）

在MainActivity中添加按键监听：

import io.flutter.embedding.android.FlutterActivity;
import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugin.common.MethodChannel;
import android.view.KeyEvent;
import android.view.View;

public class MainActivity extends FlutterActivity {
    private static final String CHANNEL = "com.example.scan_plugin";
    private StringBuilder scanBuffer = new StringBuilder();

    @Override
    public void configureFlutterEngine(FlutterEngine flutterEngine) {
        super.configureFlutterEngine(flutterEngine);
        new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(), CHANNEL)
                .setMethodCallHandler((call, result) -> {});
        
        // 给Flutter视图添加按键监听
        View flutterView = findViewById(android.R.id.content);
        flutterView.setOnKeyListener((v, keyCode, event) -> {
            if (event.getAction() == KeyEvent.ACTION_DOWN) {
                char inputChar = (char) event.getUnicodeChar();
                if (inputChar != 0) {
                    scanBuffer.append(inputChar);
                }
                // 用扫码后缀的ENTER键触发结果回调
                if (keyCode == KeyEvent.KEYCODE_ENTER) {
                    new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(), CHANNEL)
                            .invokeMethod("onScanResult", scanBuffer.toString());
                    scanBuffer.setLength(0);
                    return true;
                }
            }
            return false;
        });
    }
}

Flutter端接收扫码结果

import 'package:flutter/services.dart';
import 'package:flutter/material.dart';

class ScanPage extends StatefulWidget {
  const ScanPage({super.key});

  @override
  State<ScanPage> createState() => _ScanPageState();
}

class _ScanPageState extends State<ScanPage> {
  static const MethodChannel _scanChannel = MethodChannel("com.example.scan_plugin");
  String _scanResult = "";

  @override
  void initState() {
    super.initState();
    _scanChannel.setMethodCallHandler((call) async {
      if (call.method == "onScanResult") {
        setState(() {
          _scanResult = call.arguments.toString();
        });
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text("扫码结果：$_scanResult"),
      ),
    );
  }
}

4. 尝试设备专属SDK集成 #

如果设备厂商提供了扫码专用SDK（而非仅HID模式），优先集成官方SDK并封装成Flutter插件，这种方式稳定性远高于模拟键盘输入，能直接获取扫码原始数据，避免各种焦点/输入通道冲突问题。

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