התקני מקלדת

אנדרואיד תומכת במגוון התקני מקלדת, כולל מקלדות פונקציות מיוחדות (בקרות עוצמת הקול וההפעלה), מקלדות QWERTY משובצות קומפקטיות ומקלדות חיצוניות בסגנון מחשב אישי.

מסמך זה מתאר מקלדות פיזיות בלבד. עיין ב-SDK של Android למידע על מקלדות רכות (עורכי שיטת קלט).

סיווג מקלדת

התקן קלט מסווג כמקלדת אם מתקיים אחד מהתנאים הבאים:

• התקן הקלט מדווח על נוכחות של כל קודי מפתח לינוקס המשמשים במקלדות כולל 0 עד 0xff או KEY_OK עד KEY_MAX .

• התקן הקלט מדווח על נוכחות של כל קודי מפתח לינוקס המשמשים בג'ויסטיקים ובמשטחי משחק, כולל 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 או למקשים אחרים הקשורים ל-gamepad, אזי ההתקן נחשב כבעל gamepad.

דרישות מנהל המקלדת

1. מנהלי התקנים למקלדת צריכים לרשום רק קודי מפתח עבור המקשים שהם באמת תומכים בהם. רישום קודי מפתח עודף עלול לבלבל את אלגוריתם סיווג המכשיר או לגרום למערכת לזהות באופן שגוי את יכולות המקלדת הנתמכות של המכשיר.

2. מנהלי מקלדת צריכים להשתמש EV_KEY כדי לדווח על לחיצות מקשים, תוך שימוש בערך של 0 כדי לציין שמקש משוחרר, ערך של 1 כדי לציין שלוחצים על מקש, וערך גדול או שווה ל 2 כדי לציין שהמקש הוא חוזר על עצמו אוטומטית.

3. אנדרואיד מבצעת מקלדת חוזרת משלה. יש להשבית את פונקציונליות החזרה האוטומטית במנהל ההתקן.

4. מנהלי התקנים למקלדת עשויים לציין באופן אופציונלי את השימוש ב-HID או את קוד הסריקה ברמה נמוכה על ידי שליחת EV_MSC עם MSC_SCANCODE וערך המציין את קוד השימוש או הסריקה בעת לחיצה על המקש. מידע זה אינו בשימוש כעת על ידי אנדרואיד.

5. מנהלי התקנים למקלדת צריכים לתמוך בהגדרת מצבי LED כאשר EV_LED נכתב למכשיר. מנהל hid-input מטפל בזה באופן אוטומטי. בזמן כתיבת שורות אלה, אנדרואיד משתמש LED_CAPSLOCK , LED_SCROLLLOCK ו- LED_NUMLOCK . יש לתמוך בנורות LED אלה רק כאשר למקלדת יש למעשה את נוריות החיווי המשויכות.

6. מנהלי התקנים של מקלדת עבור מקלדות משובצות (לדוגמה, באמצעות מטריצת GPIO) צריכים לוודא לשלוח אירועי EV_KEY עם ערך של 0 עבור כל המקשים שעדיין לחוץ כשהמכשיר הולך לישון. אחרת המקשים עלולים להיתקע ויחזרו אוטומטית לנצח.

תפעול מקלדת

להלן סיכום קצר של פעולת המקלדת באנדרואיד.

1. ה- EventHub קורא אירועים גולמיים ממנהל ההתקן של evdev וממפה קודי מפתחות של לינוקס (המכונה לפעמים קודי סריקה) לקודי מפתחות של אנדרואיד באמצעות מפת פריסת המקשים של המקלדת.

2. InputReader צורך את האירועים הגולמיים ומעדכן את מצב המטא מפתח. לדוגמה, אם מקש Shift שמאלי נלחץ או משוחרר, הקורא יקבע או יאפס את הסיביות META_SHIFT_LEFT_ON ו- META_SHIFT_ON בהתאם.

3. InputReader מודיע ל- InputDispatcher על אירוע המפתח.

4. InputDispatcher שואל את WindowManagerPolicy מה לעשות עם אירוע המפתח על ידי קריאה ל- WindowManagerPolicy.interceptKeyBeforeQueueing . שיטה זו היא חלק מנתיב קריטי שאחראי להעיר את המכשיר בעת לחיצה על מקשים מסוימים. ה- EventHub מחזיק למעשה נעילת ערות לאורך הנתיב הקריטי הזה כדי להבטיח שהוא יפעל עד להשלמתו.

5. אם InputFilter נמצא כעת בשימוש, InputDispatcher נותן לו הזדמנות לצרוך או לשנות את המפתח. ניתן להשתמש ב- InputFilter כדי ליישם מדיניות נגישות ברמה נמוכה כלל מערכת.

6. InputDispatcher מציב את המפתח לעיבוד בשרשור השיגור.

