Klavye cihazları

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Android; özel işlev tuş takımları (ses 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. Dokunmatik klavyeler (Giriş Yöntemi Düzenleyicileri) hakkında bilgi edinmek için Android SDK'sına bakın.

Klavye sınıflandırması

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

• Giriş cihazı, 0 ile 0xff veya KEY_OK ile KEY_MAX arasındaki tuşlar da dahil olmak üzere klavyelerde kullanılan Linux anahtar kodlarının varlığını bildirir.

• Giriş cihazı, BTN_0 ile BTN_9, BTN_TRIGGER ile BTN_DEAD veya BTN_A ile BTN_THUMBR arasındaki değerler dahil olmak üzere kontrol çubuğu ve oyun kumandasında kullanılan Linux tuş kodlarının varlığını bildirir.

Kontrol çubuğu ve oyun kumandası düğmeleri, EV_KEY etkinlikleri tarafından klavye tuşları gibi raporlandığından kontrol çubukları şu anda klavye olarak sınıflandırılmaktadır. Bu nedenle, kontrol çubukları ve oyun kumandaları da yapılandırma için tuş haritası dosyalarından yararlanır.

Bir giriş cihazı klavye olarak sınıflandırıldıktan sonra sistem, giriş cihazı yapılandırma dosyasını ve klavyenin klavye düzenini yükler.

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

• Giriş cihazında KEYCODE_Q ile eşlenen tuşlar varsa cihazın alfabetik keypad'i (sayısal keypad'in aksine) olduğu kabul edilir. Alfabetik tuş takımı özelliği, Configuration kaynağında KEYBOARD_QWERTY olarak raporlanır.

• Giriş cihazında KEYCODE_DPAD_UP, KEYCODE_DPAD_DOWN, KEYCODE_DPAD_LEFT, KEYCODE_DPAD_RIGHT ve KEYCODE_DPAD_CENTER ile eşlenen tuşlar varsa (tümü mevcut olmalıdır) cihazın yön tuş takımı olduğu kabul edilir. Yön tuşları özelliği, Configuration kaynağında NAVIGATION_DPAD olarak bildirilir.

• Giriş cihazında KEYCODE_BUTTON_A veya oyun kumandasıyla ilgili diğer tuşlarla eşlenmiş tuşlar varsa cihazda oyun kumandası olduğu kabul edilir.

Klavye sürücü gereksinimleri

1. Klavye sürücüleri yalnızca gerçekten destekledikleri anahtarların anahtar kodlarını kaydetmelidir. Fazla anahtar kodu kaydetme, 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, EV_KEY değerini kullanarak tuş basma işlemlerini bildirmelidir. Bir 0 değeri, tuşun bırakıldığını, 1 değeri tuşun basıldığını, 2 değerinden büyük veya 2 değerine eşit bir değer ise tuşun otomatik olarak tekrarlandığını gösterir.

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

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

5. Klavye sürücüleri, cihaza EV_LED yazıldığında LED durumlarının ayarlanmasını desteklemelidir. hid-input sürücüsü bunu otomatik olarak yapar. Bu makalenin yazıldığı sırada Android LED_CAPSLOCK, LED_SCROLLLOCK ve LED_NUMLOCK kullanmaktadır. Bu LED'lerin yalnızca klavyede ilgili gösterge ışıkları varsa desteklenmesi gerekir.

6. Yerleşik tuş takımları için klavye sürücüleri (ör. GPIO matrisi kullanan), cihaz uyku moduna geçtiğinde basılı olan tüm tuşlar için EV_KEY etkinliği göndermelidir.0 Aksi takdirde tuşlar takılabilir ve sonsuza kadar otomatik olarak tekrarlanabilir.

Klavye kullanımı

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 klavyenin tuş düzeni haritasını kullanarak Linux tuş kodlarını (bazen tarama kodları olarak da adlandırılır) Android tuş kodlarıyla eşleştirir.

2. InputReader, ham etkinlikleri tüketir ve meta anahtar durumunu günceller. Örneğin, sol kaydırma tuşuna basılırsa veya tuş bırakılırsa okuyucu, META_SHIFT_LEFT_ON ve META_SHIFT_ON bitlerini buna göre ayarlar ya da sıfırlar.

3. InputReader, önemli etkinlik hakkında InputDispatcher'ı bilgilendirir.

4. InputDispatcher, WindowManagerPolicy.interceptKeyBeforeQueueing'yi çağırarak WindowManagerPolicy'den önemli etkinlikle ne yapılacağını sorar. Bu yöntem, belirli tuşlara basıldığında cihazı uyandırmaktan sorumlu olan kritik bir yolun parçasıdır. EventHub, bu kritik yolun tamamlanmasını sağlamak için etkili bir şekilde uyanma kilidi tutar.

