Klavye cihazları

Android, özel işlevler de dahil çeşitli klavye cihazlarını destekler tuş takımları (ses ve güç kontrolleri), kompakt yerleşik Q klavyeler, ve tam özellikli PC tarzı harici klavyeler.

Bu dokümanda yalnızca fiziksel klavyeler açıklanmaktadır. Android SDK'ya bakın (Giriş Yöntemi Düzenleyicileri) hakkında bilgi edinin.

Klavye sınıflandırması

Giriş cihazı, aşağıdakilerden biri geçerliyse klavye olarak sınıflandırılır. koşullar şunlardır:

• Giriş cihazı, klavyelerde kullanılan Linux tuş kodlarının varlığını bildirir 0xff aracılığıyla 0 veya KEY_MAX üzerinden KEY_OK dahil.

• Giriş cihazı, kontrol çubuğunda kullanılan Linux anahtar kodlarının varlığını bildirir BTN_0 - BTN_9, BTN_TRIGGER - BTN_DEAD arası dahil olmak üzere oyun kumandaları veya BTN_THUMBR - BTN_A.

Kontrol çubukları şu anda klavye olarak sınıflandırılmaktadır çünkü kontrol çubuğu ve oyun kumandası düğmeleri EV_KEY etkinlikleri tarafından, klavye tuşlarının raporlandığı şekilde raporlanır. Dolayısıyla, Ayrıca kontrol çubukları ve oyun kumandaları, yapılandırma için tuş eşleme dosyalarını da kullanır.

Giriş cihazı klavye olarak sınıflandırıldığında, sistem klavye için giriş cihazı yapılandırma dosyasını ve klavye düzenini kullanın.

Daha sonra sistem, cihazın ek özelliklerini belirlemeye çalışır.

• Giriş cihazında KEYCODE_Q ile eşlenmiş herhangi bir tuş varsa cihazın alfabetik tuş takımı (sayısal değil) olduğu kabul edilir. Alfabetik tuş takımı özelliği, Configuration kaynağında rapor edilir. nesnesini KEYBOARD_QWERTY olarak tanımlar.

• Giriş cihazında KEYCODE_DPAD_UP ile eşlenmiş tuşlar varsa KEYCODE_DPAD_DOWN, KEYCODE_DPAD_LEFT, KEYCODE_DPAD_RIGHT ve KEYCODE_DPAD_CENTER (tümü mevcut olmalıdır) ise cihaz kabul edilir Yön tuşlarından yararlanın. Yön tuş takımı özelliği, Configuration kaynağında raporlanır. nesnesini NAVIGATION_DPAD olarak tanımlar.

• Giriş cihazında KEYCODE_BUTTON_A ile eşlenmiş tuşlar varsa veya benzeri bir oyun kumandası kullanıyorsanız, cihazda oyun kumandası olduğu kabul edilir.

Klavye sürücüsü gereksinimleri

1. Klavye sürücüleri yalnızca kullandıkları tuşlara ilişkin tuş kodlarını kaydetmelidir destek olmaktır. Fazla anahtar kodlarının kaydedilmesi cihazı karıştırabilir sınıflandırma algoritması kullanıyor veya sistemin, verileri yanlış bir şekilde algılamasına cihazın desteklenen klavye özelliklerini kullanabilirsiniz.

2. Klavye sürücüleri, tuşlara basma işlemlerini bildirmek için bir değer kullanarak EV_KEY kullanmalıdır. bir anahtarın kullanıma sunulduğunu belirtmek için 0, bu değerin 1 olduğunu belirten bir değer olduğunu belirtmek için bir tuşa basılır ve 2 veya daha büyük bir değer anahtar otomatik olarak tekrarlanır.

3. Android, kendi klavye tekrarını gerçekleştirir. Otomatik tekrarlama işlevi sürücüde devre dışı bırakılmalıdır.

