Perangkat papan ketik

Android mendukung berbagai perangkat keyboard termasuk keypad fungsi khusus (kontrol volume dan daya), keyboard QWERTY ringkas yang tertanam, dan keyboard eksternal bergaya PC berfitur lengkap.

Dokumen ini hanya menjelaskan keyboard fisik. Lihat SDK Android untuk informasi tentang keyboard lunak (Editor Metode Input).

Klasifikasi papan ketik

Perangkat input diklasifikasikan sebagai keyboard jika salah satu dari kondisi berikut terpenuhi:

• Perangkat input melaporkan keberadaan kode kunci Linux apa pun yang digunakan pada keyboard termasuk 0 hingga 0xff atau KEY_OK hingga KEY_MAX .

• Perangkat input melaporkan keberadaan kode kunci Linux apa pun yang digunakan pada joystick dan gamepad termasuk BTN_0 hingga BTN_9 , BTN_TRIGGER hingga BTN_DEAD , atau BTN_A hingga BTN_THUMBR .

Joystick saat ini diklasifikasikan sebagai keyboard karena tombol joystick dan gamepad dilaporkan oleh peristiwa EV_KEY dengan cara yang sama seperti tombol keyboard dilaporkan. Oleh karena itu, joystick dan gamepad juga menggunakan file peta utama untuk konfigurasi.

Setelah perangkat input diklasifikasikan sebagai keyboard, sistem memuat file konfigurasi perangkat input dan tata letak keyboard untuk keyboard tersebut.

Sistem kemudian mencoba menentukan karakteristik tambahan perangkat.

• Jika perangkat masukan memiliki kunci yang dipetakan ke KEYCODE_Q , maka perangkat tersebut dianggap memiliki papan tombol alfabet (bukan numerik). Kemampuan keypad alfabet dilaporkan dalam objek Configuration sumber daya sebagai KEYBOARD_QWERTY .

• Jika perangkat input memiliki kunci yang dipetakan ke KEYCODE_DPAD_UP , KEYCODE_DPAD_DOWN , KEYCODE_DPAD_LEFT , KEYCODE_DPAD_RIGHT , dan KEYCODE_DPAD_CENTER (semuanya harus ada), maka perangkat tersebut dianggap memiliki keypad arah. Kemampuan papan tombol arah dilaporkan dalam objek Configuration sumber daya sebagai NAVIGATION_DPAD .

• Jika perangkat input memiliki tombol apa pun yang dipetakan ke KEYCODE_BUTTON_A atau tombol terkait gamepad lainnya, maka perangkat tersebut dianggap memiliki gamepad.

Persyaratan driver keyboard

1. Driver keyboard hanya boleh mendaftarkan kode kunci untuk kunci yang benar-benar didukungnya. Mendaftarkan kode kunci berlebih dapat membingungkan algoritma klasifikasi perangkat atau menyebabkan sistem salah mendeteksi kemampuan keyboard yang didukung pada perangkat.

2. Driver keyboard harus menggunakan EV_KEY untuk melaporkan penekanan tombol, menggunakan nilai 0 untuk menunjukkan bahwa tombol dilepaskan, nilai 1 untuk menunjukkan bahwa tombol ditekan, dan nilai lebih besar dari atau sama dengan 2 untuk menunjukkan bahwa tombol tersebut ditekan. diulang secara otomatis.

3. Android melakukan pengulangan keyboardnya sendiri. Fungsionalitas pengulangan otomatis harus dinonaktifkan di driver.

4. Driver keyboard secara opsional dapat menunjukkan penggunaan HID atau kode pemindaian tingkat rendah dengan mengirimkan EV_MSC dengan MSC_SCANCODE dan nilai yang menunjukkan penggunaan atau kode pemindaian ketika tombol ditekan. Informasi ini saat ini tidak digunakan oleh Android.

5. Driver keyboard harus mendukung pengaturan status LED saat EV_LED ditulis ke perangkat. Driver hid-input menangani ini secara otomatis. Pada saat penulisan ini, Android menggunakan LED_CAPSLOCK , LED_SCROLLLOCK , dan LED_NUMLOCK . LED ini hanya perlu didukung bila keyboard benar-benar dilengkapi lampu indikator terkait.

6. Driver keyboard untuk keypad tertanam (misalnya, menggunakan matriks GPIO) harus memastikan untuk mengirimkan peristiwa EV_KEY dengan nilai 0 untuk setiap tombol yang masih ditekan saat perangkat akan tidur. Jika tidak, kunci mungkin akan macet dan akan berulang secara otomatis selamanya.

