如何在Jetpack Compose（Kotlin）中检测虚拟键盘大写锁定状态

在Android Jetpack Compose中，系统没有直接提供监听虚拟键盘Caps Lock状态的API（虚拟键盘多为第三方实现，行为不统一），但可以通过文本输入特征+键盘事件监听的组合方案来推断状态，进而在TextField内显示对应图标。

实现步骤与代码示例 #

@Composable
fun CapsLockAwareTextField() {
    var inputText by remember { mutableStateOf("") }
    var isCapsLockActive by remember { mutableStateOf(false) }
    var lastInputWasUpper by remember { mutableStateOf(false) }

    TextField(
        value = inputText,
        onValueChange = { newText ->
            inputText = newText
            if (newText.isNotEmpty()) {
                val currentChar = newText.last()
                val isCurrentUpper = currentChar.isUpperCase() && currentChar.isLetter()

                // 通过连续输入的大写字符判断Caps Lock状态
                when {
                    newText.length > 1 -> {
                        val prevChar = newText[newText.length - 2]
                        val isPrevUpper = prevChar.isUpperCase() && prevChar.isLetter()
                        isCapsLockActive = isCurrentUpper && isPrevUpper
                        if (!isCurrentUpper && lastInputWasUpper) {
                            isCapsLockActive = false
                        }
                    }
                    isCurrentUpper -> {
                        // 单个大写字符大概率是Shift临时输入，不判定为Caps Lock
                        isCapsLockActive = false
                    }
                }
                lastInputWasUpper = isCurrentUpper
            } else {
                // 文本清空时重置状态
                isCapsLockActive = false
                lastInputWasUpper = false
            }
        },
        onKeyEvent = { keyEvent ->
            // 监听物理键盘的Caps Lock按键切换
            if (keyEvent.key == Key.CapsLock && keyEvent.type == KeyEventType.KeyUp) {
                isCapsLockActive = !isCapsLockActive
                return@TextField true
            }
            // 监听Shift键，松开时重置Caps Lock状态（Shift仅临时大写）
            if ((keyEvent.key == Key.ShiftLeft || keyEvent.key == Key.ShiftRight) 
                && keyEvent.type == KeyEventType.KeyUp) {
                isCapsLockActive = false
            }
            false
        },
        trailingIcon = {
            if (isCapsLockActive) {
                Icon(
                    imageVector = Icons.Default.CapsLock,
                    contentDescription = "大写锁定已开启"
                )
            }
        },
        label = { Text("输入文本") }
    )
}

方案说明 #

1. 文本特征推断：通过连续输入的大写字母判定Caps Lock状态——当连续输入2个及以上大写字母时，认为Caps Lock已开启，避免首字母大写的误判。
2. 键盘事件监听：针对物理键盘的Caps Lock按键直接监听状态切换；同时监听Shift键，松开时重置Caps Lock状态（Shift仅触发临时大写）。
3. 局限性：由于虚拟键盘厂商实现差异，部分小众键盘的Caps Lock状态可能无法完全覆盖，该方案为当前可行的妥协方案。

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