介绍
- 在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;
// ...
}