Pengoperasian papan ketik

Berikut rangkuman singkat pengoperasian keyboard di Android.

1. EventHub membaca peristiwa mentah dari driver evdev dan memetakan kode kunci Linux (terkadang disebut sebagai kode pindaian) ke dalam kode kunci Android menggunakan peta tata letak tombol keyboard.

2. InputReader menggunakan peristiwa mentah dan memperbarui status kunci meta. Misalnya, jika tombol shift kiri ditekan atau dilepaskan, pembaca akan mengatur atau mereset bit META_SHIFT_LEFT_ON dan META_SHIFT_ON .

3. InputReader memberi tahu InputDispatcher tentang peristiwa penting.

4. InputDispatcher menanyakan WindowManagerPolicy apa yang harus dilakukan dengan peristiwa penting dengan memanggil WindowManagerPolicy.interceptKeyBeforeQueueing . Metode ini merupakan bagian dari jalur kritis yang bertanggung jawab untuk membangunkan perangkat ketika tombol tertentu ditekan. EventHub secara efektif menahan penguncian layar saat aktif di sepanjang jalur kritis ini untuk memastikan bahwa jalur tersebut akan berjalan hingga selesai.

5. Jika InputFilter sedang digunakan, InputDispatcher memberinya kesempatan untuk menggunakan atau mengubah kunci. InputFilter dapat digunakan untuk menerapkan kebijakan aksesibilitas tingkat rendah di seluruh sistem.

6. InputDispatcher mengantrekan kunci untuk diproses pada thread pengiriman.

7. Ketika InputDispatcher mengeluarkan kunci, hal ini memberikan WindowManagerPolicy kesempatan kedua untuk mencegat peristiwa kunci dengan memanggil WindowManagerPolicy.interceptKeyBeforeDispatching . Metode ini menangani pintasan sistem dan fungsi lainnya.

8. InputDispatcher kemudian mengidentifikasi target peristiwa utama (jendela fokus) dan menunggu hingga target tersebut siap. Kemudian, InputDispatcher mengirimkan peristiwa penting ke aplikasi.

9. Di dalam aplikasi, peristiwa kunci menyebar ke bawah hierarki tampilan ke tampilan terfokus untuk pengiriman kunci pra-IME.

10. Jika peristiwa utama tidak ditangani dalam pengiriman pra-IME dan IME sedang digunakan, peristiwa utama dikirimkan ke IME.

11. Jika peristiwa utama tidak digunakan oleh IME, maka peristiwa utama tersebut akan menyebar ke bawah hierarki tampilan ke tampilan terfokus untuk pengiriman kunci standar.

12. Aplikasi melaporkan kembali ke InputDispatcher apakah peristiwa penting telah digunakan. Jika peristiwa tidak digunakan, InputDispatcher memanggil WindowManagerPolicy.dispatchUnhandledKey untuk menerapkan perilaku "fallback". Bergantung pada tindakan fallback, siklus pengiriman kejadian penting dapat dimulai ulang menggunakan kode kunci yang berbeda. Misalnya, jika aplikasi tidak menangani KEYCODE_ESCAPE , sistem mungkin mengirim ulang peristiwa kunci sebagai KEYCODE_BACK .

Konfigurasi papan ketik

Perilaku keyboard ditentukan oleh tata letak tombol keyboard, peta karakter tombol, dan konfigurasi perangkat input.

Lihat bagian berikut untuk rincian lebih lanjut tentang file yang berpartisipasi dalam konfigurasi keyboard:

• File tata letak kunci
• File peta karakter kunci
• File konfigurasi perangkat masukan

Properti

Properti konfigurasi perangkat input berikut digunakan untuk keyboard.

keyboard.tata letak

Definisi: keyboard.layout = <nama>

Menentukan nama file tata letak kunci yang terkait dengan perangkat input, tidak termasuk ekstensi .kl . Jika file ini tidak ditemukan, sistem input akan menggunakan tata letak kunci default.

Spasi pada nama diubah menjadi garis bawah selama pencarian.

Lihat dokumentasi file tata letak kunci untuk detail selengkapnya.

keyboard.characterMap

Definisi: keyboard.characterMap = <nama>

Menentukan nama file peta karakter kunci yang terkait dengan perangkat input, tidak termasuk ekstensi .kcm . Jika file ini tidak ditemukan, sistem input akan menggunakan peta karakter kunci default.

Spasi pada nama diubah menjadi garis bawah selama pencarian.

Lihat dokumentasi file peta karakter kunci untuk lebih jelasnya.

