أجهزة لوحة المفاتيح

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يتوافق Android مع مجموعة متنوعة من أجهزة لوحات المفاتيح، بما في ذلك لوحات مفاتيح وظائف خاصة (عناصر التحكّم في مستوى الصوت والطاقة) ولوحات مفاتيح QWERTY المدمجة والمدمجة ولوحات المفاتيح الخارجية المزوّدة بميزات كاملة على غرار أجهزة الكمبيوتر الشخصي.

يصف هذا المستند لوحات المفاتيح الخارجية فقط. يُرجى الرجوع إلى حزمة تطوير البرامج (SDK) لنظام التشغيل Android للحصول على معلومات عن لوحات المفاتيح الافتراضية (محرّري طرق الإدخال).

تصنيف لوحة المفاتيح

يتم تصنيف جهاز إدخال على أنّه لوحة مفاتيح في حال استيفاء أيّ من الشروط التالية:

• يُبلغ جهاز الإدخال عن توفُّر أي رموز مفاتيح لنظام التشغيل 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. قد تشير برامج تشغيل لوحة المفاتيح اختياريًا إلى استخدام HID أو رمز المسح الضوئي من المستوى المنخفض عن طريق إرسال EV_MSC مع MSC_SCANCODE وقيمة تشير إلى الاستخدام أو رمز المسح الضوئي عند الضغط على المفتاح. لا يستخدم نظام التشغيل Android هذه المعلومات في الوقت الحالي.

5. يجب أن تتيح برامج تشغيل لوحة المفاتيح ضبط حالات مصابيح LED عند كتابة EV_LED على الجهاز. يعالج برنامج تشغيل hid-input هذا الأمر تلقائيًا. في وقت كتابة هذه المقالة، يستخدم Android LED_CAPSLOCK وLED_SCROLLLOCK وLED_NUMLOCK. يجب أن تكون مصابيح LED هذه متوافقة فقط عندما تحتوي لوحة المفاتيح على مصابيح المؤشر المرتبطة بها.

6. يجب أن تتأكّد برامج تشغيل لوحات المفاتيح للوحة المفاتيح المضمّنة (على سبيل المثال، باستخدام مصفوفة GPIO) من إرسال أحداث EV_KEY بقيمة 0 لأي مفاتيح لا تزال مضغوطة عندما ينتقل الجهاز إلى وضع السكون. بخلاف ذلك، قد تتعذّر إزالتها وستتم إعادة تشغيلها تلقائيًا إلى الأبد.

تشغيل لوحة المفاتيح

في ما يلي ملخّص موجز عن تشغيل لوحة المفاتيح على Android.

1. يقرأ EventHub الأحداث الأوّلية من برنامج تشغيل evdev ويربط رموز مفاتيح Linux (المعروفة أحيانًا باسم رموز المسح الضوئي) برموز مفاتيح Android باستخدام خريطة تخطيط مفاتيح لوحة المفاتيح.

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 قيد الاستخدام، يتم إرسال الحدث الرئيسي إلى واجهة معالجة الإدخال.

11. إذا لم يتم استخدام الحدث الرئيسي من قِبل واجهة معالجة الإدخال (IME)، يتم نشر الحدث الرئيسي في التسلسل الهرمي للعرض إلى العرض الذي تم التركيز عليه لإرسال المفاتيح العادية.

12. يُرسِل التطبيق تقارير إلى InputDispatcher بشأن ما إذا تم استخدام الحدث الرئيسي. إذا لم يتم استخدام الحدث، يُطلِق InputDispatcher WindowManagerPolicy.dispatchUnhandledKey لتطبيق السلوك "الاحتياطي". استنادًا إلى الإجراء الاحتياطي، قد تتم إعادة بدء دورة إرسال الحدث الرئيسي باستخدام رمز مفتاح مختلف. على سبيل المثال، إذا لم يعالج أحد التطبيقات KEYCODE_ESCAPE، قد يعيد النظام إرسال الحدث الرئيسي على أنّه KEYCODE_BACK بدلاً من ذلك.

إعدادات لوحة المفاتيح

يتم تحديد سلوك لوحة المفاتيح من خلال تخطيط مفاتيح لوحة المفاتيح وجدول تحويل الأحرف إلى مفاتيح وإعدادات جهاز الإدخال.

يمكنك الرجوع إلى الأقسام التالية للحصول على مزيد من التفاصيل حول الملفات التي تشارك في ضبط إعدادات لوحة المفاتيح:

• ملفات تنسيق المفاتيح
• ملفات خريطة الأحرف الرئيسية
• إدخال ملفات إعدادات الجهاز

الخصائص

تُستخدَم سمات ضبط جهاز الإدخال التالية للوحات المفاتيح.

keyboard.layout

التعريف: keyboard.layout = <name>

