Tastaturgeräte

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Android unterstützt eine Vielzahl von Tastaturen, darunter Tastaturen mit speziellen Funktionen (Lautstärke- und Ein-/Aus-Tasten), kompakte eingebettete QWERTY-Tastaturen und vollwertige externe Tastaturen im PC-Stil.

In diesem Dokument werden nur physische Tastaturen beschrieben. Informationen zu Soft-Tastaturen (Input Method Editors) finden Sie im Android SDK.

Tastaturklassifizierung

Ein Eingabegerät wird als Tastatur klassifiziert, wenn eine der folgenden Bedingungen erfüllt ist:

• Das Eingabegerät meldet die Anwesenheit aller Linux-Tastencodes, die auf Tastaturen verwendet werden, einschließlich 0 bis 0xff oder KEY_OK bis KEY_MAX.

• Das Eingabegerät meldet die Anwesenheit von Linux-Tastencodes, die auf Joysticks und Gamepads verwendet werden, einschließlich BTN_0 bis BTN_9, BTN_TRIGGER bis BTN_DEAD oder BTN_A bis BTN_THUMBR.

Joysticks werden derzeit als Tastaturen klassifiziert, da Joystick- und Gamepad-Tasten auf die gleiche Weise wie Tastaturtasten über EV_KEY-Ereignisse erfasst werden. Daher werden auch Joysticks und Gamepads mithilfe von Tastenbelegungsdateien konfiguriert.

Sobald ein Eingabegerät als Tastatur klassifiziert wurde, lädt das System die Konfigurationsdatei des Eingabegeräts und das Tastaturlayout für die Tastatur.

Das System versucht dann, weitere Merkmale des Geräts zu ermitteln.

• Wenn das Eingabegerät Tasten hat, die auf KEYCODE_Q bezogen sind, wird davon ausgegangen, dass es eine alphanumerische Tastatur (im Gegensatz zu einer numerischen) hat. Die alphanumerische Tastatur wird im Configuration-Objekt der Ressource als KEYBOARD_QWERTY gemeldet.

• Wenn das Eingabegerät Tasten hat, die auf KEYCODE_DPAD_UP, KEYCODE_DPAD_DOWN, KEYCODE_DPAD_LEFT, KEYCODE_DPAD_RIGHT und KEYCODE_DPAD_CENTER (alle müssen vorhanden sein) zugewiesen sind, gilt es als Gerät mit Richtungstasten. Die Richtungstastenfunktion wird im Configuration-Objekt der Ressource als NAVIGATION_DPAD gemeldet.

• Wenn das Eingabegerät Tasten hat, die auf KEYCODE_BUTTON_A oder andere Gamepad-Tasten zugeordnet sind, wird davon ausgegangen, dass das Gerät ein Gamepad hat.

Anforderungen an Tastaturtreiber

1. Tastaturtreiber sollten nur Tastencodes für die Tasten registrieren, die sie tatsächlich unterstützen. Wenn Sie zu viele Tastencodes registrieren, kann das den Geräteklassifizierungsalgorithmus verwirren oder dazu führen, dass das System die unterstützten Tastaturfunktionen des Geräts falsch erkennt.

2. Tastaturtreiber sollten EV_KEY verwenden, um Tastendrücke zu melden. Mit dem Wert 0 wird angegeben, dass eine Taste losgelassen wird, mit dem Wert 1, dass eine Taste gedrückt wird, und mit einem Wert größer oder gleich 2, dass die Taste automatisch wiederholt wird.

3. Android führt seine eigene Tastaturwiederholung aus. Die Funktion „Automatischer Wiederholungszeitraum“ sollte im Treiber deaktiviert sein.

4. Tastaturtreiber können optional die HID-Nutzung oder den Low-Level-Scancode angeben, indem sie EV_MSC mit MSC_SCANCODE und einen Wert senden, der die Nutzung oder den Scancode angibt, wenn die Taste gedrückt wird. Diese Informationen werden derzeit nicht von Android verwendet.

