Klavye cihazları

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

Bu belgede yalnızca fiziksel klavyeler açıklanmaktadır. Yazılım klavyeleri (Giriş Yöntemi Düzenleyicileri) hakkında bilgi için Android SDK'ya bakın.

Klavye sınıflandırması

Aşağıdaki koşullardan herhangi biri geçerliyse bir giriş aygıtı klavye olarak sınıflandırılır:

• Giriş cihazı, 0 ila 0xff veya KEY_OK ila KEY_MAX dahil olmak üzere klavyelerde kullanılan herhangi bir Linux tuş kodunun varlığını bildirir.

• Giriş cihazı, BTN_0 ila BTN_9 , BTN_TRIGGER ila BTN_DEAD veya BTN_A ila BTN_THUMBR dahil olmak üzere oyun çubukları ve gamepad'lerde kullanılan herhangi bir Linux anahtar kodunun varlığını bildirir.

Joystick'ler şu anda klavye olarak sınıflandırılmaktadır çünkü joystick ve gamepad düğmeleri, EV_KEY olayları tarafından klavye tuşlarının raporlandığı şekilde raporlanmaktadır. Bu nedenle joystick'ler ve oyun kumandaları da yapılandırma için önemli harita dosyalarından yararlanır.

Bir giriş aygıtı klavye olarak sınıflandırıldıktan sonra sistem, klavye için giriş aygıtı yapılandırma dosyasını ve klavye düzenini yükler.

Sistem daha sonra cihazın ek özelliklerini belirlemeye çalışır.

• Giriş aygıtında KEYCODE_Q ile eşlenen herhangi bir tuş varsa, aygıtın alfabetik bir tuş takımına (sayısal tuş takımının aksine) sahip olduğu kabul edilir. Alfabetik tuş takımı yeteneği, kaynak Configuration nesnesinde KEYBOARD_QWERTY olarak rapor edilir.

• Giriş aygıtında KEYCODE_DPAD_UP , KEYCODE_DPAD_DOWN , KEYCODE_DPAD_LEFT , KEYCODE_DPAD_RIGHT ve KEYCODE_DPAD_CENTER (hepsi mevcut olmalıdır) ile eşlenen herhangi bir tuş varsa, aygıtın yönlü bir tuş takımına sahip olduğu kabul edilir. Yönlü tuş takımı yeteneği, kaynak Configuration nesnesinde NAVIGATION_DPAD olarak rapor edilir.

• Giriş cihazında KEYCODE_BUTTON_A ile eşlenen herhangi bir tuş veya oyun kumandasıyla ilgili başka tuşlar varsa, bu durumda cihazın bir oyun kumandasına sahip olduğu kabul edilir.

Klavye sürücüsü gereksinimleri

1. Klavye sürücüleri yalnızca gerçekte destekledikleri tuşlara ilişkin tuş kodlarını kaydetmelidir. Fazla anahtar kodlarının kaydedilmesi, cihaz sınıflandırma algoritmasını karıştırabilir veya sistemin, cihazın desteklenen klavye özelliklerini yanlış algılamasına neden olabilir.

2. Klavye sürücüleri, tuşa basıldığını bildirmek için EV_KEY kullanmalıdır; bir tuşun serbest bırakıldığını belirtmek için 0 değerini, bir tuşa basıldığını belirtmek için 1 değerini ve tuşun basıldığını belirtmek için 2 büyük veya ona eşit bir değeri kullanmalıdır. otomatik olarak tekrarlanıyor.

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

4. Klavye sürücüleri isteğe bağlı olarak, MSC_SCANCODE ile EV_MSC ve tuşa basıldığında kullanım veya tarama kodunu belirten bir değeri göndererek HID kullanımını veya düşük seviyeli tarama kodunu belirtebilir. Bu bilgiler şu anda Android tarafından kullanılmamaktadır.

5. Klavye sürücüleri, EV_LED cihaza yazıldığında LED durumlarının ayarlanmasını desteklemelidir. hid-input sürücüsü bunu otomatik olarak yönetir. Bu yazının yazıldığı sırada Android, LED_CAPSLOCK , LED_SCROLLLOCK ve LED_NUMLOCK kullanıyor. Bu LED'lerin yalnızca klavyede gerçekten ilgili gösterge ışıkları bulunduğunda desteklenmesi gerekir.

6. Gömülü tuş takımlarına yönelik klavye sürücüleri (örneğin, GPIO matrisi kullanan), aygıt uyku moduna geçtiğinde hâlâ basılan tüm tuşlar için EV_KEY olaylarını 0 değeriyle gönderdiğinden emin olmalıdır. Aksi takdirde tuşlar sıkışabilir ve sonsuza kadar otomatik olarak tekrarlanır.

