Perangkat keyboard

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

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

Klasifikasi keyboard

Perangkat input diklasifikasikan sebagai keyboard jika salah satu kondisi berikut berlaku:

• Perangkat input melaporkan keberadaan kode tombol Linux yang digunakan di keyboard termasuk 0 hingga 0xff atau KEY_OK hingga KEY_MAX.

• Perangkat input melaporkan keberadaan kode tombol Linux 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. Dengan demikian, joystick dan gamepad juga menggunakan file peta tombol untuk konfigurasi.

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

Sistem kemudian mencoba menentukan karakteristik tambahan perangkat.

• Jika perangkat input memiliki tombol yang dipetakan ke KEYCODE_Q, perangkat dianggap memiliki keypad alfabet (bukan numerik). Kemampuan keypad alfabet dilaporkan dalam objek Configuration resource sebagai KEYBOARD_QWERTY.

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

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

Persyaratan driver keyboard

1. Driver keyboard hanya boleh mendaftarkan kode kunci untuk kunci yang benar-benar didukung. Mendaftarkan kode kunci yang berlebihan dapat membingungkan algoritma klasifikasi perangkat atau menyebabkan sistem salah mendeteksi kemampuan keyboard yang didukung 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 yang lebih besar dari atau sama dengan 2 untuk menunjukkan bahwa tombol diulang secara otomatis.

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

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

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

6. Driver keyboard untuk keypad tersemat (misalnya, menggunakan matriks GPIO) harus memastikan untuk mengirim peristiwa EV_KEY dengan nilai 0 untuk tombol apa pun yang masih ditekan saat perangkat akan tidur. Jika tidak, tombol mungkin akan tertekan dan akan otomatis diulang selamanya.

Operasi keyboard

Berikut adalah ringkasan singkat tentang operasi keyboard di Android.

1. EventHub membaca peristiwa mentah dari driver evdev dan memetakan kode tombol Linux (terkadang disebut sebagai kode pemindaian) ke dalam kode tombol 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 menetapkan atau mereset bit META_SHIFT_LEFT_ON dan META_SHIFT_ON sebagaimana mestinya.

3. InputReader memberi tahu InputDispatcher tentang peristiwa utama.

4. InputDispatcher menanyakan kepada WindowManagerPolicy apa yang harus dilakukan dengan peristiwa tombol dengan memanggil WindowManagerPolicy.interceptKeyBeforeQueueing. Metode ini adalah bagian dari jalur kritis yang bertanggung jawab untuk mengaktifkan perangkat saat tombol tertentu ditekan. EventHub secara efektif menahan wake lock di sepanjang jalur kritis ini untuk memastikan bahwa wake lock akan berjalan hingga selesai.

5. Jika InputFilter saat ini sedang digunakan, InputDispatcher akan 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 di thread pengiriman.

7. Saat InputDispatcher menghapus kunci dari antrean, tindakan ini memberi WindowManagerPolicy kesempatan kedua untuk mencegat peristiwa utama dengan memanggil WindowManagerPolicy.interceptKeyBeforeDispatching. Metode ini menangani pintasan sistem dan fungsi lainnya.

8. InputDispatcher kemudian mengidentifikasi target peristiwa utama (jendela yang difokuskan) dan menunggunya siap. Kemudian, InputDispatcher mengirimkan peristiwa utama ke aplikasi.

9. Di dalam aplikasi, peristiwa tombol akan menyebar ke bawah hierarki tampilan ke tampilan yang difokuskan untuk pengiriman tombol pra-IME.

10. Jika peristiwa tombol tidak ditangani dalam pengiriman pra-IME dan IME sedang digunakan, peristiwa tombol akan dikirim ke IME.

11. Jika peristiwa tombol tidak digunakan oleh IME, peristiwa tombol akan disebarkan ke bawah hierarki tampilan ke tampilan yang difokuskan untuk pengiriman tombol standar.

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

Konfigurasi keyboard

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

Lihat bagian berikut untuk mengetahui detail selengkapnya tentang file yang berpartisipasi dalam konfigurasi keyboard:

• File tata letak kunci
• File peta karakter utama
• File konfigurasi perangkat input

Properti

Properti konfigurasi perangkat input berikut digunakan untuk keyboard.

keyboard.layout

Definisi: keyboard.layout = <name>

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 tombol default.

Spasi dalam nama dikonversi menjadi garis bawah selama pencarian.

Lihat dokumentasi file tata letak kunci untuk mengetahui detail selengkapnya.

keyboard.characterMap

Definisi: keyboard.characterMap = <name>

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 dalam nama dikonversi menjadi garis bawah selama pencarian.

Lihat dokumentasi file peta karakter kunci untuk mengetahui detail selengkapnya.

keyboard.orientationAware

Definisi: keyboard.orientationAware = 0 | 1

Menentukan apakah keyboard harus bereaksi terhadap perubahan orientasi layar.

• Jika nilainya 1, tombol keypad arah akan diputar saat orientasi layar terkait berubah.

• Jika nilainya 0, keyboard tidak akan terpengaruh oleh perubahan orientasi tampilan.

Nilai default-nya adalah 0.

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

keyboard.builtIn

Definisi: keyboard.builtIn = 0 | 1

Menentukan apakah keyboard adalah keyboard bawaan (terpasang secara fisik).

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

