如何从Android屏幕键盘按键事件中提取KeyCode？

一、不受键盘布局影响的Keycode获取方案 #

Android系统软键盘（InputMethod）本身没有直接暴露物理Keycode的API，因为其输入逻辑基于文本输入而非硬件按键事件。但可以通过以下两种方式绕过布局限制：

1. 自定义软键盘 #

直接开发自定义软键盘（继承InputMethodService），在每个按键的点击事件中直接绑定对应的HID Keycode。这种方式完全不受系统布局影响，因为你可以精确控制每个按键发送的Keycode：

// 自定义按键点击逻辑示例
fun onKeyClicked(keyCode: Int) {
    // 将keyCode转换为HID格式后通过BLE发送
    sendHidKeycodeOverBle(keyCode)
}

优势：完全可控，无布局适配问题；缺点：需额外开发软键盘，用户需切换到你的输入法才能使用。

2. 底层Hook方案（不推荐） #

通过AccessibilityService辅助功能监听输入事件，但需要用户授权辅助权限，且Android系统对这类监听限制严格，不同版本兼容性差，无法直接拿到原始Keycode，只能通过事件元数据间接推断，可靠性低，不建议用于生产环境。

二、通过文本变化检测适配不同布局的方案 #

如果无法使用自定义软键盘，可通过文本输入框的内容变化反向推断按键操作，需处理不同键盘布局的适配问题，具体步骤如下：

1. 基础文本变化监听 #

在Jetpack Compose中使用BasicTextField并监听onValueChange回调，记录每次输入前后的文本差异：

var text by remember { mutableStateOf("") }
var previousText by remember { mutableStateOf("") }

BasicTextField(
    value = text,
    onValueChange = { newText ->
        val diff = calculateTextDiff(previousText, newText)
        // 根据差异推断按键操作
        inferKeyFromDiff(diff)
        previousText = newText
        text = newText
    }
)

2. 差异分析与Keycode映射 #

• 单字符输入/删除：新文本比旧文本多一个字符时，推断是按下对应字符的按键；少一个字符时，推断是按下退格键（HID Keycode: 0x2A）。
• 组合键处理：比如Shift+字母输入大写字符，可通过文本中的大写字符反向推断Shift激活状态，或结合LocalTextInputService获取输入状态。
• 特殊按键：回车（0x28）、空格（0x2C）等可直接通过文本中的换行或空格字符推断。

3. 多布局适配策略 #

• 建立字符到HID Keycode的映射表：针对不同语言布局（英文、中文、日文等），提前维护字符与HID Keycode的映射关系。例如英文布局中'A'对应0x04，中文拼音布局输入'A'同样对应0x04，因为物理键盘的Keycode是统一的。
• 处理输入法候选词：中文输入法会先输入拼音再选候选词，文本变化是批量的，需过滤候选词选择场景，只处理单字符拼音输入阶段，或通过InputConnection监听输入法原始输入事件：

// 通过InputConnection监听原始输入
val inputConnection = remember {
    object : BaseInputConnection(View(context), false) {
        override fun commitText(text: CharSequence?, newCursorPosition: Int): Boolean {
            // 处理单字符输入
            if (text?.length == 1) {
                inferKeyFromChar(text[0])
            }
            return super.commitText(text, newCursorPosition)
        }
    }
}

注意事项 #

• 这种方式无法区分同一字符由不同按键输入的情况（比如英文布局中'@'通过Shift+2输入，部分布局可能是其他组合），只能映射到通用HID Keycode。
• 无法处理功能键（如Ctrl、Alt）的单独按下，因为这些按键不会产生文本变化。

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