4. Klavye sürücüleri isteğe bağlı olarak HID kullanımını veya düşük düzeyli taramayı belirtebilir EV_MSC uygulamasını MSC_SCANCODE ve kullanımı gösteren bir değerle göndererek kod veya tuşa basıldığında kodu tarayın. Bu bilgiler şu anda Android tarafından kullanılıyor.

5. EV_LED yazıldığında klavye sürücüleri, LED durumlarını ayarlamayı desteklemelidir ekleyebilirsiniz. hid-input sürücüsü bu işlemi otomatik olarak halleder. Bu yazının yazıldığı sırada Android, LED_CAPSLOCK, LED_SCROLLLOCK, ve LED_NUMLOCK. Bu LED'lerin yalnızca ilgili gösterge ışıkları vardır.

6. Yerleştirilmiş tuş takımları için klavye sürücüleri (örneğin, bir GPIO matrisi kullanarak) EV_KEY etkinliklerini, 0 değerini içeren tüm anahtarlar için göndermeyi unutmayın. cihaz uyku moduna geçerken de basılır. Aksi takdirde anahtarlar takılıp kalır ve sonsuza kadar otomatik olarak yinelenir.

Klavye işlemi

Aşağıda, Android'deki klavye işleminin kısa bir özeti verilmiştir.

1. EventHub, evdev sürücüsünden ham etkinlikleri okur ve Linux anahtar kodlarını eşler (bazen tarama kodları olarak da adlandırılır) klavye tuş düzeni haritasını tıklayın.

2. InputReader, ham etkinlikleri kullanır ve meta anahtar durumunu günceller. Örneğin, sol üst karakter tuşuna basıldığında veya bırakıldığında okuyucu META_SHIFT_LEFT_ON ve META_SHIFT_ON bitlerini uygun şekilde ayarlayın veya sıfırlayın.

3. InputReader, InputDispatcher adlı kullanıcıyı önemli etkinlik hakkında bilgilendirir.

4. InputDispatcher, WindowManagerPolicy adlı kullanıcıya anahtarla ne yapılacağını sorar WindowManagerPolicy.interceptKeyBeforeQueueing numaralı telefonu arayarak etkinliği oluşturun. Bu yöntem Bu, aşağıdaki durumlarda cihazı uyandırmaktan sorumlu kritik bir yolun bir parçasıdır: belirli tuşlara basıldığından emin olun. EventHub etkili bir şekilde uyanık kalma kilidi tutar projenin tamamlanacağından emin olmak için bu kritik yolun

5. Şu anda InputFilter kullanılıyorsa InputDispatcher bunun için bir kullanma veya dönüştürme olanağı sağlar. InputFilter, dönüşüm hunisinin üst kısmındaki sistem genelinde geçerli erişilebilirlik politikaları.

6. InputDispatcher, anahtarı gönderme iş parçacığında işlenmek üzere sıraya koyar.

7. InputDispatcher, anahtarı sıraya aldığında WindowManagerPolicy değerini verir önemli etkinliğe müdahale etmek için WindowManagerPolicy.interceptKeyBeforeDispatching. Bu yöntem, kısayolları ve diğer işlevleri kullanın.

8. Ardından InputDispatcher, önemli etkinlik hedefini (odaklanan pencere) tanımlar ve hazır olmalarını bekliyor. Daha sonra InputDispatcher, en önemli etkinlik yürüttüğüdür.

9. Önemli etkinlik, uygulama içinde görünüm hiyerarşisinden aşağı doğru yayılır. odaklanmış görünüm oluşturabilirsiniz.

10. Önemli etkinlik, IME öncesi dağıtımda işlenmiyorsa ve bir IME kullanılıyorsa önemli etkinlik IME'ye iletilir.

11. Önemli etkinlik IME tarafından tüketilmediyse önemli etkinlik yayılır görünüm hiyerarşisinden, standart anahtar dağılımı için odaklanmış görünüme geçiş yapın.

