Android中的KeyEvent详解

介绍

• 在Android中，KeyEvent 是用来表示按键事件的类，可根据对应的事件来处理按键输入，具体包含了关于按键事件的信息，例如按键的代码、动作（按下或释放）以及事件的时间戳，KeyEvent 对象通常在用户与设备上的物理或软件键盘交互时产生，KeyEvent可以帮助开发者创建更加互动和响应式的应用程序

KeyEvent 的主要属性

• keyCode：这是一个整数值，表示按下的键。Android 定义了一系列的键码常量，如 KeyEvent.KEYCODE_A、KeyEvent.KEYCODE_ENTER 等
• action：这是一个枚举值，表示按键的动作。它可以是 ACTION_DOWN（按键按下）、ACTION_UP（按键释放）或 ACTION_MULTIPLE（多次按键）
• eventTime：这是一个长整数值，表示事件发生的时间戳，通常是从系统启动到事件发生的时间（以毫秒为单位）
• repeatCount：这是一个整数值，表示按键重复的次数。如果用户长时间按住一个键，系统可能会多次发送 ACTION_DOWN 事件，这个值就会增加

KeyEvent 的使用场景

• 监听按键事件：你可以在 Activity 或 View 中重写 onKeyDown、onKeyLongPress、onKeyUp 方法来监听和处理按键事件
• 处理输入：在用户输入文本时，你可以使用 KeyEvent 来处理字符输入和特殊按键（如删除键、回车键等）
• 游戏开发：在游戏开发中，KeyEvent 可以用来监听玩家的按键操作，如移动角色或触发游戏动作
• 自定义控件：如果你创建了一个自定义控件，并希望它能够响应特定的按键操作，你可以使用 KeyEvent 来实现这一功能

基本使用

Activity 中监听按键事件的示例代码：

import android.view.KeyEvent;
import androidx.appcompat.app.AppCompatActivity;

public class MyActivity extends AppCompatActivity {

    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_ENTER) {
            // 处理回车键事件
            return true;
        }
        return super.onKeyDown(keyCode, event);
    }

    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_ENTER) {
            // 处理回车键释放事件
            return true;
        }
        return super.onKeyUp(keyCode, event);
    }

    @Override
    public boolean onKeyLongPress(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_ENTER) {
            // 处理回车键长按事件
            return true;
        }
        return super.onKeyLongPress(keyCode, event);
    }
}

• 如上，重写onKeyDown、onKeyUp 和 onKeyLongPress 方法来监听回车键的事件，如果用户按下或释放回车键，或者长时间按住回车键，这些方法将被调用，并且可以根据需要处理事件
• Android设备相关的所有按键、对应事件都存储在KeyEvent类中，其源代码如下：

public class KeyEvent extends InputEvent implements Parcelable {
    // 未知按键
    public static final int KEYCODE_UNKNOWN         = 0;
    // 向左的按钮
    public static final int KEYCODE_SOFT_LEFT       = 1;
    public static final int KEYCODE_SOFT_RIGHT      = 2;
    // 回到应用HOME的按钮
    public static final int KEYCODE_HOME            = 3;
    // 返回键   
    public static final int KEYCODE_BACK            = 4;

    public static final int KEYCODE_CALL            = 5;
    /** Key code constant: End Call key. */
    public static final int KEYCODE_ENDCALL         = 6;
    //数字0~9的按键
    public static final int KEYCODE_0               = 7;
    public static final int KEYCODE_1               = 8;
    public static final int KEYCODE_2               = 9;

    /** Key code constant: '*' key. */
    public static final int KEYCODE_STAR            = 17;
    /** Key code constant: '#' key. */
    public static final int KEYCODE_POUND           = 18;
    /** Key code constant: Directional Pad Up key.
     * May also be synthesized from trackball motions. */
    public static final int KEYCODE_DPAD_UP         = 19;
    /** Key code constant: Directional Pad Down key.
     * May also be synthesized from trackball motions. */
    public static final int KEYCODE_DPAD_DOWN       = 20;
    /** Key code constant: Directional Pad Left key.
     * May also be synthesized from trackball motions. */
    public static final int KEYCODE_DPAD_LEFT       = 21;
    /** Key code constant: Directional Pad Right key.
     * May also be synthesized from trackball motions. */
    public static final int KEYCODE_DPAD_RIGHT      = 22;
    /** Key code constant: Directional Pad Center key.
     * May also be synthesized from trackball motions. */
    public static final int KEYCODE_DPAD_CENTER     = 23;
    /** Key code constant: Volume Up key.
     * Adjusts the speaker volume up. */
    public static final int KEYCODE_VOLUME_UP       = 24;
    /** Key code constant: Volume Down key.
     * Adjusts the speaker volume down. */
    public static final int KEYCODE_VOLUME_DOWN     = 25;
    /** Key code constant: Power key. */
    public static final int KEYCODE_POWER           = 26;
    /** Key code constant: Camera key.
     * Used to launch a camera application or take pictures. */
    public static final int KEYCODE_CAMERA          = 27;
    /** Key code constant: Clear key. */
    public static final int KEYCODE_CLEAR           = 28;
    // 英文字母A~Z的按键
    public static final int KEYCODE_A               = 29;
    /** Key code constant: 'B' key. */
    public static final int KEYCODE_B               = 30;
    /** Key code constant: 'C' key. */
    public static final int KEYCODE_C               = 31;
    // ...
    public static final int KEYCODE_Z               = 54;
    /** Key code constant: ',' key. */
    public static final int KEYCODE_COMMA           = 55;
    /** Key code constant: '.' key. */
    public static final int KEYCODE_PERIOD          = 56;
    /** Key code constant: Left Alt modifier key. */
    public static final int KEYCODE_ALT_LEFT        = 57;
    /** Key code constant: Right Alt modifier key. */
    public static final int KEYCODE_ALT_RIGHT       = 58;
    /** Key code constant: Left Shift modifier key. */
    public static final int KEYCODE_SHIFT_LEFT      = 59;
    /** Key code constant: Right Shift modifier key. */
    public static final int KEYCODE_SHIFT_RIGHT     = 60;
    /** Key code constant: Tab key. */
    public static final int KEYCODE_TAB             = 61;
    /** Key code constant: Space key. */
    public static final int KEYCODE_SPACE           = 62;
    
    // ...
}