5. Şu anda bir InputFilter kullanılıyorsa InputDispatcher, anahtarı tüketme veya dönüştürme fırsatı verir. InputFilter, sistem genelinde düşük düzeyli erişilebilirlik politikaları uygulamak için kullanılabilir.

6. InputDispatcher, anahtarı dağıtım iş parçacığında işleme almak için sıraya ekler.

7. InputDispatcher, anahtarı kuyruktan çıkardığında WindowManagerPolicy'a WindowManagerPolicy.interceptKeyBeforeDispatching'yi çağırarak önemli etkinliği durdurmak için ikinci bir şans verir. Bu yöntem, sistem kısayollarını ve diğer işlevleri yönetir.

8. Ardından InputDispatcher, önemli etkinlik hedefini (odaklanmış pencere) tanımlar ve hazır olmasını bekler. Ardından InputDispatcher, önemli etkinliği uygulamaya gönderir.

9. Uygulama içinde, önemli etkinlik, IME öncesi tuş dağıtımı için görünüm hiyerarşisinde odaklanan görünüme doğru yayılır.

10. Önemli etkinlik, IME öncesi dağıtımda ele alınmazsa ve bir IME kullanılıyorsa önemli etkinlik IME'ye gönderilir.

11. Önemli etkinlik IME tarafından tüketilmediyse standart tuş dağıtımı için önemli etkinlik, görüntü hiyerarşisinde odaklanan görüntüye doğru yayılır.

12. Uygulama, önemli etkinliğin tüketilip tüketilmediğine dair bilgileri InputDispatcher'e bildirir. Etkinlik tüketilmediyse InputDispatcher, "yedek" davranışı uygulamak için WindowManagerPolicy.dispatchUnhandledKey'u çağırır. Yedek işleme bağlı olarak, önemli etkinlik dağıtım döngüsü farklı bir anahtar kodu kullanılarak yeniden başlatılabilir. Örneğin, bir uygulama KEYCODE_ESCAPE ile ilgilenmiyorsa sistem, önemli etkinliği bunun yerine KEYCODE_BACK olarak yeniden gönderebilir.

Klavye yapılandırması

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

Klavye yapılandırmasında yer alan dosyalar hakkında daha fazla bilgi için aşağıdaki bölümlere bakın:

• Anahtar düzen dosyaları
• Temel karakter haritası dosyaları
• Cihaz yapılandırma dosyalarını girme

Özellikler

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

keyboard.layout

Tanım: keyboard.layout = <ad>

Giriş cihazıyla ilişkili anahtar düzeni dosyasının adını (.kl uzantısı hariç) belirtir. Bu dosya bulunamazsa giriş sistemi bunun yerine varsayılan tuş düzenini kullanır.

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

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

keyboard.characterMap

Tanım: keyboard.characterMap = <ad>

Giriş cihazıyla ilişkili anahtar karakter haritası dosyasının adını (.kcm uzantısı hariç) belirtir. Bu dosya bulunamazsa giriş sistemi bunun yerine varsayılan anahtar karakter haritasını kullanır.

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

Daha fazla bilgi için anahtar karakter eşleme dosyası dokümanlarına bakın.

keyboard.orientationAware

Tanım: keyboard.orientationAware = 0 | 1

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

• Değer 1 ise ilişkili ekran yönü değiştiğinde yön tuşları döndürülür.

• Değer 0 ise klavye, ekran yön değişikliklerine karşı bağışıktır.

Varsayılan değer: 0.

Yön farkındalığı, Motorola Droid gibi cihazlardaki yön tuşlarının döndürülmesini 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, "yukarı" tuşu "sağ"ı gösterdiğinden KEYCODE_DPAD_UP, KEYCODE_DPAD_RIGHT olacak şekilde yeniden eşlenir.

keyboard.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 takdirde 0 olur.

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

Yerleşik klavye için 0 kimliği kullanmak, yerleşik klavyenin kimliğini belirten ve 0 değerine sahip KeyCharacterMap.BUILT_IN_KEYBOARD alanıyla uyumluluğu korumak için önemlidir. Bu alanın API'de desteği sonlandırılmıştır ancak eski uygulamalar bu alanı kullanmaya devam edebilir.