12. Uygulama, anahtarın doğru şekilde çalışıp çalışmadığıyla ilgili olarak InputDispatcher nasıl tüketildiğini gösterir. Etkinlik tüketilmediyse InputDispatcher "yedek" uygulamak için WindowManagerPolicy.dispatchUnhandledKey çağrısı gösterir. Yedek işlemine bağlı olarak, önemli etkinlik dağıtma döngüsü yeniden başlatılabilir anahtar kodu kullanabilirsiniz. Örneğin, bir uygulama KEYCODE_ESCAPE, sistem bunun yerine önemli etkinliği KEYCODE_BACK olarak yeniden gönderebilir.

Klavye yapılandırması

Klavye davranışı, klavyenin tuş düzenine, tuş karakterine göre belirlenir harita ve giriş cihazı yapılandırmasına dokunun.

Dosyalarda görünen dosyalar hakkında daha ayrıntılı bilgi için klavye yapılandırmasına katılma:

• Tuş düzeni dosyaları
• Anahtar karakter eşleme dosyaları
• Cihaz yapılandırma dosyalarını girme

Özellikler

Aşağıdaki giriş cihazı yapılandırma özellikleri klavyeler için kullanılır.

klavye.layout

Tanım: keyboard.layout = <ad>

Giriş cihazıyla ilişkilendirilmiş tuş düzen dosyasının adını belirtir. .kl uzantısı hariç tutuluyor. Bu dosya bulunmazsa giriş sistemi bunun yerine varsayılan tuş düzenini kullanır.

Addaki boşluklar, arama sırasında alt çizgilere dönüştürülür.

Daha fazla bilgi için tuş düzeni dosyası dokümanlarına bakın.

klavye.Karakter Haritası

Tanım: keyboard.characterMap = <ad>

Giriş cihazıyla ilişkilendirilmiş anahtar karakter eşleme dosyasının adını belirtir. .kcm uzantısı hariç tutuluyor. Bu dosya bulunmazsa giriş sistemi bunun yerine varsayılan tuş karakter eşlemeyi kullanır.

Addaki boşluklar, arama sırasında alt çizgilere dönüştürülür.

Daha fazla bilgi için tuş karakter eşlemesi dosya dokümanlarına bakın.

klavye.orientationAware

Tanım: keyboard.orientationAware = 0 | 1

Klavyenin, ekran yönü değişikliklerine tepki verip vermeyeceğini belirtir.

• Değer 1 ise yön tuş takımı tuşları, ilişkili ekran yönü değişiklikleri.

• Değer 0 ise klavye, yön değişikliklerini görüntülemez.

Varsayılan değer 0 değeridir.

Yön farkındalığı, yön tuş takımı tuşlarının döndürülmesini desteklemek için kullanılır. örneğin Motorola Droid'de. Örneğin, cihaz döndürüldüğünde saat yönünde doğal yönünde 90 derece, KEYCODE_DPAD_UP "yukarıdan" bu yana KEYCODE_DPAD_RIGHT üretimi için yeniden eşlendi anahtar yukarıyı gösteriyor "sağ" hareket ettirildiğinde ne olur?

klavye.Yerleşik

Tanım: keyboard.builtIn = 0 | 1

Klavyenin yerleşik (fiziksel olarak takılı) olup olmadığını belirtir klavye kısayollarını da kullanabilirsiniz.

Cihaz adı -keypad ile bitiyorsa varsayılan değer 1, aksi takdirde 0 değeridir.

Yerleşik klavyeye her zaman 0 cihaz kimliği atanır. Diğer klavyeler yerleşik olmayan cihazlara sıfır olmayan benzersiz cihaz kimlikleri atanır.

Yerleşik klavyede 0 kimliğinin kullanılması, KeyCharacterMap.BUILT_IN_KEYBOARD alanıyla uyumluluk gösteren yerleşik klavyenin kimliğidir ve 0 değerine sahiptir. Bu alan API'de desteği sonlandırıldı ancak eski uygulamalar tarafından kullanılmaya devam ediyor olabilir.