Klavye işlemi

Aşağıda Android'deki klavye işleminin kısa bir özeti bulunmaktadır.

1. EventHub , evdev sürücüsündeki ham olayları okur ve klavyenin tuş düzeni haritasını kullanarak Linux anahtar kodlarını (bazen tarama kodları olarak da adlandırılır) Android anahtar kodlarıyla eşler.

2. InputReader ham olayları tüketir ve meta anahtar durumunu günceller. Örneğin sol kaydırma tuşuna basıldığında veya bırakıldığında okuyucu META_SHIFT_LEFT_ON ve META_SHIFT_ON bitlerini buna göre ayarlayacak veya sıfırlayacaktır.

3. InputReader InputDispatcher anahtar olay hakkında bilgi verir.

4. InputDispatcher WindowManagerPolicy WindowManagerPolicy.interceptKeyBeforeQueueing çağırarak anahtar olayıyla ne yapılacağını sorar. Bu yöntem, belirli tuşlara basıldığında cihazın uyanmasından sorumlu olan kritik yolun bir parçasıdır. EventHub bu kritik yolun tamamlanmasını sağlamak için etkin bir şekilde bir uyanık kalma kilidi tutar.

5. Bir InputFilter şu anda kullanımdaysa, InputDispatcher ona anahtarı kullanma veya dönüştürme şansı verir. InputFilter düşük seviyeli sistem çapında erişilebilirlik politikalarını uygulamak için kullanılabilir.

6. InputDispatcher , dağıtım iş parçacığında işlenmek üzere anahtarı kuyruğa alır.

7. InputDispatcher anahtarı kuyruktan çıkardığında, WindowManagerPolicy WindowManagerPolicy.interceptKeyBeforeDispatching çağırarak anahtar olayını ele geçirmesi için ikinci bir şans verir. Bu yöntem, sistem kısayollarını ve diğer işlevleri yönetir.

8. Daha sonra InputDispatcher anahtar olay hedefini (odaklanmış pencere) tanımlar ve bunların hazır olmasını bekler. Daha sonra, InputDispatcher anahtar olayı uygulamaya iletir.

9. Uygulamanın içinde anahtar olayı, IME öncesi anahtar gönderimi için görünüm hiyerarşisini aşağıya odaklanmış görünüme yayar.

10. Anahtar olay IME öncesi gönderimde işlenmiyorsa ve bir IME kullanılıyorsa anahtar olay IME'ye iletilir.

11. Anahtar olay IME tarafından tüketilmediyse anahtar olay, standart anahtar gönderimi için görünüm hiyerarşisini aşağıya odaklanmış görünüme yayar.

12. Uygulama, anahtar olayın tüketilip tüketilmediğine ilişkin olarak InputDispatcher rapor verir. Olay tüketilmediyse, InputDispatcher "geri dönüş" davranışını uygulamak için WindowManagerPolicy.dispatchUnhandledKey çağırır. Geri dönüş eylemine bağlı olarak anahtar olay gönderme döngüsü, farklı bir anahtar kodu kullanılarak yeniden başlatılabilir. Örneğin, bir uygulama KEYCODE_ESCAPE işlemiyorsa, sistem bunun yerine anahtar olayını KEYCODE_BACK olarak yeniden gönderebilir.

Klavye yapılandırması

Klavye davranışı klavyenin tuş düzenine, tuş karakter haritasına ve giriş cihazı konfigürasyonuna göre belirlenir.

Klavye yapılandırmasına katılan dosyalar hakkında daha fazla ayrıntı için aşağıdaki bölümlere bakın:

• Anahtar düzen dosyaları
• Anahtar karakter eşleme dosyaları
• Giriş cihazı yapılandırma dosyaları

Özellikler

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

klavye düzeni

Tanım: keyboard.layout = <isim>

.kl uzantısı hariç, giriş aygıtıyla ilişkili tuş düzeni dosyasının adını belirtir. Bu dosya bulunamazsa, giriş sistemi bunun yerine varsayılan tuş düzenini kullanacaktır.

Arama sırasında addaki boşluklar alt çizgiye dönüştürülür.

Daha fazla ayrıntı için tuş düzeni dosyası belgelerine bakın.

klavye.karakter Haritası

Tanım: keyboard.characterMap = <isim>

.kcm uzantısı hariç, giriş aygıtıyla ilişkili anahtar karakter eşleme dosyasının adını belirtir. Bu dosya bulunamazsa, giriş sistemi bunun yerine varsayılan anahtar karakter haritasını kullanacaktır.

