如何区分Jetpack Compose中EditText的键盘与扫描器输入来源？

不同输入方式的底层触发逻辑存在本质差异，不能仅依赖输入速度判断。以下是结合硬件特征、事件类型和扫描器专属行为的可靠方案：

一、区分物理键盘与软键盘 #

物理键盘输入会触发系统KeyEvent，而默认软键盘仅通过InputConnection传递文本，不会触发原生按键事件。在Compose中可通过以下方式判断：

• 物理键盘输入：通过Modifier.onKeyEvent监听，判断事件来源为InputDevice.SOURCE_KEYBOARD
• 软键盘输入：在onValueChange中，借助InputMethodManager判断软键盘是否处于显示状态

代码示例：

var text by remember { mutableStateOf("") }
val context = LocalContext.current
val inputMethodManager = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager

TextField(
    value = text,
    onValueChange = { newText ->
        // 软键盘输入时，系统输入法处于激活状态
        val isSoftKeyboardActive = inputMethodManager.isAcceptingText
        if (isSoftKeyboardActive) {
            // 判定为软键盘输入
        }
        text = newText
    },
    modifier = Modifier
        .onKeyEvent { event ->
            if (event.type == KeyEventType.KeyDown && event.source == InputDevice.SOURCE_KEYBOARD) {
                // 判定为物理键盘输入
                true
            } else {
                false
            }
        }
)

二、可靠区分扫描器与键盘输入 #

扫描器本质是模拟快速输入，但可通过以下维度精准识别，优先级从高到低：

1. 利用扫描器的配置特征（最推荐） #

绝大多数商用扫描器支持自定义前缀、后缀（如换行符\n、Tab键\t）或特殊控制码。只需在扫描器设置中开启该功能，即可通过输入内容的特征直接判定：

var text by remember { mutableStateOf("") }

TextField(
    value = text,
    onValueChange = { newText ->
        if (newText.endsWith("\n")) {
            // 判定为扫描器输入，处理时移除后缀
            val scannedContent = newText.trimEnd('\n')
            // 执行扫描内容的业务逻辑
            text = scannedContent
        } else {
            // 常规键盘输入
            text = newText
        }
    }
)

2. 结合输入间隔+批量输入特征 #

扫描器输入的字符间隔通常<20ms，且多为连续批量输入；人工打字间隔一般>100ms，且单次输入单个字符。优化速度判断逻辑，加入批量输入检测：

var text by remember { mutableStateOf("") }
val lastInputTime = remember { mutableStateOf(System.currentTimeMillis()) }
val consecutiveFastInputs = remember { mutableStateOf(0) }
const val FAST_INPUT_THRESHOLD = 20 // 毫秒阈值
const val CONSECUTIVE_THRESHOLD = 3 // 连续快速输入次数阈值

TextField(
    value = text,
    onValueChange = { newText ->
        val currentTime = System.currentTimeMillis()
        val timeDiff = currentTime - lastInputTime.value
        
        if (newText.length > text.length) {
            val addedCharsCount = newText.length - text.length
            if (addedCharsCount > 1) {
                // 一次性输入多个字符，直接判定为扫描器
                consecutiveFastInputs.value = CONSECUTIVE_THRESHOLD
            } else {
                consecutiveFastInputs.value = if (timeDiff < FAST_INPUT_THRESHOLD) {
                    consecutiveFastInputs.value + 1
                } else {
                    0
                }
            }
            
            if (consecutiveFastInputs.value >= CONSECUTIVE_THRESHOLD) {
                // 判定为扫描器输入
            } else {
                // 常规键盘输入
            }
        }
        
        lastInputTime.value = currentTime
        text = newText
    }
)

3. 识别扫描器硬件设备 #

部分外接扫描器作为HID设备，会在系统中显示专属设备名称。可通过输入事件的设备ID获取硬件信息：

val context = LocalContext.current

TextField(
    value = text,
    modifier = Modifier
        .onKeyEvent { event ->
            val device = InputDevice.getDevice(event.deviceId)
            if (device != null && device.name.contains("Scanner", ignoreCase = true)) {
                // 判定为扫描器输入
                true
            }
            false
        }
)

三、综合判断逻辑 #

建议按以下优先级组合判断，覆盖绝大多数场景：

1. 扫描器配置的前缀/后缀 → 2. 硬件设备识别 → 3. 输入间隔+批量特征

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