Android 总结：自定义键盘实现原理和三种实例详解

最新推荐文章于 2025-03-14 16:27:14 发布

2401_84123201

最新推荐文章于 2025-03-14 16:27:14 发布

阅读量1.3k

点赞数 16

分类专栏：程序员文章标签： android 计算机外设

本文链接：https://blog.csdn.net/2401_84123201/article/details/137768213

版权

程序员专栏收录该内容

462 篇文章

订阅专栏

本文详细介绍了如何在Android应用中自定义虚拟键盘，包括KeyboardView的使用、按键定义、事件监听（如按键声音和输入处理）、以及解决常见问题，如键盘遮挡输入框和底部按键冲突。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

public static final int KEYCODE_SHIFT = -1;

public static final int KEYCODE_MODE_CHANGE = -2;

public static final int KEYCODE_CANCEL = -3;

public static final int KEYCODE_DONE = -4;

public static final int KEYCODE_DELETE = -5;

public static final int KEYCODE_ALT = -6;

2. KeyboardView

处理绘制，检测按键，触摸动作：

A view that renders a virtual Keyboard. It handles rendering of keys and detecting key presses and touch movements.

我们会在Activity的xml文件中这样定义：

<android.inputmethodservice.KeyboardView

android:id=“@+id/keyboard_view”

android:layout_width=“match_parent”

android:layout_height=“wrap_content”

android:layout_alignParentBottom=“true”

android:background=“@color/gray”

android:focusable=“true”

android:focusableInTouchMode=“true”

android:keyBackground=“@drawable/bg_keyboard_selector”

android:keyTextColor=“@color/keyTextColor”

android:visibility=“gone”

android:keyPreviewLayout=“@layout/key_preview_layout”

其中 android:keyPreviewLayout 指的是每当我们点击键盘上的某个键时，短暂弹出的布局。

| 属性名 | 描述 |

| — | — |

| android:keyBackground | Image for the key. |

| android:keyPreviewLayout | Layout resource for key press feedback. |

| android:keyPreviewOffset | Vertical offset of the key press feedback from the key. |

| android:keyTextColor | Color to use for the label in a key. |

| android:keyTextSize | Size of the text for character keys. |

| android:labelTextSize | Size of the text for custom keys with some text and no icon. |

| android:popupLayout | Layout resource for popup keyboards. |

| android:verticalCorrection | Amount to offset the touch Y coordinate by, for bias correction. |

我们需要建一个xml文件，来布局我们的视图，

一般是在res文件夹中建一个名为xml的文件夹，在里面新建立一个xml布局文件。

每一个按键的属性主要包括

android:codes=" " 和 android:keyLabel=""

Activity 就是根据 codes 的值来监听的。

一些可以自定义设置，一些需要是 keyboard 中设置好的，要保持一致。

二、实例解析：在xml文件中定义

1. 效果图：

在xml文件中定义的自定义键盘效果图

建一个类，用于处理软键盘事件，文件名为 KeyboardUtil.java

2. 定义键盘的键

键盘上键的细节和它的位置我们指定在一个xml文件中，每一个键都有如下的属性，

keyLabel 这个属性是指每个键显示的文本
codes 这个属性是指这个键代表的字符的unicode

例如，我们定义了一个字母A，

codes 属性的值是97，keyLabel属性的值就是A

如果一个code对应多个key，这个key代表的字符取决于这个key接受到的点击数taps，例如，一个键具有63,33,58编码：

一次点击就是 ?
两次点击就是 !
三次点击就是 :

一个 key 还可以有一些可选的属性：

keyEdgeFlags 这个属性的值可以是left或者right

这个属性通常加在一行中最左边和最右边的键上。

keyWidth 这个属性定义了键的宽度，通常是一个百分比的值。
isRepeatable 这个属性如果设置为true，那么当长按该键时就会

重复接受到该键上的动作，在 删除键键 和 空格键 上通常设为true。