Özel fonksiyonlu klavye (anahtar karakter eşleştirmesinde SPECIAL_FUNCTION türü) hiçbir zaman yerleşik klavye olarak kaydedilmez, bu mülkün ayarından bağımsız olarak. Bunun nedeni, işlevlerin klavye, tanım gereği genel amaçlı yazmak için kullanılmak üzere tasarlanmamıştır.

Örnek yapılandırmalar

# 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

Uyumluluk notları

Honeycomb'dan önce, klavye girişi eşleştirici herhangi bir yapılandırma özelliği kullanmıyordu. Tüm klavyelerin fiziksel olarak takılı ve yöne duyarlı olduğu varsayıldı. Varsayılan tuş düzeni ve anahtar karakter eşlemesi Generic yerine qwerty olarak adlandırıldı. Temel karakter haritasının biçimi de çok farklıydı ve çerçeve, PC tarzı tam klavyeler veya harici klavyeler.

Cihazları Honeycomb'a yükseltirken, gerekli düzenlemeleri yaptığınızdan veya yapılandırma ve anahtar eşleme dosyaları için geçerlidir.

HID kullanımları, Linux anahtar kodları ve Android anahtar kodları

Sistem, duruma bağlı olarak, bir dizi farklı tanımlayıcı kullanan soyutlama katmanıdır.

HID cihazlar için her anahtarın ilişkili bir HID kullanımı vardır. Linux hid-input ilgili tedarikçi firma ile cihaza özgü HID sürücülerinin sorumluluğundadır. HID raporlarını ayrıştırmak ve HID kullanımlarını Linux anahtar kodlarıyla eşlemek için kullanılır.

Android, Linux çekirdeğinden EV_KEY etkinliğini okuduğunda her bir etkinliği çevirir. cihazın tuş düzen dosyasını seçin.

Önemli etkinlik bir uygulamaya gönderildiğinde android.view.KeyEvent örnek, Linux anahtar kodunu getScanCode() değeri ve getKeyCode() değeri olarak Android anahtar kodu. Sözleşmelerin çerçevesinde olduğunda yalnızca getKeyCode() değeri önemlidir.

HID kullanım bilgilerinin Android'in kendisi tarafından kullanılmadığını veya için de geçerli.

Kod tabloları

Aşağıdaki tablolarda HID kullanımları, Linux anahtar kodları ve Android'in nasıl kullanıldığı gösterilmektedir birbiriyle ilişkili olması gerekir.

LKC sütunu, Linux anahtar kodunu onaltılık biçimde belirtir.

AKC sütunu, Android anahtar kodunu onaltılık değerde belirtir.

Notlar sütunu, tablodan sonra yayınlanan notları ifade eder.

Sürüm sütunu, Android platformunun ilk sürümünü belirtir. bu anahtarı varsayılan tuş eşlemesine dahil etmiş olmalıdır. Birden çok satır, Sürümler arasında varsayılan tuş eşlemesinin değiştiği durumlarda gösterilir. Belirtilen en eski sürüm 1.6'dır.

• Gingerbread (2.3) ve önceki sürümlerde varsayılan temel eşleme şuydu: qwerty.kl Bu tuş eşlemesi yalnızca Android ile kullanılmak üzere tasarlanmıştır. Emülatör olup rastgele destek sunmak için kullanılmak üzere tasarlanmamıştır olmasını sağlayın. Yine de birkaç OEM, Bluetooth işlevini ekledi için klavye desteğini kullandı ve qwerty.kl gerekli klavye eşlemelerini sağlayın. Dolayısıyla bu eski haritalamalar model oluşturan OEM’lerin çevre birimlerini kullanabilirsiniz. Eşlemelerin bugünkülerden önemli ölçüde farklı HOME anahtarının işlenmesiyle ilgili olarak sunar. Bu işlem önerilir tüm yeni çevre birimlerinin Honeycomb veya daha yüksek bir merkez son tuş eşlemeleri (ör. standart HID).

