鍵盤設備

Android 支援多種鍵盤設備，包括特殊功能鍵盤（音量和電源控制）、緊湊型嵌入式 QWERTY 鍵盤以及功能齊全的 PC 式外部鍵盤。

本文檔僅描述實體鍵盤。有關軟鍵盤（輸入法編輯器）的信息，請參閱 Android SDK。

鍵盤分類

如果滿足以下任一條件，則輸入裝置被歸類為鍵盤：

• 輸入裝置報告鍵盤上使用的任何 Linux 鍵碼的存在，包括0到0xff或KEY_OK到KEY_MAX 。

• 輸入裝置報告操縱桿和遊戲手把上使用的任何 Linux 按鍵代碼的存在，包括BTN_0到BTN_9 、 BTN_TRIGGER到BTN_DEAD或BTN_A到BTN_THUMBR 。

操縱桿目前被歸類為鍵盤，因為EV_KEY事件報告操縱桿和遊戲手把按鈕的方式與報告鍵盤按鍵的方式相同。因此，操縱桿和遊戲手把也利用按鍵映射檔進行配置。

一旦輸入裝置被分類為鍵盤，系統就會載入輸入裝置設定檔和鍵盤的鍵盤佈局。

然後系統嘗試確定設備的其他特徵。

• 如果輸入裝置具有映射到KEYCODE_Q的任何鍵，則該裝置被視為具有字母鍵盤（而不是數字鍵盤）。字母鍵盤功能在資源Configuration物件中報告為KEYBOARD_QWERTY 。

• 如果輸入裝置具有對應到KEYCODE_DPAD_UP 、 KEYCODE_DPAD_DOWN 、 KEYCODE_DPAD_LEFT 、 KEYCODE_DPAD_RIGHT和KEYCODE_DPAD_CENTER的任何鍵（全部都必須存在），則該裝置被視為具有方向鍵盤。方向鍵盤功能在資源Configuration物件中報告為NAVIGATION_DPAD 。

• 如果輸入裝置具有任何對應到KEYCODE_BUTTON_A或其他遊戲手把相關按鍵的按鍵，則該裝置被視為具有遊戲手把。

鍵盤驅動程式要求

1. 鍵盤驅動程式應該只註冊它們實際支援的按鍵的按鍵代碼。註冊過多的鍵代碼可能會混淆設備分類演算法或導致系統錯誤地檢測設備支援的鍵盤功能。

2. 鍵盤驅動程式應使用EV_KEY來報告按鍵按下情況，使用值0表示按鍵被釋放，值為1表示按鍵被按下，值大於或等於2表示按鍵被按下自動重複。

3. Android 執行自己的鍵盤重複操作。應在驅動程式中停用自動重複功能。

4. 鍵盤驅動程式可以選擇透過發送帶有MSC_SCANCODE EV_MSC以及指示按下按鍵時的用途或掃描代碼的值來指示 HID 用途或低階掃描代碼。 Android 目前未使用此資訊。

5. 當EV_LED寫入裝置時，鍵盤驅動程式應支援設定 LED 狀態。 hid-input驅動程式會自動處理此問題。在撰寫本文時，Android 使用LED_CAPSLOCK 、 LED_SCROLLLOCK和LED_NUMLOCK 。僅當鍵盤實際具有相關指示燈時才需要支援這些 LED。

6. 嵌入式鍵盤的鍵盤驅動程式（例如，使用 GPIO 矩陣）應確保為裝置即將休眠時仍按下的任何鍵發送值為0的EV_KEY事件。否則按鍵可能會卡住並永遠自動重複。

鍵盤操作

下面簡單總結Android上的鍵盤操作。

1. EventHub從evdev驅動程式讀取原始事件，並使用鍵盤的按鍵佈局圖將 Linux 按鍵代碼（有時稱為掃描代碼）對應到 Android 按鍵代碼。

2. InputReader使用原始事件並更新元鍵狀態。例如，如果按下或釋放左移鍵，閱讀器將相應地設定或重設META_SHIFT_LEFT_ON和META_SHIFT_ON位。

3. InputReader通知InputDispatcher有關按鍵事件的資訊。

4. InputDispatcher透過呼叫WindowManagerPolicy.interceptKeyBeforeQueueing詢問WindowManagerPolicy如何處理按鍵事件。此方法是關鍵路徑的一部分，負責在按下某些按鍵時喚醒裝置。 EventHub有效地沿著這條關鍵路徑持有喚醒鎖定，以確保它將運作完成。

5. 如果目前正在使用InputFilter ，則InputDispatcher會為其提供使用或轉換鍵的機會。 InputFilter可用於實現低階系統範圍的可存取性策略。

6. InputDispatcher將鍵放入佇列以便在調度執行緒上進行處理。

7. 當InputDispatcher將鍵入隊伍時，它會透過呼叫WindowManagerPolicy.interceptKeyBeforeDispatching為WindowManagerPolicy提供第二次攔截按鍵事件的機會。此方法處理系統捷徑和其他功能。