键盘上的键都是按行分组，通常情况下我们每行上的键限制到10个以内

英文键盘建议每个键占整个键盘宽度的10%，我们将键的高度设置为60dp，这个值可以调整，但是不建议设置低于48dp .

有些键的code是负数，负数等于在Keyboard类

中预定义的常量，例如，-5等于Keyboard.KEYCODE_DELETE

3. 定义按键声音

创建一个方法，这个方法的作用就是当我们按下某个键时发出一个声音，我们使用 AudioManager 来播放这个声音，Android SDK给我们提供了一些键盘的声效，我们在自己定义的playClick()方法中使用。

private void playClick(int keyCode){

AudioManager am = (AudioManager)getSystemService(AUDIO_SERVICE);

switch(keyCode){

case 32:

am.playSoundEffect(AudioManager.FX_KEYPRESS_SPACEBAR);

break;

case Keyboard.KEYCODE_DONE:

case 10:

am.playSoundEffect(AudioManager.FX_KEYPRESS_RETURN);

break;

case Keyboard.KEYCODE_DELETE:

am.playSoundEffect(AudioManager.FX_KEYPRESS_DELETE);

break;

default:

am.playSoundEffect(AudioManager.FX_KEYPRESS_STANDARD);

}

4. 处理按键输入

当用户按下键盘上的一个键时，onKey()方法 会被调用，并且发送这个 键的unicode值，基于这个值，键盘可以执行以下动作：

如果code是 KEYCODE_DELETE，使用deleteSurroundingText()方法删除光标左边的字符。
如果code是 KEYCODE_DONE , KEYCODE_ENTER 事件会被发送。
如果code是 KEYCODE_SHIFT，boolean类型的caps的值会被改变，并且使用 setShifted() 方法改变键盘的换档状态(shift state)，当状态改变时，键盘需要重绘，所以的键的label被更新了，invalidateAllKeys() 方法用来重绘所有的键。
对于 其他所有的codes，只是 简单的将unicode转化为字符并且发送到输入框里，如果这个code代表了字母表里的一个字母，并且caps变量为true，那么我们需要将字母转化为大写。

修改onKey的代码(这里的功能实现方法跟实例中有偏差):

@Override

public void onKey(int primaryCode, int[] keyCodes) {

InputConnection ic = getCurrentInputConnection();

playClick(primaryCode);

switch(primaryCode){

case Keyboard.KEYCODE_DELETE :

ic.deleteSurroundingText(1, 0);

break;

case Keyboard.KEYCODE_SHIFT:

caps = !caps;

keyboard.setShifted(caps);

kv.invalidateAllKeys();

break;

case Keyboard.KEYCODE_DONE:

ic.sendKeyEvent(new KeyEvent(KeyEvent.ACTION_DOWN, KeyEvent.KEYCODE_ENTER));

break;

default:

char code = (char)primaryCode;

if(Character.isLetter(code) && caps){

code = Character.toUpperCase(code);

}

ic.commitText(String.valueOf(code),1);

}

三、实例解析：继承EditText自定义view来实现

保证不遮挡输入框，界面漂亮有动画。数字键盘可随机，支持纯色绘制按键。

1. 效果图

继承EditText自定义view来实现

这个程序有点Bug，点击输入法最底部的三个键时，虚拟按键也触发到了。

想解这个Bug的话自行再仔细研究下代码。

1. 功能特点

在输入时，保证键盘不会挡住输入框。
可以直接通过 Edittext 的属性来配置要显示的键盘布局 xml 文件。点击 Edittext 输入框即可弹出键盘。
支持属性配置 已经写好的键盘 xml 。支持属性配置 是否随机数字。
支持纯色绘制按键。默认的 keyboardview 在android2.3等低版本下不能正常显示纯色的按键背景。本示范工程通过重写原有的 keyboardview 来解决这个bug。