تُحدِّد اسم ملف تنسيق لوحة المفاتيح المرتبط بجهاز الإدخال، باستثناء امتداد .kl. في حال عدم العثور على هذا الملف، سيستخدم نظام الإدخال تخطيط المفاتيح التلقائي بدلاً من ذلك.

يتم تحويل المسافات في الاسم إلى شرطات سفلية أثناء البحث.

يُرجى الرجوع إلى مستندات ملف تنسيق المفتاح للحصول على مزيد من التفاصيل.

keyboard.characterMap

التعريف: keyboard.characterMap = <name>

تحدِّد هذه الوسيطة اسم ملف ربط أحرف المفاتيح المرتبط بجهاز الإدخال، باستثناء امتداد .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. تمّت إيقاف هذا الحقل نهائيًا في واجهة برمجة التطبيقات، ولكن قد تستمر التطبيقات القديمة في استخدامه.

لن يتم تسجيل لوحة مفاتيح ذات وظائف خاصة (أي لوحة مفاتيح تحدد خريطة أحرف المفاتيح نوعًا من 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 لتخطيط المفاتيح التلقائي وخريطة أحرف المفاتيح. كان تنسيق ملف تضاريس الشخصيات في المفاتيح مختلفًا جدًا أيضًا، ولم يكن إطار العمل متوافقًا مع لوحات المفاتيح الكاملة على غرار أجهزة الكمبيوتر أو لوحات المفاتيح الخارجية.

عند ترقية الأجهزة إلى Honeycomb، احرص على إنشاء ملفات الإعدادات وملفات تعيين المفاتيح اللازمة أو تعديلها.

استخدامات HID ورموز مفاتيح Linux ورموز مفاتيح Android

يشير النظام إلى المفاتيح باستخدام عدة معرّفات مختلفة، استنادًا إلى طبقة التجريد.

بالنسبة إلى أجهزة HID، يكون لكل مفتاح استخدام HID مرتبط به. يتحمّل برنامج تشغيل hid-input لنظام التشغيل Linux وبرامج تشغيل HID ذات الصلة الخاصة بالمورّد والجهاز مسؤولية تحليل تقارير HID وربط استخدامات HID برموز مفاتيح Linux.

عندما يقرأ نظام التشغيل Android أحداث EV_KEY من نواة Linux، يترجم كل رمز مفتاح لنظام التشغيل Linux إلى رمز المفتاح المقابل له في نظام التشغيل Android وفقًا لملف تنسيق المفتاح في الجهاز.

عند إرسال الحدث الرئيسي إلى أحد التطبيقات، يُبلغ android.view.KeyEvent المثيل عن رمز مفتاح Linux كقيمة getScanCode() و رمز مفتاح Android كقيمة getKeyCode(). لأغراض الإطار، لا تكون سوى قيمة getKeyCode() مهمة.

يُرجى العِلم أنّ نظام التشغيل Android نفسه لا يستخدم معلومات استخدام HID ولا يتم تمريرها إلى التطبيقات.

جداول الرموز

توضِّح الجداول التالية كيفية ارتباط استخدامات HID ورموز مفاتيح Linux ورموز مفاتيح Android ببعضها.

يحدِّد عمود LKC رمز مفتاح Linux سداسي عشريًا.

يحدِّد عمود AKC رمز مفتاح Android بالتنسيق السداسي العشري.

يشير عمود "الملاحظات" إلى الملاحظات التي يتم نشرها بعد الجدول.

يحدِّد عمود "الإصدار" أول إصدار من نظام Android العميق الذي يتضمّن هذا المفتاح في خريطة المفاتيح التلقائية. يتم عرض عدة صفوف في الحالات التي تغيّرت فيها خريطة المفاتيح التلقائية بين الإصدارات. أقدم إصدار مُشار إليه هو 1.6.

• في الإصدار Gingerbread (2.3) والإصدارات الأقدم، كان مخطط المفاتيح التلقائي هو qwerty.kl. تم تصميم خريطة المفاتيح هذه للاستخدام مع "محاكي Android" فقط، ولم تكن مخصّصة للاستخدام مع لوحات مفاتيح خارجية متعدّدة. ومع ذلك، أضاف عدد قليل من المصنّعين الأصليّين للأجهزة ميزة استخدام لوحة مفاتيح عبر البلوتوث إلى المنصة واعتمدوا على qwerty.kl لتوفير عمليات ربط لوحة المفاتيح اللازمة. وبالتالي، قد تكون هذه الربطات القديمة ذات أهمية لمصنعي المعدّات الأصليين الذين ينشئون الأجهزة الطرفية لهذه الأجهزة المحدّدة. يُرجى العلم أنّ عمليات الربط تختلف اختلافًا كبيرًا عن عمليات الربط الحالية، خاصةً في ما يتعلق بمعالجة مفتاح HOME. يُنصح بأن يتم تطوير جميع الأجهزة الطرفية الجديدة وفقًا لتنسيق Honeycomb أو أحدث تنسيقات ملف تعريف مفاتيح (مثل HID العادي).

• اعتبارًا من Honeycomb (3.0)، أصبحت خريطة المفاتيح التلقائية هي Generic.kl. تم تصميم خريطة المفاتيح هذه لتتوافق مع لوحات المفاتيح الكاملة على طراز أجهزة الكمبيوتر الشخصي. من المفترض أن تعمل معظم وظائف لوحات مفاتيح HID العادية تلقائيًا بدون الحاجة إلى إجراء أيّ إعدادات.

قد يختلف تعيين رموز المفاتيح في إصدارات نواة Linux وAndroid. عندما يكون معروفًا أنّه حدثت تغييرات في خرائط المفاتيح التلقائية في Android، تتم الإشارة إليها في عمود الإصدار.

قد تطبّق برامج تشغيل HID ومخططات المفاتيح الخاصة بالأجهزة عمليات ربط مختلفة عن تلك المُشار إليها هنا.

صفحة لوحة المفاتيح ولوحة المفاتيح (0x07)

صفحة HID العامة للكمبيوتر المكتبي (0x01)

صفحة مستخدِم HID (0x0c)

عمليات الربط الإضافية غير المرتبطة بواجهة HID

تصف عمليات الربط هذه الدوالّ التي لا تظهر في HID ولكن تتوفّر لها رموز مفاتيح Linux.

المفاتيح القديمة غير المتوافقة

ظهرت عمليات الربط هذه في الإصدارات السابقة من Android، ولكنها لم تكن متسقة مع HID أو كانت تستخدم رموز مفاتيح غير عادية في نظام التشغيل Linux. لم تعُد هذه الإصدارات متاحة.

الملاحظات

1. قد يختلف رمز مفتاح Android المرتبط بالمفاتيح الأبجدية الرقمية والرمزية الشائعة استنادًا إلى تخطيط لوحة المفاتيح ولغتها. لأسباب تاريخية، غالبًا ما يتم تحديد الرموز المخصّصة للمسح الضوئي واستخدامات HID المرتبطة بمفاتيح لوحة المفاتيح من خلال موضعها في لوحة المفاتيح على الرغم من أنّ التصنيفات المطبوعة على هذه المفاتيح قد تختلف من لغة إلى أخرى.

   في لوحة المفاتيح باللغة الإنجليزية (الولايات المتحدة) (QWERTY)، يكون المفتاح الأبجدي في أعلى يمين لوحة المفاتيح مُصنَّفًا باسم Q. في لوحة المفاتيح الفرنسية (AZERTY)، يكون المفتاح في الموضع نفسه مُصنَّفًا بالحرف A. على الرغم من التصنيف، تتم الإشارة في كلتا الكيبوردَين إلى المفتاح الأبجدي الأيمن العلوي باستخدام استخدام HID 0x07 0x0014 الذي تم ربطه برمز مفتاح Linux‏ KEY_Q.

   عند ضبط Android باستخدام تخطيط لوحة مفاتيح باللغة الإنجليزية الأمريكية، سيتم ربط رمز مفتاح Linux‏ KEY_Q برمز مفتاح Android‏ KEYCODE_Q وسيؤدي ذلك إلى عرض الحرفَين "Q" و"q". ومع ذلك، عند ضبط Android باستخدام تخطيط لوحة مفاتيح فرنسي، سيتم ربط رمز مفتاح Linux‏ KEY_Q برمز مفتاح Android KEYCODE_A وسيؤدي ذلك إلى عرض الحرفَين "أ" و"ا".

   يعكس رمز مفتاح Android عادةً التفسير المتعلّق باللغة للمفتاح، لذا قد يتم استخدام رمز مفتاح Android مختلف للغات المختلفة.

2. تم تعريف 0x0c 0x022f AC Zoom في HID على أنّه جهاز تحكّم خطي، ولكن يربطه kernel كمفتاح، وهو ما قد يكون غير صحيح.

3. يتم ربط مفاتيح الوظائف في نظام التشغيل Linux KEY_FN_* بترميز مفاتيح أبسط، ولكن يتم إرسالها مع ضبط البت الخاص بالحالة الوصفيةMETA_FUNCTION على "صحيح".

4. قبل الإصدار 4.0 من Android Ice Cream Sandwich، كان تخطيط المفاتيح التلقائي يحتوي على تعيينات لبعض رموز المفاتيح الإضافية التي لم يتم تحديدها في رؤوس نواة Linux الرئيسية. وقد تمت إزالة هذه الربطات منذ ذلك الحين لأنّ رموز المفاتيح غير المحدّدة مسبقًا هذه تمّ تحديد معانٍ مختلفة لها في الإصدارات الأحدث من نواة Linux.

المصادر

1. جداول استخدام USB HID‏ (الإصدار 1.12)
2. نواة Linux 2.6.39: include/linux/input.h وdrivers/hid/hid-input.c
3. Android ICS: qwerty.kl وGeneric.kl وKeyEvent.java