7. כאשר InputDispatcher מוציא את המפתח בתור, הוא נותן ל- WindowManagerPolicy הזדמנות שנייה ליירט את אירוע המפתח על ידי קריאה ל- WindowManagerPolicy.interceptKeyBeforeDispatching . שיטה זו מטפלת בקיצורי מערכת ופונקציות אחרות.

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

הגדרה: keyboard.characterMap = <שם>

מציין את השם של קובץ מפת תו המפתח המשויך להתקן הקלט, למעט הסיומת .kcm . אם קובץ זה לא נמצא, מערכת הקלט תשתמש במפת תווי המפתח המוגדרת כברירת מחדל במקום זאת.

רווחים בשם מומרים לקווים תחתונים במהלך חיפוש.

עיין בתיעוד קובץ מפת תו המפתח לפרטים נוספים.

keyboard.orientationAware

הגדרה: keyboard.orientationAware = 0 | 1

מציין אם המקלדת צריכה להגיב לשינויים בכיוון התצוגה.

• אם הערך הוא 1 , מקשי לוח המקשים הכיוון מסובבים כאשר כיוון התצוגה המשויך משתנה.

• אם הערך הוא 0 , המקלדת חסינה מפני שינויי כיוון.

ערך ברירת המחדל הוא 0 .

מודעות להתמצאות משמשת לתמיכה בסיבוב של מקשי לוח מקשים כיוון, כגון ב-Motorola Droid. לדוגמה, כאשר המכשיר מסובב עם כיוון השעון 90 מעלות מהכיוון הטבעי שלו, KEYCODE_DPAD_UP מותאם מחדש כדי להפיק KEYCODE_DPAD_RIGHT מכיוון שמקש 'למעלה' בסופו של דבר מצביע 'ימינה' כאשר המכשיר מוחזק בכיוון זה.

keyboard.builtIn

הגדרה: keyboard.builtIn = 0 | 1

מציין אם המקלדת היא המקלדת המובנית (מחוברת פיזית).

ערך ברירת המחדל הוא 1 אם שם המכשיר מסתיים ב- -keypad , 0 אחרת.

למקלדת המובנית מוקצה תמיד מזהה התקן של 0 . למקלדות אחרות שאינן מובנות מוקצים מזהי מכשיר ייחודיים שאינם אפס.

שימוש במזהה 0 עבור המקלדת המובנית חשוב לשמירה על תאימות לשדה KeyCharacterMap.BUILT_IN_KEYBOARD , המציין את המזהה של המקלדת המובנית וערך 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, קודי מפתחות לינוקס וקודי מפתחות אנדרואיד

המערכת מתייחסת למפתחות באמצעות מספר מזהים שונים, בהתאם לשכבת ההפשטה.

עבור מכשירי HID, לכל מפתח יש שימוש ב-HID משויך. מנהל ההתקן hid-input של Linux ומנהלי התקן HID ספציפיים לספקים ולמכשירים קשורים אחראים לניתוח דוחות HID ומיפוי שימושים ב-HID לקודי מפתחות של לינוקס.

כאשר אנדרואיד קורא אירועים EV_KEY מקרנל לינוקס, הוא מתרגם כל קוד מפתח לינוקס לקוד מפתח אנדרואיד המתאים לו בהתאם לקובץ פריסת המפתח של המכשיר.

כאשר אירוע המפתח נשלח לאפליקציה, מופע android.view.KeyEvent מדווח על קוד מפתח לינוקס כערך getScanCode() וקוד מפתח Android כערך getKeyCode() . למטרות המסגרת, רק הערך של getKeyCode() חשוב.

שים לב שמידע השימוש ב-HID אינו בשימוש על ידי אנדרואיד עצמו או מועבר לאפליקציות.

טבלאות קוד

הטבלאות הבאות מראות כיצד שימושי HID, קודי מפתחות לינוקס וקודי מפתחות אנדרואיד קשורים זה לזה.

העמודה LKC מציינת את קוד מפתח לינוקס בהקסדצימלי.

העמודה AKC מציינת את קוד מפתח אנדרואיד בהקסדצימלי.

העמודה הערות מתייחסת להערות שמתפרסמות אחרי הטבלה.

העמודה Version מציינת את הגרסה הראשונה של פלטפורמת אנדרואיד שכללה מפתח זה במפת המפתחות המוגדרת כברירת מחדל. שורות מרובות מוצגות במקרים שבהם מפת מפתח ברירת המחדל השתנתה בין גרסאות. הגרסה הישנה ביותר שצוינה היא 1.6.

