当用户聚焦到可编辑文本视图(例如 EditText 元素),并且用户连接了硬件键盘时,所有输入都由系统处理。但是,如果您想拦截或直接自行处理键盘输入,可以通过实现 KeyEvent.Callback 接口中的回调方法来实现,例如 onKeyDown() 和 onKeyMultiple()。
Activity 类和 View 类都实现了 KeyEvent.Callback 接口,因此通常您会根据需要在此类别的扩展中重写回调方法。
注意:在使用 KeyEvent 类和相关 API 处理键盘事件时,请注意键盘事件仅来自硬件键盘。切勿依赖接收软输入法(屏幕键盘)上任何按键的键事件。
处理单个按键事件
要处理单个按键按下,请根据需要实现 onKeyDown() 或 onKeyUp()。通常,如果您想确保只接收一个事件,可以使用 onKeyUp()。如果用户按住某个键,onKeyDown() 将会被多次调用。
例如,此实现响应某些键盘按键来控制游戏
Kotlin
override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean { return when (keyCode) { KeyEvent.KEYCODE_D -> { moveShip(MOVE_LEFT) true } KeyEvent.KEYCODE_F -> { moveShip(MOVE_RIGHT) true } KeyEvent.KEYCODE_J -> { fireMachineGun() true } KeyEvent.KEYCODE_K -> { fireMissile() true } else -> super.onKeyUp(keyCode, event) } }
Java
@Override public boolean onKeyUp(int keyCode, KeyEvent event) { switch (keyCode) { case KeyEvent.KEYCODE_D: moveShip(MOVE_LEFT); return true; case KeyEvent.KEYCODE_F: moveShip(MOVE_RIGHT); return true; case KeyEvent.KEYCODE_J: fireMachineGun(); return true; case KeyEvent.KEYCODE_K: fireMissile(); return true; default: return super.onKeyUp(keyCode, event); } }
处理修饰键
要响应修饰键事件,例如某个键与 Shift 或 Control 结合使用时,您可以查询传递给回调方法的 KeyEvent。有几种方法提供有关修饰键的信息,例如 getModifiers() 和 getMetaState()。但是,最简单的解决方案是使用 isShiftPressed() 和 isCtrlPressed() 等方法检查您关心的确切修饰键是否被按下。
例如,以下是 onKeyUp() 实现,增加了当 Shift 键与某个键同时按下时的额外处理
Kotlin
override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean { return when (keyCode) { ... KeyEvent.KEYCODE_J -> { if (event.isShiftPressed) { fireLaser() } else { fireMachineGun() } true } KeyEvent.KEYCODE_K -> { if (event.isShiftPressed) { fireSeekingMissle() } else { fireMissile() } true } else -> super.onKeyUp(keyCode, event) } }
Java
@Override public boolean onKeyUp(int keyCode, KeyEvent event) { switch (keyCode) { ... case KeyEvent.KEYCODE_J: if (event.isShiftPressed()) { fireLaser(); } else { fireMachineGun(); } return true; case KeyEvent.KEYCODE_K: if (event.isShiftPressed()) { fireSeekingMissle(); } else { fireMissile(); } return true; default: return super.onKeyUp(keyCode, event); } }
其他资源
- 键盘快捷键助手:允许用户搜索您的应用提供的键盘快捷键的系统屏幕。