Keyboard bawaan selalu diberi ID perangkat 0. Keyboard lain yang tidak bawaan diberi ID perangkat unik yang bukan nol.

Menggunakan ID 0 untuk keyboard bawaan penting untuk mempertahankan kompatibilitas dengan kolom KeyCharacterMap.BUILT_IN_KEYBOARD, yang menentukan ID keyboard bawaan dan memiliki nilai 0. Kolom ini sudah tidak digunakan lagi di API, tetapi aplikasi lama mungkin masih menggunakannya.

Keyboard fungsi khusus (keyboard yang peta karakter kuncinya menentukan jenis SPECIAL_FUNCTION) tidak akan pernah terdaftar sebagai keyboard bawaan, terlepas dari setelan properti ini. Hal ini karena keyboard fungsi khusus menurut definisi tidak dimaksudkan untuk digunakan untuk pengetikan tujuan 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, pemetaan input keyboard tidak menggunakan properti konfigurasi apa pun. Semua keyboard diasumsikan terpasang secara fisik dan mengetahui orientasi. Tata letak kunci dan peta karakter kunci default diberi nama qwerty, bukan Generic. Format peta karakter kunci juga sangat berbeda dan framework tidak mendukung keyboard penuh bergaya PC atau keyboard eksternal.

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

Penggunaan HID, kode kunci Linux, dan kode kunci Android

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

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

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

Saat peristiwa utama dikirim ke aplikasi, instance android.view.KeyEvent akan melaporkan kode tombol Linux sebagai nilai getScanCode() dan kode tombol Android sebagai nilai getKeyCode(). Untuk tujuan framework, hanya nilai getKeyCode() yang penting.

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

Tabel kode

Tabel berikut menunjukkan hubungan antara penggunaan HID, kode tombol Linux, dan kode tombol 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 Version menentukan versi pertama platform Android yang menyertakan kunci ini dalam peta kunci defaultnya. Beberapa baris ditampilkan jika peta tombol default telah berubah di antara versi. Versi tertua yang ditunjukkan adalah 1.6.

• Pada rilis Gingerbread (2.3) dan yang lebih lama, peta tombol default adalah qwerty.kl. Peta tombol ini hanya dimaksudkan untuk digunakan dengan Android Emulator dan tidak dimaksudkan untuk digunakan untuk mendukung keyboard eksternal arbitrer. Namun, 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 membuat periferal untuk perangkat tertentu ini. Perhatikan bahwa pemetaan secara substansial berbeda dengan pemetaan saat ini, terutama sehubungan dengan perlakuan kunci HOME. Sebaiknya semua periferal baru dikembangkan sesuai dengan Honeycomb atau peta tombol terbaru (yaitu HID standar).

• Mulai Honeycomb (3.0), peta kunci default adalah Generic.kl. Peta tombol ini dirancang untuk mendukung keyboard gaya PC lengkap. Sebagian besar fungsi keyboard HID standar akan berfungsi secara langsung.

Konfigurasi kode kunci dapat bervariasi di seluruh versi kernel Linux dan Android. Jika diketahui bahwa perubahan telah terjadi pada peta tombol default Android, perubahan tersebut akan ditunjukkan di kolom versi.

Driver HID dan peta tombol khusus perangkat dapat menerapkan pemetaan yang berbeda dari yang ditunjukkan di sini.

Halaman keyboard dan keypad HID (0x07)

Halaman desktop umum HID (0x01)

Halaman konsumen HID (0x0c)

Pemetaan non-HID tambahan

Pemetaan ini menjelaskan fungsi yang tidak muncul di HID, tetapi kode kunci Linux ada.

Kunci lama yang tidak didukung

Pemetaan ini muncul di versi Android sebelumnya, tetapi tidak konsisten dengan HID atau menggunakan kode kunci Linux non-standar. Kasus penggunaan ini tidak lagi didukung.

Catatan

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

   Pada keyboard bahasa Inggris AS (QWERTY), tombol alfabet kiri atas berlabel Q. Pada keyboard bahasa Prancis (AZERTY), tombol dalam posisi yang sama berlabel A. Meskipun labelnya berbeda, pada kedua keyboard, kunci alfabet kiri atas dirujuk menggunakan penggunaan HID 0x07 0x0014 yang dipetakan ke kode kunci Linux KEY_Q.

   Jika Android dikonfigurasi dengan tata letak keyboard Inggris Amerika Serikat, kode tombol Linux KEY_Q akan dipetakan ke kode tombol Android KEYCODE_Q dan akan menghasilkan karakter 'Q' dan 'q'. Namun, jika Android dikonfigurasi dengan tata letak keyboard Prancis, kode tombol Linux KEY_Q akan dipetakan ke kode tombol Android KEYCODE_A dan akan menghasilkan karakter 'A' dan 'a'.

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

2. 0x0c 0x022f AC Zoom ditentukan dalam HID sebagai kontrol linear, tetapi kernel memetakan sebagai kunci, yang mungkin salah.

3. Tombol fungsi Linux KEY_FN_* dipetakan ke kode kunci yang lebih sederhana, tetapi dikirim dengan bit status meta META_FUNCTION ditetapkan ke benar.

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

Sumber

1. Tabel Penggunaan USB HID v1.12
2. Kernel Linux 2.6.39: include/linux/input.h, drivers/hid/hid-input.c
3. Android ICS: qwerty.kl, Generic.kl, KeyEvent.java