Flutter：连接条码扫描器后如何调出系统虚拟键盘？

蓝牙扫描器默认以HID（模拟键盘）模式工作时，会抢占系统输入设备优先级，导致Flutter的文本字段无法唤起系统键盘。试试以下几种解决方法：

1. 手动强制唤起系统键盘 #

给需要输入文本的字段绑定FocusNode，通过Flutter的TextInput类直接触发键盘弹出，绕过系统输入设备的优先级限制：

late FocusNode _textFieldFocusNode;

@override
void initState() {
  super.initState();
  _textFieldFocusNode = FocusNode();
}

@override
void dispose() {
  _textFieldFocusNode.dispose();
  super.dispose();
}

void _forceShowKeyboard() {
  FocusScope.of(context).requestFocus(_textFieldFocusNode);
  TextInput.show(
    configuration: const TextInputConfiguration(
      inputType: TextInputType.text,
    ),
  );
}

// 构建文本输入字段
TextField(
  focusNode: _textFieldFocusNode,
  onTap: _forceShowKeyboard,
  decoration: const InputDecoration(labelText: "输入文本"),
)

2. 切换扫描器的工作模式 #

多数蓝牙扫描器支持切换输入模式：

• 从HID模拟键盘模式切换到SPP串口模式或USB虚拟串口模式，这样扫描器的输入不会抢占系统键盘控制权，Flutter可以正常处理两个字段的输入。
• 具体切换方法参考扫描器的说明书，通常是通过扫描特定的配置条码来完成模式切换。

3. 监听焦点切换，强制触发键盘 #

通过监听文本字段的焦点状态，在获取焦点时直接调用系统通道方法唤起键盘：

void _onFocusChange(bool hasFocus) {
  if (hasFocus) {
    FocusScope.of(context).requestFocus(_textFieldFocusNode);
    // 调用系统文本输入通道强制显示键盘
    SystemChannels.textInput.invokeMethod('TextInput.show');
  }
}

// 文本字段配置
TextField(
  focusNode: _textFieldFocusNode
    ..addListener(() => _onFocusChange(_textFieldFocusNode.hasFocus)),
  decoration: const InputDecoration(labelText: "输入文本"),
)

4. 改用串口方式接收扫描数据 #

如果扫描器支持串口模式，使用bluetooth_serial这类插件直接读取扫描数据，而不是依赖HID模拟输入。这种方式完全独立于系统键盘，不会影响文本字段的正常输入。

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