5. Tastaturtreiber sollten das Festlegen von LED-Zuständen unterstützen, wenn EV_LED auf das Gerät geschrieben wird. Der hid-input-Treiber übernimmt das automatisch. Zum Zeitpunkt der Erstellung dieses Artikels werden unter Android LED_CAPSLOCK, LED_SCROLLLOCK und LED_NUMLOCK verwendet. Diese LEDs müssen nur unterstützt werden, wenn die Tastatur die entsprechenden LEDs hat.

6. Tastaturtreiber für eingebettete Tastaturen (z. B. mit einer GPIO-Matrix) müssen EV_KEY-Ereignisse mit dem Wert 0 für alle Tasten senden, die beim Einschlafen des Geräts noch gedrückt sind. Andernfalls bleiben Tasten möglicherweise gedrückt und werden automatisch wiederholt.

Tastaturbedienung

Im Folgenden finden Sie eine kurze Zusammenfassung der Bedienung der Tastatur unter Android.

1. Der EventHub liest Rohereignisse aus dem evdev-Treiber und ordnet Linux-Tastencodes (manchmal auch als Scancodes bezeichnet) mithilfe der Tastenlayoutzuordnung der Tastatur Android-Tastencodes zu.

2. Der InputReader verarbeitet die Rohereignisse und aktualisiert den Metaschlüsselstatus. Wenn beispielsweise die Umschalttaste gedrückt oder losgelassen wird, setzt oder setzt der Leser die Bits META_SHIFT_LEFT_ON und META_SHIFT_ON entsprechend zurück.

3. Der InputReader benachrichtigt den InputDispatcher über das Schlüsselereignis.

4. Die InputDispatcher fragt die WindowManagerPolicy, was mit dem Schlüsselereignis geschehen soll, indem sie WindowManagerPolicy.interceptKeyBeforeQueueing aufruft. Diese Methode ist Teil eines kritischen Pfads, der dafür verantwortlich ist, das Gerät zu aktivieren, wenn bestimmte Tasten gedrückt werden. Der EventHub hält effektiv eine Wake-Lock entlang dieses kritischen Pfads, um sicherzustellen, dass er vollständig ausgeführt wird.

5. Wenn eine InputFilter gerade verwendet wird, kann die InputDispatcher den Schlüssel nutzen oder transformieren. Mit der InputFilter können systemweite Richtlinien zur Barrierefreiheit auf niedriger Ebene implementiert werden.

6. Der InputDispatcher stellt den Schlüssel zur Verarbeitung in den Dispatch-Thread.

7. Wenn InputDispatcher den Schlüssel aus der Warteschlange entfernt, erhält WindowManagerPolicy eine zweite Chance, das Schlüsselereignis durch Aufrufen von WindowManagerPolicy.interceptKeyBeforeDispatching abzufangen. Mit dieser Methode werden Systemkürzel und andere Funktionen verarbeitet.

8. Die InputDispatcher identifiziert dann das Ziel des Schlüsselereignisses (das Fenster, das gerade aktiv ist) und wartet, bis es bereit ist. Anschließend sendet der InputDispatcher das Schlüsselereignis an die Anwendung.

9. Innerhalb der Anwendung wird das Tastenereignis durch die Ansichtshierarchie zur fokussierten Ansicht für die Vorab-IME-Eingabe weitergeleitet.

10. Wenn das Schlüsselereignis nicht vor dem IME-Dispatch verarbeitet wird und eine IME verwendet wird, wird das Schlüsselereignis an die IME gesendet.

11. Wenn das Tastenereignis nicht von der IME verarbeitet wurde, wird es für die Standardtasteneingabe durch die Ansichtshierarchie an die Ansicht mit dem Fokus weitergeleitet.