Özel işlevli klavyeler (anahtar karakter haritası SPECIAL_FUNCTION türünü belirten klavyeler), bu özelliğin ayarından bağımsız olarak hiçbir zaman yerleşik klavye olarak kaydedilmez. Bunun nedeni, özel işlevli klavyelerin tanımı gereği genel amaçlı yazma için tasarlanmamış olmasıdı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şleyici herhangi bir yapılandırma özelliği kullanmıyordu. Tüm klavyelerin fiziksel olarak bağlı ve yönü bilindiği varsayılmıştır. Varsayılan anahtar düzeni ve anahtar karakter haritası, Generic yerine qwerty olarak adlandırıldı. Anahtar karakter haritası biçimi de ç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 eşleme 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ı kullanarak anahtarları ifade eder.

HID cihazlarda her anahtarın ilişkili bir HID kullanımı vardır. HID raporlarını ayrıştırma ve HID kullanımlarını Linux anahtar kodlarıyla eşleme işlemlerinden Linux hid-input sürücüsü ve ilgili tedarikçiye ve cihaza özel HID sürücüleri sorumludur.

Android, Linux çekirdeğinden EV_KEY etkinliklerini okurken her Linux anahtar kodunu cihazın anahtar düzeni dosyasına göre ilgili Android anahtar koduna çevirir.

Önemli etkinlik bir uygulamaya gönderildiğinde android.view.KeyEvent örneği, Linux anahtar kodunu getScanCode() değerinin, Android anahtar kodunu ise getKeyCode() değerinin değeri olarak raporlar. Çerçeve açısından yalnızca getKeyCode() değeri önemlidir.

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

Kod tabloları

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

LKC sütunu, Linux anahtar kodunu on altılık olarak belirtir.

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

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

Sürüm sütunu, bu anahtarı varsayılan anahtar haritasına dahil eden Android platformunun ilk sürümünü belirtir. Varsayılan tuş eşlemesinin sürümler arasında değiştiği durumlarda birden fazla satır gösterilir. En eski sürüm 1.6 olarak belirtilmiştir.

• 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 için tasarlanmıştır ve rastgele harici klavyeleri desteklemek için tasarlanmamıştır. Yine de birkaç OEM, platforma Bluetooth klavye desteği ekledi ve gerekli klavye eşlemelerini sağlamak için qwerty.kl'ten yararlandı. Bu nedenle, bu eski eşlemeler bu cihazlar için çevre birimleri geliştiren OEM'ler için yararlı olabilir. Eşlemelerin, özellikle HOME anahtarının işlenmesiyle ilgili olarak mevcut eşlemelerden önemli ölçüde farklı olduğunu unutmayın. Tüm yeni çevre birimlerinin, Honeycomb'a veya daha yeni anahtar haritalarına (ör. standart HID) göre geliştirilmesi önerilir.

• Honeycomb (3.0) sürümünden itibaren varsayılan anahtar haritası Generic.kl'tür. Bu tuş haritası, tam PC tarzı klavyeleri desteklemek için tasarlanmıştır. Standart HID klavyelerin çoğu işlevi, kullanıma hazır olarak çalışır.

Anahtar kodu eşleme, Linux çekirdeği ve Android sürümlerine göre değişiklik gösterebilir. Android varsayılan anahtar haritalarında değişiklik olduğu bilindiğinde bu değişiklikler sürüm sütununda belirtilir.

Cihazlara özel HID sürücüleri ve tuş 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 bulunduğu işlevleri açıklar.

Desteklenmeyen eski anahtarlar

Bu eşlemeler Android'in önceki sürümlerinde yer alıyordu ancak HID ile tutarlı değildi veya standart olmayan Linux anahtar kodları kullanıyordu. Bu özellikler artık desteklenmiyor.

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ı genellikle konumsal olarak tanımlanır. Ancak bu tuşlara basılı etiketler dillere göre değişiklik gösterebilir.

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

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

   Android anahtar kodu genellikle anahtarın dile özgü yorumunu yansıtır. Bu nedenle, farklı diller için farklı Android anahtar kodları kullanılabilir.

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

3. Linux işlev tuşları KEY_FN_* daha basit anahtar kodlarıyla eşleştirilir ancak META_FUNCTION meta durumu biti doğru olarak ayarlanarak gönderilir.

4. Android Ice Cream Sandwich 4.0'tan önce varsayılan tuş düzeni, ana Linux çekirdek başlıklarında tanımlanmayan bazı ek tuş kodlarının eşlemelerini içeriyordu. Daha önce tanımlanmamış olan bu anahtar kodlarına Linux çekirdeğinin daha yeni sürümlerinde farklı anlamlar atandığı için bu eşlemeler kaldırılmıştır.

Kaynaklar

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