8. 然後， InputDispatcher識別關鍵事件目標（聚焦視窗）並等待它們準備好。然後， InputDispatcher將按鍵事件傳遞給應用程式。

9. 在應用程式內部，按鍵事件沿著視圖層次結構傳播到焦點視圖，以進行預 IME 按鍵調度。

10. 如果在預 IME 調度中未處理按鍵事件且 IME 正在使用，則按鍵事件將傳遞到 IME。

11. 如果 IME 未使用按鍵事件，則按鍵事件將沿著視圖層次結構向下傳播到焦點視圖以進行標準按鍵調度。

12. 應用程式向InputDispatcher報告按鍵事件是否已被消耗。如果事件沒有被消耗， InputDispatcher呼叫WindowManagerPolicy.dispatchUnhandledKey來套用「後備」行為。根據回退操作，可以使用不同的鍵代碼重新啟動鍵事件調度週期。例如，如果應用程式不處理KEYCODE_ESCAPE ，系統可能會將按鍵事件重新分派為KEYCODE_BACK 。

鍵盤配置

鍵盤行為由鍵盤的按鍵佈局、按鍵字元映射和輸入裝置配置決定。

有關參與鍵盤配置的文件的更多詳細信息，請參閱以下部分：

• 關鍵佈局文件
• 關鍵字元映射文件
• 輸入設備設定檔

特性

以下輸入設備配置屬性用於鍵盤。

鍵盤佈局

定義： keyboard.layout = <姓名>

指定與輸入設備關聯的按鍵佈局檔的名稱，不包括.kl副檔名。如果找不到該文件，輸入系統將使用預設的按鍵佈局。

名稱中的空格在查找過程中會轉換為底線。

有關更多詳細信息，請參閱按鍵佈局文件文檔。

鍵盤.字元映射表

定義： keyboard.characterMap = <名稱>

指定與輸入裝置關聯的按鍵字元對映檔案的名稱，不包含.kcm副檔名。如果找不到該文件，輸入系統將使用預設的鍵字元對應表。

名稱中的空格在查找過程中會轉換為底線。

有關更多詳細信息，請參閱按鍵字元映射文件文檔。

鍵盤方向感知

定義： keyboard.orientationAware = 0 | 1

指定鍵盤是否應對顯示方向變更做出反應。

• 如果值為1 ，則當關聯的顯示方向變更時，方向鍵盤按鍵將旋轉。

• 如果值為0 ，鍵盤不受顯示方向變化的影響。

預設值為0 。

方向感知用於支援方向鍵盤按鍵的旋轉，例如在摩托羅拉 Droid 上。例如，當裝置從其自然方向順時針旋轉 90 度時， KEYCODE_DPAD_UP會重新映射以產生KEYCODE_DPAD_RIGHT ，因為當裝置保持在該方向時，「向上」鍵最終會指向「右」。

鍵盤內建

定義： keyboard.builtIn = 0 | 1

指定鍵盤是否為內建（實體連接）鍵盤。

如果裝置名稱以-keypad結尾，則預設值為1 ，否則為0 。

內建鍵盤始終分配的裝置 ID 為0 。其他非內建鍵盤被分配唯一的非零設備 ID。

對內建鍵盤使用 id 0對於保持與KeyCharacterMap.BUILT_IN_KEYBOARD欄位的相容性非常重要，該欄位指定內建鍵盤的 id 且值為0 。該欄位已在 API 中棄用，但較舊的應用程式可能仍在使用它。

無論此屬性如何設置，特殊功能鍵盤（其鍵字元映射指定SPECIAL_FUNCTION類型的鍵盤）都永遠不會註冊為內建鍵盤。這是因為根據定義，特殊功能鍵盤不適合用於通用打字。

配置範例

# This is an example input device configuration file for a built-in
# keyboard that has a DPad.

# The keyboard is internal because it is part of the device.
device.internal = 1

# The keyboard is the default built-in keyboard so it should be assigned
# an id of 0.
keyboard.builtIn = 1

# The keyboard includes a DPad which is mounted on the device.  As the device
# is rotated the orientation of the DPad rotates along with it, so the DPad must
# be aware of the display orientation.  This ensures that pressing 'up' on the
# DPad always means 'up' from the perspective of the user, even when the entire
# device has been rotated.
keyboard.orientationAware = 1

相容性說明

在 Honeycomb 之前，鍵盤輸入映射器不會使用任何配置屬性。假設所有鍵盤都是物理連接的並且具有方向意識。預設的按鍵佈局和按鍵字元映射被命名為qwerty而不是Generic 。鍵字元映射格式也有很大不同，框架不支援 PC 風格的全鍵盤或外部鍵盤。

將裝置升級至 Honeycomb 時，請確保建立或更新必要的設定和鍵映射檔案。