keyboard.orientationAware

Definisi: keyboard.orientationAware = 0 | 1

Menentukan apakah keyboard harus bereaksi terhadap perubahan orientasi tampilan.

• Jika nilainya 1 , tombol arah akan diputar ketika orientasi tampilan terkait berubah.

• Jika nilainya 0 , keyboard kebal terhadap perubahan orientasi tampilan.

Nilai defaultnya adalah 0 .

Kesadaran orientasi digunakan untuk mendukung perputaran tombol arah, seperti pada Motorola Droid. Misalnya, saat perangkat diputar searah jarum jam 90 derajat dari orientasi aslinya, KEYCODE_DPAD_UP dipetakan ulang untuk menghasilkan KEYCODE_DPAD_RIGHT karena tombol 'atas' akhirnya mengarah ke 'kanan' saat perangkat dipegang dalam orientasi tersebut.

keyboard.bawaan

Definisi: keyboard.builtIn = 0 | 1

Menentukan apakah keyboard merupakan keyboard internal (terpasang secara fisik).

Nilai defaultnya adalah 1 jika nama perangkat diakhiri dengan -keypad , 0 jika tidak.

Keyboard internal selalu diberi id perangkat 0 . Papan ketik lain yang bukan bawaan diberi id perangkat unik yang bukan nol.

Menggunakan id 0 untuk keyboard internal penting untuk menjaga kompatibilitas dengan bidang KeyCharacterMap.BUILT_IN_KEYBOARD , yang menentukan id keyboard internal dan memiliki nilai 0 . Bidang ini sudah tidak digunakan lagi di API tetapi aplikasi lama mungkin masih menggunakannya.

Keyboard dengan fungsi khusus (yang peta karakter kuncinya menentukan jenis SPECIAL_FUNCTION ) tidak akan pernah didaftarkan sebagai keyboard internal, apa pun pengaturan properti ini. Hal ini karena keyboard dengan fungsi khusus menurut definisinya tidak dimaksudkan untuk digunakan untuk pengetikan umum.

Contoh konfigurasi

# 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

Catatan kompatibilitas

Sebelum Honeycomb, pemeta masukan keyboard tidak menggunakan properti konfigurasi apa pun. Semua keyboard diasumsikan terpasang secara fisik dan sadar orientasi. Tata letak kunci default dan peta karakter kunci diberi nama qwerty , bukan Generic . Format peta karakter kunci juga sangat berbeda dan kerangka kerjanya tidak mendukung keyboard lengkap bergaya PC atau keyboard eksternal.

Saat memutakhirkan perangkat ke Honeycomb, pastikan untuk membuat atau memperbarui konfigurasi dan file peta utama yang diperlukan.

Penggunaan HID, kode kunci Linux, dan kode kunci Android

Sistem merujuk ke kunci menggunakan beberapa pengidentifikasi berbeda, bergantung pada lapisan abstraksi.

Untuk perangkat HID, setiap kunci memiliki penggunaan HID terkait. Driver hid-input Linux dan vendor terkait serta driver HID khusus perangkat bertanggung jawab untuk mengurai laporan HID dan memetakan penggunaan HID ke kode kunci Linux.

Saat Android membaca peristiwa EV_KEY dari kernel Linux, Android menerjemahkan setiap kode kunci Linux ke dalam kode kunci Android yang sesuai sesuai dengan file tata letak kunci perangkat.

Saat peristiwa kunci dikirim ke aplikasi, instance android.view.KeyEvent melaporkan kode kunci Linux sebagai nilai getScanCode() dan kode kunci Android sebagai nilai getKeyCode() . Untuk keperluan kerangka kerja, hanya nilai getKeyCode() yang penting.

Perlu diperhatikan bahwa informasi penggunaan HID tidak digunakan oleh Android itu sendiri atau diteruskan ke aplikasi.

Tabel kode

Tabel berikut menunjukkan keterkaitan penggunaan HID, kode kunci Linux, dan kode kunci Android.

Kolom LKC menentukan kode kunci Linux dalam heksadesimal.

Kolom AKC menentukan kode kunci Android dalam heksadesimal.

Kolom Catatan mengacu pada catatan yang diposting setelah tabel.

Kolom Versi menentukan versi pertama platform Android yang menyertakan kunci ini dalam peta kunci defaultnya. Beberapa baris ditampilkan jika peta kunci default telah berubah antar versi. Versi tertua yang ditunjukkan adalah 1.6.