12. Die Anwendung meldet an die InputDispatcher, ob das Schlüsselereignis erfasst wurde. Wenn das Ereignis nicht verwendet wurde, ruft InputDispatcher WindowManagerPolicy.dispatchUnhandledKey auf, um das „Fallback“-Verhalten anzuwenden. Je nach Fallback-Aktion wird der Auslösezyklus für das Schlüsselereignis möglicherweise mit einem anderen Schlüsselcode neu gestartet. Wenn eine Anwendung beispielsweise KEYCODE_ESCAPE nicht verarbeitet, kann das System das Schlüsselereignis stattdessen als KEYCODE_BACK weiterleiten.

Tastaturkonfiguration

Das Tastaturverhalten wird durch das Tastenlayout, die Tastenbelegung und die Eingabegerätekonfiguration bestimmt.

Weitere Informationen zu den Dateien, die an der Tastaturkonfiguration beteiligt sind, finden Sie in den folgenden Abschnitten:

• Schlüssellayoutdateien
• Wichtige Character Map-Dateien
• Konfigurationsdateien für Eingabegeräte

Properties

Die folgenden Konfigurationseigenschaften für Eingabegeräte werden für Tastaturen verwendet.

keyboard.layout

Definition:keyboard.layout = <name>

Gibt den Namen der Tastenlayoutdatei an, die mit dem Eingabegerät verknüpft ist, ohne die Erweiterung .kl. Wenn diese Datei nicht gefunden wird, verwendet das Eingabesystem stattdessen das Standardtastaturlayout.

Leerzeichen im Namen werden bei der Suche in Unterstriche umgewandelt.

Weitere Informationen finden Sie in der Dokumentation zur Schlüssellayoutdatei.

keyboard.characterMap

Definition:keyboard.characterMap = <name>

Gibt den Namen der Datei mit der Tastenbelegung an, die mit dem Eingabegerät verknüpft ist, ohne die Dateiendung .kcm. Wenn diese Datei nicht gefunden wird, verwendet das Eingabesystem stattdessen die Standard-Tastenbelegung.

Leerzeichen im Namen werden bei der Suche in Unterstriche umgewandelt.

Weitere Informationen finden Sie in der Dokumentation der Datei mit der Schlüsselzeichenkarte.

keyboard.orientationAware

Definition:keyboard.orientationAware = 0 | 1

Gibt an, ob die Tastatur auf Änderungen der Displayausrichtung reagieren soll.

• Wenn der Wert 1 ist, werden die Richtungstasten der Ziffernleiste gedreht, wenn sich die zugehörige Bildschirmausrichtung ändert.

• Wenn der Wert 0 ist, ist die Tastatur unabhängig von der Displayausrichtung.

Der Standardwert ist 0.

Die Ausrichtung wird verwendet, um die Drehung der Richtungstasten auf der Tastatur zu unterstützen, z. B. auf dem Motorola Droid. Wenn das Gerät beispielsweise um 90 Grad im Uhrzeigersinn von seiner natürlichen Ausrichtung gedreht wird, wird KEYCODE_DPAD_UP in KEYCODE_DPAD_RIGHT umgewandelt, da die Auf-Taste in dieser Ausrichtung nach rechts zeigt.

keyboard.builtIn

Definition:keyboard.builtIn = 0 | 1

Gibt an, ob es sich bei der Tastatur um die integrierte (physisch angeschlossene) Tastatur handelt.

Der Standardwert ist 1, wenn der Gerätename auf -keypad endet, andernfalls 0.

Der integrierten Tastatur wird immer die Geräte-ID 0 zugewiesen. Anderen Tastaturen, die nicht integriert sind, werden eindeutige Geräte-IDs zugewiesen, die nicht null sind.

Die Verwendung der ID 0 für die integrierte Tastatur ist wichtig, um die Kompatibilität mit dem Feld KeyCharacterMap.BUILT_IN_KEYBOARD aufrechtzuerhalten. Dieses Feld gibt die ID der integrierten Tastatur an und hat den Wert 0. Dieses Feld wurde in der API eingestellt, wird aber möglicherweise noch in älteren Anwendungen verwendet.