• ב-Gingerbread (2.3) ובגרסאות קודמות, מפת המפתחות המוגדרת כברירת מחדל הייתה qwerty.kl . מפת מפתח זו נועדה רק לשימוש עם אמולטור אנדרואיד ולא נועדה לשמש לתמיכה במקלדות חיצוניות שרירותיות. עם זאת, כמה יצרני OEM הוסיפו תמיכה במקלדת Bluetooth לפלטפורמה והסתמכו על qwerty.kl כדי לספק את מיפוי המקלדת הנדרש. כתוצאה מכך, מיפויים ישנים אלה עשויים לעניין יצרני OEM אשר בונים ציוד היקפי עבור המכשירים המסוימים הללו. שימו לב שהמיפויים שונים מהותית מהמיפויים הנוכחיים, במיוחד ביחס לטיפול במקש HOME . מומלץ לפתח את כל הציוד ההיקפי החדש לפי ה-Honeycomb או מפות מפתח עדכניות יותר (כלומר, HID סטנדרטי).

• החל מ-Honeycomb (3.0), מפת מפתח ברירת המחדל היא Generic.kl . מפת מפתח זו תוכננה כדי לתמוך במקלדות מלאות בסגנון PC. רוב הפונקציונליות של מקלדות HID סטנדרטיות אמורה לעבוד רק מהקופסה.

מיפוי קוד המפתח עשוי להשתנות בין גרסאות של ליבת לינוקס ואנדרואיד. כאשר ידוע ששינויים התרחשו במפות מפתח ברירת המחדל של אנדרואיד, הם מצוינים בעמודת הגרסה.

מנהלי התקנים ומפות מפתח מסוג HID ספציפיים למכשיר עשויים להחיל מיפויים שונים מהמצוין כאן.

דף מקלדת ומקלדת HID (0x07)

דף שולחן עבודה גנרי HID (0x01)

דף צרכנים HID (0x0c)

מיפויים נוספים שאינם מסתכמים

מיפויים אלה מתארים פונקציות שאינן מופיעות ב- HID אלא שעבורן קיימים קודי מפתח לינוקס.

מפתחות לא נתמכים מדור קודם

מיפויים אלה הופיעו בגרסאות קודמות של אנדרואיד אך לא היו עולות בקנה אחד עם קודי מפתח לינוקס לא סטנדרטיים. הם כבר לא נתמכים.

הערות

1. קוד מפתח אנדרואיד המשויך למפתחות אלפא -נומריים וסמלים נפוצים עשוי להשתנות על פי פריסת המקלדת והשפה. מסיבות היסטוריות, קודי הסריקה הפיזיים ושימושי HID הקשורים למפתחות במקלדת מוגדרים לרוב באופן מיקום למרות שהתוויות המודפסות על מקשים אלה עשויות להשתנות משפה אחת לשניה.

   במקלדת באנגלית (QWERTY) בארה"ב, מקש האלפביתי השמאלי העליון מתויג Q. על מקלדת צרפתית (אזרטי), המפתח באותה מיקום מסומן A. למרות התווית, בשני המקלדות המפתח השמאלי העליון. מכונה באמצעות השימוש ב- HID 0x07 0x0014 הממופה לקוד מקש Linux Key_Q.

   כאשר אנדרואיד מוגדר עם פריסת מקלדת באנגלית בארה"ב, אז קוד המקש Linux Key_Q ימפה לקוד מקש אנדרואיד KeyCode_Q וייצר את התווים 'Q' ו- 'Q'. עם זאת, כאשר אנדרואיד מוגדר עם פריסת מקלדת צרפתית, אז קוד המקש Linux Key_Q ימפה לקוד המפתח של אנדרואיד KeyCode_A וייצר את התווים 'A' ו- 'A'.

   קוד מפתח אנדרואיד משקף בדרך כלל את הפרשנות הספציפית לשפה של המפתח, כך שניתן להשתמש בקוד מפתח שונה של אנדרואיד לשפות שונות.

2. 0x0c 0x022f AC Zoom מוגדר ב- HID כבקרה ליניארית, אך הגרעין ממפה אותו כמפתח, וזה כנראה לא נכון.

3. מקשי הפונקציה Linux KEY_FN_* ממופים לקודי מקש פשוטים יותר אך נשלחים עם סיב המצב META_FUNCTION Meta.

4. לפני גלידת אנדרואיד סנדוויץ '4.0, פריסת מפתח ברירת המחדל הכילה מיפוי לכמה קודי מפתח נוספים שלא הוגדרו בכותרות גרעיני לינוקס הראשי. מיפויים אלה הוסרו מאז מכיוון שקודי המפתח שלא היו מוגדרים בעבר הוקצו מאז משמעויות שונות בגרסאות עדכניות יותר של גרעין לינוקס.

מקורות

1. שולחנות שימוש ב- USB HID V1.12
2. לינוקס 2.6.39 גרעין: כולל/לינוקס/קלט.
3. אנדרואיד IC