• Di Gingerbread (2.3) dan rilis sebelumnya, peta kunci default adalah qwerty.kl . Peta kunci ini hanya ditujukan untuk digunakan dengan Android Emulator dan tidak dimaksudkan untuk digunakan untuk mendukung keyboard eksternal sembarangan. Namun demikian, beberapa OEM menambahkan dukungan keyboard Bluetooth ke platform dan mengandalkan qwerty.kl untuk menyediakan pemetaan keyboard yang diperlukan. Oleh karena itu, pemetaan lama ini mungkin menarik bagi OEM yang sedang membangun periferal untuk perangkat khusus ini. Perhatikan bahwa pemetaannya sangat berbeda dari pemetaan saat ini, khususnya yang berkaitan dengan perlakuan terhadap kunci HOME . Direkomendasikan agar semua periferal baru dikembangkan sesuai dengan Honeycomb atau peta kunci yang lebih baru (misalnya HID standar).

• Pada Honeycomb (3.0), peta kunci default adalah Generic.kl . Peta kunci ini dirancang untuk mendukung keyboard gaya PC lengkap. Sebagian besar fungsionalitas keyboard HID standar seharusnya langsung berfungsi.

Pemetaan kode kunci mungkin berbeda antar versi kernel Linux dan Android. Jika perubahan diketahui telah terjadi pada peta kunci default Android, perubahan tersebut akan ditunjukkan di kolom versi.

Driver HID dan peta kunci khusus perangkat mungkin menerapkan pemetaan berbeda dari yang ditunjukkan di sini.

Halaman keyboard dan keypad HID (0x07)

Halaman desktop generik HID (0x01)

Halaman konsumen HID (0x0c)

Pemetaan non-hidangan tambahan

Pemetaan ini menggambarkan fungsi yang tidak muncul dalam HID tetapi untuk mana kode kunci Linux ada.

Kunci warisan yang tidak didukung

Pemetaan ini muncul di versi Android sebelumnya tetapi tidak konsisten dengan HID atau kode kunci Linux non-standar yang digunakan. Mereka tidak lagi didukung.

Catatan

1. Kode kunci Android yang terkait dengan tombol alfanumerik dan simbolis umum dapat bervariasi berdasarkan tata letak dan bahasa keyboard. Untuk alasan historis, kode pemindaian fisik dan penggunaan HID yang terkait dengan kunci pada keyboard sering didefinisikan secara posisi meskipun label yang dicetak pada kunci tersebut dapat bervariasi dari satu bahasa ke bahasa lain.

   Pada keyboard US English (QWERTY), kunci alfabet kiri atas diberi label Q. Pada keyboard Prancis (Azerty), kunci dalam posisi yang sama diberi label A. Meskipun label, pada kedua keyboard kunci alfabet kiri atas-kiri dirujuk menggunakan penggunaan HID 0x07 0x0014 yang dipetakan ke kode kunci Linux key_q.

   Saat Android dikonfigurasi dengan tata letak keyboard bahasa Inggris AS, maka kode kunci Linux key_q akan dipetakan ke Kunci Kunci Android KeyCode_Q dan akan menghasilkan karakter 'Q' dan 'Q'. Namun, ketika Android dikonfigurasi dengan tata letak keyboard Prancis, maka kode kunci Linux key_q akan dipetakan ke Keycode Kode Kunci Android dan akan menghasilkan karakter 'A' dan 'A'.

   Kode kunci Android biasanya mencerminkan interpretasi kunci spesifik bahasa, sehingga kode kunci Android yang berbeda dapat digunakan untuk berbagai bahasa.

2. 0x0c 0x022f AC Zoom didefinisikan dalam HID sebagai kontrol linier tetapi kernel memetakannya sebagai kunci, yang mungkin salah.

3. Kunci fungsi linux KEY_FN_* dipetakan ke kode kunci yang lebih sederhana tetapi dikirim dengan META_FUNCTION state state bit diatur ke true.

4. Sebelum ke Android Ice Cream Sandwich 4.0, tata letak kunci default berisi pemetaan untuk beberapa kode kunci tambahan yang tidak didefinisikan dalam header kernel Linux utama. Pemetaan ini telah dihapus karena kode -kode kunci yang sebelumnya tidak ditentukan ini telah diberi makna yang berbeda dalam versi yang lebih baru dari kernel Linux.

Sumber

1. Tabel Penggunaan USB HID v1.12
2. Linux 2.6.39 Kernel: Sertakan/linux/input.h, driver/HID/HID-INPUT.C
3. Android ICS: qwerty.kl, generic.kl, keyevent.java