• Honeycomb (3.0) itibarıyla varsayılan temel eşleme Generic.kl şeklindedir. Bu tuş eşlemesi tam PC stili klavyeleri destekleyecek şekilde tasarlanmıştır. Standart HID klavyelerin çoğu işlevi sorunsuz şekilde çalışır ekleyebilirsiniz.

Anahtar kodu eşlemesi, Linux çekirdeği ve Android sürümleri arasında değişiklik gösterebilir. Android'in varsayılan tuş eşlemelerinde değişikliklerin yapıldığı bilindiğinde bunlar sürüm sütununda belirtilir.

Cihaza özgü HID sürücüleri ve tuş eşlemeleri farklı eşlemeler uygulayabilir daha büyük bir fırsattır.

HID klavye ve tuş takımı sayfası (0x07)

HID genel masaüstü sayfası (0x01)

HID tüketici sayfası (0x0c)

HID olmayan ek eşlemeler

Bu eşlemeler, HID'de görünmeyen ancak Linux'un kullandığı işlevleri açıklar. anahtar kodları mevcut.

Desteklenmeyen eski anahtarlar

Bu eşlemeler Android'in önceki sürümlerinde görünüyordu, ancak HID veya standart olmayan Linux anahtar kodları. Bunlar artık desteklenmiyor.

Notlar

1. Yaygın olarak kullanılan alfanümerik ve sembolik öğelerle ilişkilendirilmiş Android anahtar kodu tuşlar, klavye düzenine ve dile bağlı olarak değişiklik gösterebilir. Geçmişteki nedenlerden dolayı, fiziksel tarama kodları ve HID kullanımları klavyedeki tuşlarla ilişkili tuşlar genellikle konumsal olarak tanımlanır üzerindeki etiketler farklı etiket veya dilini kullanır.

   ABD İngilizcesi (QWERTY) klavyede, sol üstteki alfabetik tuş etiketli: Fransızca (AZERTY) klavyede, tuş aynı konumu A olarak etiketlenir. Etikete rağmen, her iki klavyede sol üstteki alfabetik tuşa HID kullanımı kullanılıyor KEY_Q Linux anahtar koduna eşlenen 0x07 0x0014.

   Android, ABD İngilizcesi klavye düzeniyle yapılandırıldığında, KEY_Q Linux anahtar kodu, Android anahtar koduyla eşlenecektir KEYCODE_Q ile çalışır ve 'Q' karakterlerini oluşturur ve 'q'. Ancak Android Fransızca klavye düzeniyle yapılandırıldığında, KEY_Q Linux anahtar kodu, Android anahtar koduyla eşlenir KEYCODE_A ile çalışır ve "A" karakterlerini oluşturur ve "a" yer alır.

   Android anahtarı kodu, genellikle dile özgü kodu yansıtır. anahtarın yorumlanmasını sağlar. Dolayısıyla farklı bir Android anahtarı kodu farklı diller için kullanılabilir.

2. 0x0c 0x022f AC Zoom, HID'de doğrusal bir kontrol olarak tanımlanır ancak çekirdek bunu bir anahtar olarak eşler. Bu da büyük olasılıkla yanlıştır.

3. Linux işlev anahtarları KEY_FN_* daha basit şekilde eşlendi. anahtar kodları ancak META_FUNCTION meta durumuyla gönderilir bit değerini ayarlayın.

4. Android Ice Cream Sandwich 4.0'dan önceki sürümler, varsayılan tuş düzeniydi. tanımlanmamış bazı ek anahtar kodları için eşlemeler içeriyordu ifadesini girin. Bu eşlemeler o zamandan beri önceden tanımlanmamış bu anahtar kodları, şu nedenle kaldırıldı: daha yeni sürümlerde farklı anlamlar taşıdığından örneğidir.

Kaynaklar

1. USB HID Kullanım Tabloları v1.12
2. Linux 2.6.39 çekirdeği: include/linux/input.h, keys/hid/hid-input.c
3. Android ICS: qwerty.kl, Genel.kl, KeyEvent.java