HID 用法、Linux 金鑰代碼和 Android 金鑰代碼

系統根據抽象層使用幾個不同的標識符來引用密鑰。

對於 HID 設備，每個金鑰都有一個關聯的 HID 用途。 Linux hid-input驅動程式以及相關供應商和裝置特定的 HID 驅動程式負責解析 HID 報告並將 HID 用法對應到 Linux 關鍵程式碼。

Android 從 Linux 核心讀取EV_KEY事件時，會根據裝置的按鍵佈局檔案將每個 Linux 按鍵程式碼翻譯成對應的 Android 按鍵程式碼。

當按鍵事件被分派到應用程式時， android.view.KeyEvent實例將 Linux 按鍵程式碼報告為getScanCode()的值，將 Android 按鍵程式碼報告為getKeyCode()的值。就框架而言，只有getKeyCode()的值很重要。

請注意，HID 使用資訊不會被 Android 本身使用或傳遞給應用程式。

代碼表

下表顯示了 HID 用法、Linux 金鑰代碼和 Android 金鑰代碼之間的相互關係。

LKC 欄位指定十六進位的 Linux 金鑰代碼。

AKC 欄位指定十六進位的 Android 金鑰代碼。

註釋列是指在表格之後發布的註釋。

版本列指定在其預設鍵映射中包含此鍵的 Android 平台的第一個版本。如果預設鍵映射在版本之間發生更改，則會顯示多行。指示的最舊版本是 1.6。

• 在 Gingerbread (2.3) 及更早版本中，預設鍵映射是qwerty.kl 。此按鍵映射僅適用於 Android 模擬器，並不適用於支援任意外部鍵盤。儘管如此，一些 OEM 仍為平台添加了藍牙鍵盤支持，並依靠qwerty.kl提供必要的鍵盤映射。因此，為這些特定設備建造週邊設備的 OEM 可能會對這些舊映射感興趣。請注意，這些映射與目前的映射有很大不同，特別是在HOME鍵的處理方面。建議所有新週邊設備均根據 Honeycomb 或更新的按鍵映射（即標準 HID）進行開發。

• 從 Honeycomb (3.0) 開始，預設鍵映射是Generic.kl 。此鍵映射旨在支援完整的 PC 風格鍵盤。標準 HID 鍵盤的大多數功能應該開箱即可使用。

關鍵程式碼映射可能因 Linux 核心和 Android 版本而異。當已知 Android 預設鍵映射中發生變更時，它們會在版本列中指示。

裝置特定的 HID 驅動程式和按鍵映射可能會套用與此處所示不同的映射。

HID 鍵盤與小鍵盤頁面 (0x07)

HID 通用桌面頁面 (0x01)

HID 消費者頁面 (0x0c)

其他非HID映射

這些映射描述了沒有出現在HID中但存在Linux密鑰代碼的功能。

遺產不支持的鑰匙

這些映射出現在先前的Android版本中，但與HID或使用非標準Linux密鑰代碼不一致。他們不再得到支持。

筆記

1. 與常見字母數字和符號鍵關聯的Android鍵代碼可能會根據鍵盤佈局和語言而變化。由於歷史原因，即使在這些鍵上列印的標籤可能會因一種語言而異，即使在鍵盤上與金鑰相關的實體掃描程式碼和隱藏用法通常是定義的。

   在美國英語（QWERTY）鍵盤上，左上角的字母鍵標記為Q。在法語（Azerty）鍵盤上，同一位置的鍵被標記為A.指的是使用HID用法0x07 0x0014，該0x0014映射到Linux密鑰程式碼key_q。

   當使用美國英語鍵盤佈局配置Android時，Linux鍵代碼鍵_Q將對應到Android鍵代碼keycode_q，並產生字元'q'和'q'。但是，當使用法國鍵盤佈局配置Android時，Linux鍵代碼key_q將對應到Android鍵代碼keycode_a，並產生字元「 A」和「 A」。

   Android密鑰代碼通常反映了鍵的特定語言解釋，因此可以將不同的Android密鑰代碼用於不同的語言。

2. 0x0c 0x022f AC Zoom在HID中定義為線性控件，但核心將其映射為鍵，這可能是不正確的。

3. Linux函數鍵KEY_FN_*對應到更簡單的金鑰程式碼，但使用META_FUNCTION元狀態位元設定為true。

4. 在使用Android冰淇淋三明治4.0之前，預設的鍵佈局包含一些額外的密鑰代碼的映射，這些密鑰代碼未在Mainline Linux核心標題中定義。此後，這些映射已被刪除，因為此後這些以前未定義的密鑰代碼在Linux核心的最新版本中被分配了不同的含義。

來源

1. USB HID使用表v1.12
2. Linux 2.6.39核心：include/linux/input.h，驅動程式/hid/hid-input.c
3. Android ICS：qwerty.kl，generic.kl，keyevent.java