Eine Tastatur mit Sonderfunktionen (deren Tastenbelegung einen Typ von SPECIAL_FUNCTION angibt) wird unabhängig von der Einstellung dieser Eigenschaft niemals als die integrierte Tastatur registriert. Das liegt daran, dass eine Tastatur mit Sonderfunktionen per Definition nicht für die allgemeine Eingabe gedacht ist.

Beispielkonfigurationen

# 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

Kompatibilitätshinweise

Vor Honeycomb wurden vom Tastatur-Eingabe-Mapper keine Konfigurationseigenschaften verwendet. Es wurde davon ausgegangen, dass alle Tastaturen physisch angeschlossen und orientiert sind. Das Standardtastaturlayout und die Standardzeichentabelle wurden qwerty statt Generic genannt. Das Format der Tastenbelegung war ebenfalls sehr unterschiedlich und das Framework unterstützte keine PC-Tastaturen oder externen Tastaturen.

Wenn Sie Geräte auf Honeycomb umstellen, müssen Sie die erforderlichen Konfigurations- und Schlüsselkartendateien erstellen oder aktualisieren.

HID-Verwendungen, Linux-Tastencodes und Android-Tastencodes

Das System verweist je nach Abstraktionsebene auf Schlüssel mit mehreren verschiedenen IDs.

Bei HID-Geräten ist jedem Schlüssel eine HID-Nutzung zugeordnet. Der Linux-hid-input-Treiber und die zugehörigen HID-Treiber von Anbietern und Geräten sind für das Parsen von HID-Berichten und das Zuordnen von HID-Nutzungen zu Linux-Tastencodes verantwortlich.

Wenn Android EV_KEY-Ereignisse aus dem Linux-Kernel liest, übersetzt es jeden Linux-Schlüsselcode gemäß der Schlüssellayoutdatei des Geräts in den entsprechenden Android-Schlüsselcode.

Wenn das Schlüsselereignis an eine Anwendung gesendet wird, meldet die android.view.KeyEvent-Instanz den Linux-Schlüsselcode als Wert von getScanCode() und den Android-Schlüsselcode als Wert von getKeyCode(). Für das Framework ist nur der Wert von getKeyCode() wichtig.

Die HID-Nutzungsinformationen werden nicht von Android selbst verwendet oder an Anwendungen übergeben.

Codetabellen

In den folgenden Tabellen sehen Sie, wie HID-Nutzungen, Linux-Tastencodes und Android-Tastencodes miteinander zusammenhängen.

In der Spalte „LKC“ wird der Linux-Schlüsselcode im Hexadezimalformat angegeben.

In der Spalte „AKC“ wird der Android-Schlüsselcode in Hexadezimal angegeben.

Die Spalte „Hinweise“ bezieht sich auf Hinweise, die nach der Tabelle gepostet werden.

In der Spalte „Version“ wird die erste Version der Android-Plattform angegeben, in deren Standardschlüsselzuordnung dieser Schlüssel enthalten ist. Mehrere Zeilen werden angezeigt, wenn sich die Standardtastaturbelegung zwischen den Versionen geändert hat. Die älteste angegebene Version ist 1.6.

• In Gingerbread (2.3) und früheren Releases war die Standard-Tastenbelegung qwerty.kl. Diese Tastenbelegung war nur für die Verwendung mit dem Android-Emulator gedacht und nicht für die Unterstützung beliebiger externer Tastaturen. Einige OEMs haben der Plattform jedoch Bluetooth-Tastaturunterstützung hinzugefügt und sich auf qwerty.kl verlassen, um die erforderlichen Tastaturzuordnungen bereitzustellen. Daher sind diese älteren Zuordnungen möglicherweise für OEMs interessant, die Peripheriegeräte für diese Geräte entwickeln. Die Zuordnungen unterscheiden sich erheblich von den aktuellen, insbesondere im Hinblick auf die Behandlung des Schlüssels HOME. Es wird empfohlen, alle neuen Peripheriegeräte gemäß der Honeycomb- oder einer neueren Tastenbelegung (z. B. Standard-HID) zu entwickeln.

