Android设备聚焦输入框时如何阻止系统键盘弹出（Flutter/Kotlin）

方案1：通过TextInputType.none阻止键盘弹出 #

无需依赖原生代码，直接给透明输入框设置textInputType: TextInputType.none，聚焦时不会唤起系统键盘，同时能保持焦点接收扫描设备输入的QR数据：

final FocusNode _qrFocusNode = FocusNode();
final TextEditingController _qrInputController = TextEditingController();

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

void _handleQrData(String data) {
  // 处理扫描到的QR码数据，比如更新订单状态
  print("扫描到收据QR数据：$data");
  // 清空输入框，准备下一次扫描
  _qrInputController.clear();
}

// 页面中的透明输入框
Opacity(
  opacity: 0,
  child: TextField(
    focusNode: _qrFocusNode,
    controller: _qrInputController,
    onChanged: _handleQrData,
    textInputType: TextInputType.none,
    decoration: const InputDecoration(border: InputBorder.none),
    enableInteractiveSelection: false, // 禁用文本选择，避免误操作
    cursorWidth: 0, // 隐藏光标
  ),
)

方案2：通过MethodChannel调用原生代码强制隐藏键盘 #

如果方案1在部分特殊设备上不生效，可以通过原生代码强制隐藏键盘，同时保留输入框焦点：

1. Flutter端代码：

final FocusNode _qrFocusNode = FocusNode();
const MethodChannel _channel = MethodChannel('com.kitchen.qr/hide_keyboard');

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    FocusScope.of(context).requestFocus(_qrFocusNode);
    _hideSystemKeyboard();
  });
}

Future<void> _hideSystemKeyboard() async {
  try {
    await _channel.invokeMethod('hide');
  } on PlatformException catch (e) {
    print("隐藏键盘失败：${e.message}");
  }
}

// 透明输入框部分同方案1，移除textInputType设置即可

2. Android原生MainActivity.kt代码：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.kitchen.qr/hide_keyboard"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "hide") {
                val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
                currentFocus?.let {
                    imm.hideSoftInputFromWindow(it.windowToken, 0)
                    result.success(null)
                } ?: result.error("NO_FOCUS", "未获取到焦点视图", null)
            } else {
                result.notImplemented()
            }
        }
    }
}

如果直接用Kotlin开发，只需配置透明EditText并阻止键盘弹出即可：

1. 布局文件添加透明EditText：

<EditText
    android:id="@+id/et_qr_scan"
    android:layout_width="0dp"
    android:layout_height="0dp"
    android:alpha="0"
    android:focusable="true"
    android:focusableInTouchMode="true"
    android:inputType="textNoSuggestions"
    android:cursorVisible="false"/>

2. Activity中处理焦点和扫描数据：

val etQrScan = findViewById<EditText>(R.id.et_qr_scan)

// 初始化时请求焦点
etQrScan.requestFocus()

// 监听扫描数据输入
etQrScan.addTextChangedListener(object : TextWatcher {
    override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}

    override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {
        s?.toString()?.let { qrData ->
            // 处理QR数据，比如更新订单处理状态
            processQrData(qrData)
            // 清空输入框，准备下一次扫描
            etQrScan.setText("")
        }
    }

    override fun afterTextChanged(s: Editable?) {}
})

// 强制隐藏系统键盘
val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
imm.hideSoftInputFromWindow(etQrScan.windowToken, 0)

// 焦点变化时再次隐藏键盘，防止意外唤起
etQrScan.onFocusChangeListener = View.OnFocusChangeListener { _, hasFocus ->
    if (hasFocus) {
        imm.hideSoftInputFromWindow(etQrScan.windowToken, 0)
    }
}

fun processQrData(data: String) {
    // 业务逻辑：解析收据QR码、同步订单状态等
    println("处理收据QR数据：$data")
}

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