Arama sırasında addaki boşluklar alt çizgiye dönüştürülür.

Daha fazla ayrıntı için anahtar karakter eşleme dosyası belgelerine bakın.

klavye.oryantasyonAware

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ı ilgili ekran yönü değiştiğinde döndürülür.

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

Varsayılan değer 0 .

Yönlendirme farkındalığı, Motorola Droid'de olduğu gibi yön tuş takımı tuşlarının dönüşünü desteklemek için kullanılır. Örneğin, cihaz doğal yönünden saat yönünde 90 derece döndürüldüğünde, KEYCODE_DPAD_UP , cihaz bu yönde tutulduğunda 'yukarı' tuşu 'sağa' işaret ettiğinden KEYCODE_DPAD_RIGHT üretecek şekilde yeniden eşlenir.

klavye.builtIn

Tanım: keyboard.builtIn = 0 | 1

Klavyenin yerleşik (fiziksel olarak bağlı) klavye olup olmadığını belirtir.

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

Yerleşik klavyeye her zaman 0 aygıt kimliği atanır. Yerleşik olmayan diğer klavyelere sıfır olmayan benzersiz aygıt kimlikleri atanır.

Yerleşik klavye için 0 kimliğinin kullanılması, yerleşik klavyenin kimliğini belirten ve değeri 0 olan KeyCharacterMap.BUILT_IN_KEYBOARD alanıyla uyumluluğun sürdürülmesi açısından önemlidir. Bu alan API'de kullanımdan kaldırıldı ancak eski uygulamalar hâlâ onu kullanıyor olabilir.

Özel işlevli bir klavye (anahtar karakter haritası SPECIAL_FUNCTION türünü belirten bir klavye), bu özelliğin ayarına bakılmaksızın hiçbir zaman yerleşik klavye olarak kaydedilmeyecektir. Bunun nedeni, özel işlevli bir klavyenin tanımı gereği genel amaçlı yazım için kullanılması amaçlanmamasıdır.

Örnek konfigürasyonlar

# 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ş eşleyicisi herhangi bir yapılandırma özelliği kullanmıyordu. Tüm klavyelerin fiziksel olarak bağlı olduğu ve oryantasyona duyarlı olduğu varsayılmıştır. Varsayılan anahtar düzeni ve anahtar karakter haritasına Generic yerine qwerty adı verildi. Anahtar karakter haritası formatı da çok farklıydı ve çerçeve, PC tarzı tam klavyeleri veya harici klavyeleri desteklemiyordu.

Cihazları Honeycomb'a yükseltirken gerekli yapılandırma ve anahtar harita dosyalarını oluşturduğunuzdan veya güncellediğinizden emin olun.

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

Sistem, soyutlama katmanına bağlı olarak birkaç farklı tanımlayıcı kullanan anahtarlara atıfta bulunur.

HID cihazları için her anahtarın ilişkili bir HID kullanımı vardır. Linux hid-input sürücüsü ve ilgili satıcıya ve cihaza özel HID sürücüleri, HID raporlarının ayrıştırılmasından ve HID kullanımlarının Linux anahtar kodlarıyla eşleştirilmesinden sorumludur.

Android, Linux çekirdeğinden EV_KEY olaylarını okurken, her bir Linux anahtar kodunu, cihazın anahtar düzeni dosyasına göre karşılık gelen Android anahtar koduna çevirir.

Key olayı bir uygulamaya gönderildiğinde, android.view.KeyEvent örneği, Linux anahtar kodunu getScanCode() değeri olarak ve Android anahtar kodunu getKeyCode() değeri olarak bildirir. Çerçevenin amaçları açısından yalnızca getKeyCode() değeri önemlidir.

HID kullanım bilgilerinin Android'in kendisi tarafından kullanılmadığını veya uygulamalara aktarılmadığını unutmayın.

Kod tabloları

Aşağıdaki tablolarda HID kullanımlarının, Linux anahtar kodlarının ve Android anahtar kodlarının birbirleriyle nasıl ilişkili olduğu gösterilmektedir.

LKC sütunu, Linux anahtar kodunu onaltılı olarak belirtir.

AKC sütunu, Android anahtar kodunu onaltılık olarak belirtir.

Notlar sütunu, tablodan sonra gönderilen notları ifade eder.

Sürüm sütunu, Android platformunun bu anahtarı varsayılan anahtar haritasına ekleyen ilk sürümünü belirtir. Varsayılan anahtar haritasının sürümler arasında değiştiği durumlarda birden fazla satır gösterilir. Belirtilen en eski sürüm 1.6'dır.