• Ab Honeycomb (3.0) ist Generic.kl die Standard-Tastenbelegung. Diese Tastenbelegung wurde für Tastaturen im PC-Format entwickelt. Die meisten Funktionen standardmäßiger HID-Tastaturen sollten sofort einsatzbereit sein.

Die Zuordnung der Tastencodes kann je nach Version des Linux-Kernels und von Android variieren. Wenn bekannt ist, dass Änderungen an den Standardschlüsselzuordnungen von Android vorgenommen wurden, werden diese in der Versionsspalte angezeigt.

Gerätespezifische HID-Treiber und Tastenzuordnungen können andere Zuordnungen als hier angegeben anwenden.

HID-Tastatur- und Wähltastaturseite (0x07)

Allgemeine HID-Desktopseite (0x01)

HID-Nutzerseite (0x0c)

Zusätzliche nicht HID-Zuordnungen

Diese Zuordnungen beschreiben Funktionen, die nicht in HID angezeigt werden, für die aber Linux-Tastencodes vorhanden sind.

Nicht unterstützte alte Schlüssel

Diese Zuordnungen waren in früheren Android-Versionen vorhanden, aber nicht mit HID konform oder verwendeten nicht standardmäßige Linux-Tastencodes. Sie werden nicht mehr unterstützt.

Hinweise

1. Der Android-Tastencode, der mit gängigen alphanumerischen und symbolischen Tasten verknüpft ist, kann je nach Tastaturlayout und Sprache variieren. Aus historischen Gründen werden die physischen Scancodes und HID-Nutzungen, die mit den Tasten auf einer Tastatur verknüpft sind, häufig anhand ihrer Position definiert, auch wenn die auf diesen Tasten gedruckten Labels von Sprache zu Sprache variieren können.

   Auf einer US-englischen (QWERTY) Tastatur ist die linke obere Buchstabentaste mit „Q“ gekennzeichnet. Auf einer französischen (AZERTY) Tastatur ist die Taste an derselben Position mit A gekennzeichnet. Trotz des Labels wird auf beiden Tastaturen auf den alphabetischen Tasten oben links mit der HID-Nutzung 0x07 0x0014 verwiesen, die dem Linux-Tastencode KEY_Q zugeordnet ist.

   Wenn Android mit einem US-amerikanischen Tastaturlayout konfiguriert ist, wird der Linux-Tastencode KEY_Q dem Android-Tastencode KEYCODE_Q zugeordnet und die Zeichen „Q“ und „q“ werden ausgegeben. Wenn Android jedoch mit einem französischen Tastaturlayout konfiguriert ist, wird der Linux-Tastencode KEY_Q dem Android-Tastencode KEYCODE_A zugeordnet und die Zeichen „A“ und „a“ werden ausgegeben.

   Der Android-Schlüsselcode entspricht in der Regel der sprachspezifischen Interpretation des Schlüssels. Daher kann für verschiedene Sprachen ein anderer Android-Schlüsselcode verwendet werden.

2. 0x0c 0x022f AC Zoom ist in der HID als lineares Steuerelement definiert, wird aber vom Kernel als Schlüssel zugeordnet, was wahrscheinlich falsch ist.

3. Die Linux-Funktionstasten KEY_FN_* sind einfacheren Tastencodes zugeordnet, werden aber mit dem META_FUNCTION-Metastatus-Bit auf „wahr“ gesendet.

4. Vor Android Ice Cream Sandwich 4.0 enthielt das Standardtastaturlayout Zuordnungen für einige zusätzliche Tastencodes, die nicht in den Haupt-Linux-Kernel-Headern definiert waren. Diese Zuordnungen wurden inzwischen entfernt, da diesen zuvor nicht definierten Tastencodes in neueren Versionen des Linux-Kernels unterschiedliche Bedeutungen zugewiesen wurden.

Quellen

1. USB HID-Nutzungstabellen Version 1.12
2. Linux-Kernel 2.6.39: include/linux/input.h, drivers/hid/hid-input.c
3. Android ICS: qwerty.kl, Generic.kl, KeyEvent.java