Flutter如何捕获ZEBRA手持终端的条码扫描按钮点击及扫描值？

方案1：使用Zebra官方DataWedge服务（推荐） #

Zebra全系手持终端内置原生DataWedge系统服务，无需依赖小众硬件按钮捕获包即可稳定实现需求，操作步骤如下：

• 先在终端自带的DataWedge应用中新建专属配置，绑定你开发的安卓应用，开启条码扫描功能，将输出模式设置为Intent广播，自定义广播Action（例如com.your.app.SCAN_RECEIVE），记录条码数据对应的Extra键名（默认条码内容键为com.symbol.datawedge.data_string）
• Flutter端依赖android_intent_plus包监听对应广播，同时配合原生层广播接收器完成数据转发，核心代码示例：

// 原生层自定义广播接收器（安卓侧kotlin代码）
class ScanReceiver : BroadcastReceiver() {
  private val channel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.your.app/scan_channel")
  override fun onReceive(context: Context?, intent: Intent?) {
    if (intent?.action == "com.your.app.SCAN_RECEIVE") {
      val scanData = intent.getStringExtra("com.symbol.datawedge.data_string") ?: ""
      channel.invokeMethod("onScanResult", scanData)
    }
  }
}

// Flutter侧接收扫描结果
import 'package:flutter/services.dart';

void initScanListen() {
  const MethodChannel channel = MethodChannel("com.your.app/scan_channel");
  channel.setMethodCallHandler((call) async {
    if (call.method == "onScanResult") {
      final String scanCode = call.arguments as String;
      // 判断是否存在聚焦的TextField
      final focusNode = WidgetsBinding.instance.focusManager.primaryFocus;
      if (focusNode?.context?.widget is EditableText) {
        // 自动填充到聚焦输入框
        final controller = (focusNode?.context?.widget as EditableText).controller;
        controller.text = scanCode;
        controller.selection = TextSelection.fromPosition(TextPosition(offset: scanCode.length));
      } else {
        // 无输入框聚焦时自行处理扫描结果
        handleGlobalScan(scanCode);
      }
    }
  });
}

• 最后在安卓项目的AndroidManifest.xml中注册广播接收器即可：

<receiver android:name=".ScanReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.your.app.SCAN_RECEIVE" />
  </intent-filter>
</receiver>

方案2：全局监听键盘输入（轻量适配方案） #

如果你的扫描器默认设置为模拟键盘输出模式，可以直接通过Flutter自带的RawKeyboardListener全局捕获按键事件实现需求：

• 给应用根组件包裹RawKeyboardListener，设置全局聚焦，通过输入间隔区分是用户手动输入还是扫描器输入（扫描器输入的字符间隔通常小于50ms，且末尾自带回车符）
  核心代码示例：

import 'package:flutter/services.dart';

class ScanWrapper extends StatefulWidget {
  final Widget child;
  const ScanWrapper({super.key, required this.child});

  @override
  State<ScanWrapper> createState() => _ScanWrapperState();
}

class _ScanWrapperState extends State<ScanWrapper> {
  final StringBuffer _scanBuffer = StringBuffer();
  DateTime _lastInputTime = DateTime.now();
  final int _scanInterval = 50; // 扫描输入最大间隔，单位毫秒

  @override
  Widget build(BuildContext context) {
    return RawKeyboardListener(
      focusNode: FocusNode(),
      autofocus: true,
      onKey: (event) {
        if (event is! RawKeyDownEvent) return;
        final now = DateTime.now();
        if (now.difference(_lastInputTime).inMilliseconds > _scanInterval) {
          _scanBuffer.clear();
        }
        if (event.logicalKey == LogicalKeyboardKey.enter) {
          if (_scanBuffer.isNotEmpty) {
            final scanCode = _scanBuffer.toString();
            _scanBuffer.clear();
            // 扫描结果处理逻辑同方案1
            handleScanResult(scanCode);
          }
        } else {
          if (event.character != null) {
            _scanBuffer.write(event.character);
          }
        }
        _lastInputTime = now;
      },
      child: widget.child,
    );
  }
}

不推荐方案说明 #

hardware_buttons包仅支持捕获系统标准硬件按钮，Zebra扫描按键属于厂商自定义按键，键值不统一，捕获兼容性极差，不建议使用该方案实现需求。

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