• Gingerbread (2.3) ve önceki sürümlerde varsayılan anahtar haritası qwerty.kl idi. Bu tuş haritası yalnızca Android Emulator ile kullanılmak üzere tasarlanmış olup, isteğe bağlı harici klavyeleri desteklemek için kullanılmak üzere tasarlanmamıştır. Bununla birlikte, birkaç OEM, platforma Bluetooth klavye desteği ekledi ve gerekli klavye eşlemelerini sağlamak için qwerty.kl güvendi. Sonuç olarak, bu eski eşleştirmeler, bu belirli cihazlar için çevre birimleri üreten OEM'lerin ilgisini çekebilir. Eşlemelerin, özellikle HOME anahtarının işlenmesi açısından mevcut olanlardan önemli ölçüde farklı olduğuna dikkat edin. Tüm yeni çevre birimlerinin Honeycomb'a veya daha yeni anahtar haritalara (ör. standart HID) göre geliştirilmesi önerilir.

• Honeycomb (3.0)'dan itibaren varsayılan anahtar haritası Generic.kl . Bu tuş haritası, tam PC tarzı klavyeleri destekleyecek şekilde tasarlanmıştır. Standart HID klavyelerin çoğu işlevselliği kutudan çıktığı gibi çalışmalıdır.

Anahtar kod eşlemesi, Linux çekirdeği ve Android sürümlerine göre değişiklik gösterebilir. Android varsayılan anahtar haritalarında değişikliklerin meydana geldiği bilindiğinde, bunlar sürüm sütununda gösterilir.

Cihaza özel HID sürücüleri ve anahtar haritaları, burada belirtilenden farklı eşlemeler uygulayabilir.

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 anahtar kodlarının mevcut olduğu işlevleri açıklar.

Eski desteklenmeyen anahtarlar

Bu eşlemeler Android'in önceki sürümlerinde görünüyordu ancak HID ile tutarsızdı veya standart olmayan Linux anahtar kodları kullanılmıştı. Artık desteklenmiyorlar.

Notlar

1. Yaygın alfanümerik ve sembolik tuşlarla ilişkili Android anahtar kodu, klavye düzenine ve dile göre değişiklik gösterebilir. Tarihsel nedenlerden dolayı, klavyedeki tuşlarla ilişkili fiziksel tarama kodları ve HID kullanımları, bu tuşların üzerine basılan etiketler bir dilden diğerine farklılık gösterse de genellikle konumsal olarak tanımlanır.

   ABD İngilizcesi (QWERTY) klavyesinde sol üst alfabetik tuş Q olarak etiketlenir. Fransızca (AZERTY) klavyede aynı konumdaki tuş A olarak etiketlenir. Etikete rağmen, her iki klavyede de sol üst alfabetik tuş Linux anahtar kodu KEY_Q ile eşlenen 0x07 0x0014 HID kullanımı kullanılarak anılır.

   Android, ABD İngilizcesi klavye düzeniyle yapılandırıldığında, Linux anahtar kodu KEY_Q, Android anahtar kodu KEYCODE_Q ile eşleştirilecek ve 'Q' ve 'q' karakterlerini üretecektir. Ancak, Android Fransızca klavye düzeniyle yapılandırıldığında, Linux anahtar kodu KEY_Q, Android anahtar kodu KEYCODE_A ile eşleştirilecek ve 'A' ve 'a' karakterlerini üretecektir.

   Android anahtar kodu genellikle anahtarın dile özgü yorumunu yansıtır; dolayısıyla farklı diller için farklı bir Android anahtar kodu kullanılabilir.

2. 0x0c 0x022f AC Zoom HID'de doğrusal bir kontrol olarak tanımlanır, ancak çekirdek onu bir anahtar olarak eşler; bu muhtemelen yanlıştır.

3. Linux işlev tuşları KEY_FN_* daha basit anahtar kodlarıyla eşlenir ancak META_FUNCTION meta durum biti true olarak ayarlanarak gönderilir.

4. Android Ice Cream Sandwich 4.0'dan önce, varsayılan anahtar düzeni, ana Linux çekirdek başlıklarında tanımlanmayan bazı ekstra anahtar kodlar için eşlemeler içeriyordu. Bu eşlemeler daha sonra kaldırıldı çünkü daha önce tanımlanmamış olan bu anahtar kodlara, Linux çekirdeğinin daha yeni sürümlerinde farklı anlamlar verildi.

Kaynaklar

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