Flutter中如何监听安卓扫描器的F16物理按键输入？

问题核心原因 #

Android系统默认仅当应用内存在获得输入焦点的可交互控件（如TextField）时，才会将按键事件传递给Flutter的键盘服务。初始状态下无焦点控件，所以ServicesBinding或RawKeyboard的监听器无法捕获事件；而聚焦TextField后激活了键盘服务，即使后续失焦，服务仍会保持激活直到APP重启，这就是你观察到的现象。

解决方案 #

方案1：通过Android原生代码实现全局按键监听 #

直接在Android Activity级别捕获所有按键事件，再通过MethodChannel传递给Flutter端，完全不受焦点状态影响。

Android原生代码（Kotlin）

修改MainActivity.kt：

class MainActivity : FlutterActivity() {
    private val KEY_EVENT_CHANNEL = "your.app.package/key_events"
    private var methodChannel: MethodChannel? = null

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        methodChannel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, KEY_EVENT_CHANNEL)
    }

    override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean {
        // 捕获F16按键（KEYCODE_F16对应扫描器的物理按键）
        if (keyCode == KeyEvent.KEYCODE_F16) {
            methodChannel?.invokeMethod("onKeyDown", "F16")
            return true // 消费事件，避免传递给其他控件
        }
        return super.onKeyDown(keyCode, event)
    }

    override fun onKeyUp(keyCode: Int, event: KeyEvent?): Boolean {
        if (keyCode == KeyEvent.KEYCODE_F16) {
            methodChannel?.invokeMethod("onKeyUp", "F16")
            return true
        }
        return super.onKeyUp(keyCode, event)
    }
}

Flutter端代码

在页面中初始化MethodChannel并监听事件：

import 'package:flutter/services.dart';

late MethodChannel _keyEventChannel;

@override
void initState() {
    super.initState();
    _keyEventChannel = const MethodChannel('your.app.package/key_events');
    _keyEventChannel.setMethodCallHandler((call) async {
        switch(call.method) {
            case 'onKeyDown':
                if (call.arguments == 'F16') {
                    logger.d('F16 key pressed');
                }
                break;
            case 'onKeyUp':
                if (call.arguments == 'F16') {
                    logger.d('F16 key released');
                }
                break;
        }
    });
}

方案2：使用隐藏的TextField保持焦点激活键盘服务 #

创建一个透明、不可交互的TextField，让它始终保持焦点，从而持续激活Flutter的键盘服务，这样原有监听器就能全局捕获按键事件。

FocusNode _hiddenFocusNode = FocusNode();

@override
void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
        // 初始请求焦点
        FocusScope.of(context).requestFocus(_hiddenFocusNode);
        // 监听焦点变化，失去时重新获取
        _hiddenFocusNode.addListener(() {
            if (!_hiddenFocusNode.hasFocus) {
                Future.microtask(() => FocusScope.of(context).requestFocus(_hiddenFocusNode));
            }
        });
        // 添加原有按键监听器
        ServicesBinding.instance.keyboard.addHandler(_onKey);
    });
}

@override
Widget build(BuildContext context) {
    return Stack(
        children: [
            // 你的页面主体内容
            Scaffold(
                appBar: AppBar(title: const Text('Scanner Key Test')),
                body: const Center(child: Text('Press F16 key')),
            ),
            // 隐藏的TextField，用于保持焦点
            Opacity(
                opacity: 0.0,
                child: TextField(
                    focusNode: _hiddenFocusNode,
                    readOnly: true,
                    enableInteractiveSelection: false,
                    showCursor: false,
                    decoration: const InputDecoration(border: InputBorder.none),
                ),
            ),
        ],
    );
}

// 原有按键处理方法不变
bool _onKey(KeyEvent event) {
    logger.d('onKey called');

    if (event is KeyDownEvent) {
        if (event.physicalKey.debugName == 'F16') {
            logger.d('F16 key pressed');
        }
    } else if (event is KeyUpEvent) {
        if (event.physicalKey.debugName == 'F16') {
            logger.d('F16 key released');
        }
    }

    return false;
}

补充优化

为了避免软键盘弹出，在Android项目的AndroidManifest.xml中对应Activity添加：

<activity
    android:name=".MainActivity"
    android:windowSoftInputMode="stateAlwaysHidden">
</activity>

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