Clavier

Android est compatible avec divers claviers, y compris des fonctions spéciales claviers (contrôles du volume et de l'alimentation), claviers QWERTY intégrés compacts, et des claviers externes de type PC dotés de fonctionnalités complètes.

Ce document ne concerne que les claviers physiques. Reportez-vous au SDK Android pour en savoir plus sur les claviers virtuels (éditeurs du mode de saisie).

Classification du clavier

Un périphérique d'entrée est considéré comme un clavier si l'un des conditions contiennent:

• Le périphérique d'entrée signale la présence de codes de touche Linux sur les claviers. y compris 0 à 0xff ou KEY_OK à KEY_MAX.

• Le périphérique d'entrée signale la présence de codes de touche Linux sur les joysticks. et manettes de jeu, y compris BTN_0 à BTN_9, BTN_TRIGGER à BTN_DEAD, ou BTN_A à BTN_THUMBR.

Les joysticks sont actuellement classés comme claviers, car les boutons du joystick et de la manette de jeu sont signalées par les événements EV_KEY de la même manière que les touches du clavier. Ainsi, les joysticks et les manettes de jeu utilisent également des fichiers de mappage de touches pour la configuration.

Une fois qu'un périphérique d'entrée a été classé comme clavier, le système charge le fichier de configuration du périphérique d'entrée et la disposition du clavier.

Le système tente ensuite de déterminer des caractéristiques supplémentaires de l'appareil.

• Si le périphérique d'entrée possède des clés mappées avec KEYCODE_Q, le est considéré comme ayant un clavier alphabétique (par opposition au clavier numérique). La fonctionnalité du clavier alphabétique est indiquée dans la ressource Configuration. en tant que KEYBOARD_QWERTY.

• Si le périphérique d'entrée possède des clés mappées avec KEYCODE_DPAD_UP, KEYCODE_DPAD_DOWN, KEYCODE_DPAD_LEFT, KEYCODE_DPAD_RIGHT et KEYCODE_DPAD_CENTER (tous doivent être présents), l'appareil est considéré comme d'avoir un clavier directionnel. La fonctionnalité du clavier directionnel est indiquée dans la ressource Configuration. en tant que NAVIGATION_DPAD.

• Si le périphérique d'entrée est associé à des clés mappées avec KEYCODE_BUTTON_A ou d'autres touches liées à une manette de jeu, l'appareil est considéré comme étant équipé d'une manette.

Configuration requise pour les pilotes de clavier

1. Les pilotes de clavier ne doivent enregistrer que les codes des touches qu'ils réellement compatibles. L'enregistrement d'un excès de codes de touche peut perturber l'appareil. l'algorithme de classification ou que le système détecte les fonctionnalités de clavier compatibles de l'appareil.

2. Les pilotes de clavier doivent utiliser EV_KEY pour signaler les pressions sur les touches, à l'aide d'une valeur de 0 pour indiquer qu'une clé est libérée, une valeur de 1 pour indiquer qu'elle vous appuyez sur une touche et une valeur supérieure ou égale à 2 la clé est répétée automatiquement.

3. Android effectue sa propre répétition de clavier. Fonctionnalité de répétition automatique doit être désactivé dans le pilote.

4. Les pilotes de clavier peuvent éventuellement indiquer l'utilisation HID ou la recherche de bas niveau en envoyant EV_MSC avec MSC_SCANCODE et une valeur indiquant l'utilisation ou scanner le code quand on appuie sur la touche. Ces informations ne sont actuellement pas utilisés par Android.

5. Les pilotes de clavier doivent prendre en charge la définition des états des voyants lorsque EV_LED est écrit à l'appareil. Le pilote hid-input gère cela automatiquement. Au moment de la rédaction de ce document, Android utilise LED_CAPSLOCK, LED_SCROLLLOCK, et LED_NUMLOCK. Ces voyants ne doivent être compatibles que lorsque le clavier possède les voyants associés qui y sont associés.

6. Pilotes pour claviers intégrés (par exemple, à l'aide d'une matrice GPIO) veillez à envoyer les événements EV_KEY avec la valeur 0 pour toutes les clés qui restent enfoncés lorsque l'appareil se met en veille. Sinon, les touches risquent restent bloqués et se répètent indéfiniment.

Utilisation du clavier

Voici un bref résumé des opérations du clavier sur Android.

1. EventHub lit les événements bruts du pilote evdev et mappe les codes clés Linux. (parfois appelée "scan codes") en codes clés Android à l'aide de la carte de disposition des touches du clavier.

2. InputReader utilise les événements bruts et met à jour l'état de la méta-clé. Par exemple, si vous appuyez sur la touche Maj de gauche ou la relâchez, le lecteur définissez ou réinitialisez les bits META_SHIFT_LEFT_ON et META_SHIFT_ON en conséquence.

3. InputReader informe InputDispatcher de l'événement clé.

4. InputDispatcher demande à WindowManagerPolicy ce qu'il doit faire de la clé en appelant WindowManagerPolicy.interceptKeyBeforeQueueing. Cette méthode fait partie d'un chemin critique qui est responsable de l'activation de l'appareil lorsque sur certaines touches. Le EventHub maintient efficacement un wakelock tout au long de ce chemin critique pour garantir son exécution complète.

5. Si un InputFilter est actuellement utilisé, InputDispatcher lui attribue une de consommer ou de transformer la clé. Le InputFilter peut être utilisé pour implémenter des règles d'accessibilité de bas niveau à l'échelle du système.

6. InputDispatcher met la clé en file d'attente en vue de son traitement sur le thread de distribution.

7. Lorsque InputDispatcher retire la clé de la file d'attente, il attribue WindowManagerPolicy une seconde chance d'intercepter l'événement clé en appelant WindowManagerPolicy.interceptKeyBeforeDispatching Cette méthode gère les processus des raccourcis et d'autres fonctions.

8. InputDispatcher identifie ensuite la cible de l'événement clé (la fenêtre sélectionnée). et attend qu'ils soient prêts. Ensuite, le InputDispatcher envoie les à l'application.

9. Dans l'application, l'événement clé se propage dans la hiérarchie des vues la vue sélectionnée pour la distribution des clés avant IME.

10. Si l'événement clé n'est pas géré dans l'envoi avant l'IME et qu'un IME est utilisé, le l'événement clé est transmis à l'IME.

11. Si l'événement clé n'a pas été utilisé par l'IME, il se propage. dans la hiérarchie des vues jusqu'à la vue sélectionnée pour la distribution des clés standard.

12. L'application indique à InputDispatcher si la clé a été consommé. Si l'événement n'a pas été utilisé, InputDispatcher appelle WindowManagerPolicy.dispatchUnhandledKey pour appliquer la "création de remplacement" comportemental. En fonction de l'action de remplacement, le cycle de distribution des événements clés peut être redémarré. à l'aide d'un code de touche différent. Par exemple, si une application ne gère pas KEYCODE_ESCAPE, le système peut réenvoyer l'événement clé en tant que KEYCODE_BACK à la place.

Configuration du clavier

Le comportement du clavier est déterminé par la disposition des touches et le caractère des touches de mappage et de configuration des périphériques d'entrée.

Reportez-vous aux sections suivantes pour en savoir plus sur les fichiers participer à la configuration du clavier:

• Fichiers de mise en page des clés
• Fichiers de mappage de caractères clés
• Importer les fichiers de configuration du périphérique

Propriétés

Les propriétés de configuration de périphérique d'entrée suivantes sont utilisées pour les claviers.

clavier.layout

Définition:keyboard.layout = <nom>

Spécifie le nom du fichier de disposition des touches associé au périphérique d'entrée. en excluant l'extension .kl. Si ce fichier est introuvable, le système utilisera la disposition des touches par défaut à la place.

Les espaces dans le nom sont convertis en traits de soulignement lors de la recherche.

Pour en savoir plus, consultez la documentation sur les fichiers de mise en page de clé.

clavier.characterMap

Définition:keyboard.characterMap = <nom>

Spécifie le nom du fichier de mappage de caractères clés associé au périphérique d'entrée. en excluant l'extension .kcm. Si ce fichier est introuvable, le système utilisera le mappage de caractères clés par défaut à la place.

Les espaces dans le nom sont convertis en traits de soulignement lors de la recherche.

Pour en savoir plus, consultez la documentation sur le fichier de mappage de caractères de clé.

clavier.orientationAware

Définition:keyboard.orientationAware = 0 | 1

Indique si le clavier doit réagir aux changements d'orientation de l'écran.

• Si la valeur est 1, les touches du clavier directionnel sont alternées lorsque la les changements d'orientation associés.

• Si la valeur est 0, le clavier ne résiste pas aux changements d'orientation de l'écran.

La valeur par défaut est 0.

La détection de l'orientation est utilisée pour permettre la rotation des touches du clavier directionnel, comme sur le Motorola Droid. Par exemple, en faisant pivoter l'appareil dans le sens des aiguilles d'une montre à 90 degrés de son orientation naturelle, KEYCODE_DPAD_UP est remappées pour produire KEYCODE_DPAD_RIGHT depuis le "haut" pointe vers le haut 'droite' lorsque l'appareil est tenu dans cette orientation.

clavier intégré

Définition:keyboard.builtIn = 0 | 1

Indique si le clavier est intégré (branché physiquement) clavier.

La valeur par défaut est 1 si le nom de l'appareil se termine par -keypad. Sinon, la valeur est 0.

Le clavier intégré se voit toujours attribuer l'ID d'appareil 0. Autres claviers qui ne sont pas intégrés se voient attribuer des ID d'appareil uniques non nuls.

Il est important d'utiliser l'ID 0 pour le clavier intégré afin de maintenir la compatibilité avec le champ KeyCharacterMap.BUILT_IN_KEYBOARD, qui spécifie L'ID du clavier intégré et sa valeur est 0. Ce champ a été obsolète dans l'API, mais il est possible que des applications plus anciennes l'utilisent encore.

Un clavier à fonction spéciale (dont le mappage de touches spécifie type de SPECIAL_FUNCTION) ne sera jamais enregistré comme clavier intégré, quel que soit le paramètre de cette propriété. C'est parce qu'une fonction spéciale par définition, le clavier n'est pas destiné à un usage général.

Exemples de configurations

# 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

Remarques sur la compatibilité

Avant Honeycomb, le mappeur des entrées au clavier n'utilisait aucune propriété de configuration. Tous les claviers étaient censés être fixés physiquement et adaptés à l'orientation. La valeur par défaut La disposition de la clé et le mappage des caractères clés ont été nommés qwerty au lieu de Generic. La clé le format de carte de caractères était également très différent et le framework ne prenait pas en charge Claviers complets de type PC ou claviers externes.

Lorsque vous mettez à niveau des appareils vers Honeycomb, assurez-vous de créer ou de mettre à jour les de configuration et de mappage des clés.

Utilisations HID, codes de clé Linux et codes de touche Android

Le système fait référence à des clés qui utilisent différents identifiants, en fonction du couche d'abstraction.

Pour les appareils HID, chaque clé a une utilisation HID associée. hid-input Linux le pilote, le fournisseur associé et les pilotes HID spécifiques à l’appareil sont responsables pour analyser les rapports HID et mapper les utilisations HID aux codes de clé Linux.

Lorsqu'Android lit les événements EV_KEY à partir du noyau Linux, il traduit chaque le code de touche Linux dans le code de touche Android correspondant, conformément au de mise en page des touches de l'appareil.

Lorsque l'événement clé est envoyé à une application, le android.view.KeyEvent indique que le code de clé Linux est la valeur de getScanCode() et que l'instance Code de clé Android en tant que valeur de getKeyCode(). Aux fins du , seule la valeur de getKeyCode() est importante.

Notez que les informations sur l'utilisation de HID ne sont pas utilisées par Android lui-même. transmises aux applications.

Tables de code

Les tableaux suivants montrent comment les utilisations HID, les codes de clé Linux et Android codes clés sont liés les uns aux autres.

La colonne LKC indique le code clé Linux en hexadécimal.

La colonne AKC spécifie le code de la clé Android au format hexadécimal.

La colonne Notes fait référence aux notes publiées après le tableau.

La colonne "Version" indique la première version de la plate-forme Android. d'avoir inclus cette clé dans son mappage de clés par défaut. Plusieurs lignes sont s'affiche dans les cas où le mappage de clés par défaut change d'une version à l'autre. La version la plus ancienne indiquée est 1.6.

• Dans Gingerbread (2.3) et les versions antérieures, le mappage de touches par défaut était qwerty.kl Ce mappage de touches n'était destiné qu'aux applications de l'émulateur et n'était pas destiné à prendre en charge claviers externes. Néanmoins, quelques OEM ont ajouté le Bluetooth clavier compatible avec la plate-forme et s'est appuyé sur qwerty.kl pour fournissent les mappages de clavier nécessaires. Par conséquent, ces les anciennes cartes peuvent intéresser les OEM qui développent périphériques pour ces appareils particuliers. Notez que les mappages sont très différentes de celles actuelles, par rapport au traitement de la clé HOME. Il est recommandé que tous les nouveaux périphériques soient développés conformément à la norme Honeycomb Mappages de touches récents (par exemple, HID standard)

• Depuis Honeycomb (3.0), le mappage de touches par défaut est Generic.kl. Ce mappage de touches a été conçu pour être compatible avec les claviers PC complets. La plupart des fonctionnalités des claviers HID standards devraient s'adapter de la boîte.

Le mappage du code de clé peut varier selon les versions du noyau Linux et d'Android. Lorsque des modifications ont été apportées aux mappages de touches par défaut Android, ils sont indiqués dans la colonne "Version".

Les pilotes HID et les mappages de touches spécifiques à l'appareil peuvent appliquer des mappages différents. que celles indiquées ici.

Page du clavier et du clavier HID (0x07)

Page générique pour ordinateur de bureau (0x01)

Page HID grand public (0x0c)

Mappages non HID supplémentaires

Ces mappages décrivent des fonctions qui n'apparaissent pas dans HID, mais pour lesquelles Linux codes de clé existent.

Anciennes clés non compatibles

Ces mappages apparaissaient dans les versions précédentes d'Android, mais ne correspondaient pas à HID ou codes de touches Linux non standards. Ils ne sont plus acceptés.

Notes

1. Code clé Android associé aux caractères alphanumériques et symboliques courants peuvent varier en fonction de la disposition et de la langue du clavier. Pour des raisons d'historique, les codes de scan physique et les utilisations de HID associées aux touches d'un clavier sont souvent définies même si les étiquettes imprimées sur ces clés langue vers une autre.

   Sur un clavier QWERTY, la touche alphabétique située en haut à gauche est intitulée Q. Sur un clavier français (AZERTY), la touche de la même est l'étiquette A. Malgré le libellé, les touches en haut à gauche est appelée à l'aide de l'utilisation HID 0x07 0x0014 qui est mappée avec le code de clé Linux KEY_Q.

   Lorsqu'Android est configuré avec un clavier en anglais américain, le code de clé Linux KEY_Q sera mappé au code de la clé Android KEYCODE_Q et générera les caractères « Q » et "q". Cependant, lorsqu'Android est configuré avec un clavier français, le code de clé Linux KEY_Q sera mappé au code de la clé Android KEYCODE_A et générera les caractères « A » et "a".

   Le code de la clé Android reflète généralement la l'interprétation de la clé. Un code de clé Android différent peut donc pour différentes langues.

2. 0x0c 0x022f AC Zoom est défini dans le HID comme une commande linéaire, mais le noyau la mappe en tant que clé, ce qui est probablement incorrect.

3. Les touches de fonction Linux KEY_FN_* sont mappées sur des touches les codes de touche, mais sont envoyés avec l'état méta META_FUNCTION. est défini sur "true".

4. Avant Android Ice Cream Sandwich 4.0, la disposition des touches par défaut contenaient des mappages pour des codes de clé supplémentaires non définis dans les en-têtes principaux du noyau Linux. Ces mappages ont depuis ont été supprimées, car ces codes de clavier non définis n'étaient pas définis plusieurs significations ont depuis été attribuées dans les versions plus récentes du noyau Linux.

Sources

1. Tables d'utilisation USB HID v1.12
2. Noyau Linux 2.6.39: include/linux/input.h, pilotes/hid/hid-input.c
3. Android ICS: qwerty.kl, Generic.kl, KeyEvent.java