Perangkat sentuh

Android mendukung berbagai layar sentuh dan touchpad, termasuk tablet digitizer berbasis stilus.

Layar sentuh adalah perangkat sentuh yang dikaitkan dengan layar sehingga pengguna memiliki kesan bahwa mereka langsung memanipulasi item di layar.

Panel sentuh adalah perangkat sentuh yang tidak terkait dengan layar, seperti tablet digitizer. Panel sentuh biasanya digunakan untuk menunjuk atau untuk pemosisi tidak langsung absolut atau kontrol berbasis gestur antarmuka pengguna.

Perangkat sentuh dapat memiliki tombol yang fungsinya mirip dengan tombol mouse.

Perangkat sentuh terkadang dapat dimanipulasi menggunakan berbagai alat seperti jari atau stilus, bergantung pada teknologi sensor sentuh yang mendasarinya.

Perangkat sentuh terkadang digunakan untuk menerapkan tombol virtual. Misalnya, di beberapa perangkat Android, area sensor layar sentuh meluas di luar tepi layar dan berfungsi ganda sebagai bagian dari keypad sensitif sentuh.

Karena banyaknya variasi perangkat sentuh, Android mengandalkan sejumlah besar properti konfigurasi untuk mendeskripsikan karakteristik dan perilaku yang diinginkan dari setiap perangkat.

Klasifikasi perangkat sentuh

Perangkat input diklasifikasikan sebagai perangkat multi-sentuh jika kedua kondisi berikut terpenuhi:

  • Perangkat input melaporkan keberadaan sumbu absolut ABS_MT_POSITION_X dan ABS_MT_POSITION_Y.
  • Perangkat input tidak memiliki tombol gamepad. Kondisi ini menyelesaikan ambiguitas dengan gamepad tertentu yang melaporkan sumbu dengan kode yang tumpang-tindih dengan sumbu MT.

Perangkat input diklasifikasikan sebagai perangkat sentuhan tunggal jika kedua kondisi berikut terpenuhi:

  • Perangkat input tidak diklasifikasikan sebagai perangkat multi-sentuh. Perangkat input diklasifikasikan sebagai perangkat sentuh tunggal atau sebagai perangkat multi-sentuh, tidak pernah keduanya.
  • Perangkat input melaporkan keberadaan sumbu absolut ABS_X dan ABS_Y, serta keberadaan kode kunci BTN_TOUCH.

Saat perangkat input diklasifikasikan sebagai perangkat sentuh, keberadaan tombol virtual ditentukan dengan mencoba memuat file peta tombol virtual untuk perangkat. Jika peta tombol virtual tersedia, file tata letak tombol untuk perangkat juga akan dimuat. Lihat [File peta tombol virtual](#virtual-key-map-files) untuk mengetahui informasi tentang lokasi dan format file ini.

Selanjutnya, sistem memuat file konfigurasi perangkat input untuk perangkat sentuh.

Semua perangkat sentuh bawaan harus memiliki file konfigurasi perangkat input. Jika tidak ada file konfigurasi perangkat input, sistem akan memilih konfigurasi default yang sesuai untuk periferal sentuh tujuan umum seperti layar sentuh HID USB atau Bluetooth eksternal atau touchpad. Setelan default ini tidak dirancang untuk layar sentuh bawaan dan dapat menyebabkan perilaku yang salah.

Setelah konfigurasi perangkat input dimuat, sistem akan mengklasifikasikan perangkat input sebagai perangkat layar sentuh, touchpad, atau pointer.

  • Perangkat layar sentuh digunakan untuk manipulasi langsung objek di layar. Pengguna langsung menyentuh layar, sehingga sistem tidak memerlukan kemampuan tambahan untuk menunjukkan objek yang dimanipulasi.
  • Perangkat touchpad digunakan untuk memberikan informasi pemosisian absolut kepada aplikasi tentang sentuhan di area sensor tertentu. Hal ini dapat berguna untuk tablet digitizer.
  • Perangkat pointer digunakan untuk manipulasi tidak langsung objek di layar menggunakan kursor. Jari ditafsirkan sebagai gestur pointer multi-sentuh. Alat lain, seperti stilus, ditafsirkan menggunakan posisi absolut. Lihat Gestur pointer multi-kontrol tidak langsung untuk mengetahui informasi selengkapnya.

Aturan berikut digunakan untuk mengklasifikasikan perangkat input sebagai layar sentuh, touchpad, atau perangkat pointer.

  • Jika properti touch.deviceType ditetapkan, jenis perangkat akan ditetapkan seperti yang ditunjukkan.
  • Jika perangkat input melaporkan keberadaan properti input INPUT_PROP_DIRECT (melalui ioctl EVIOCGPROP), jenis perangkat akan disetel ke layar sentuh. Kondisi ini mengasumsikan bahwa perangkat input langsung dihubungkan ke layar yang juga terhubung.
  • Jika perangkat input melaporkan keberadaan properti input INPUT_PROP_POINTER (melalui ioctl EVIOCGPROP), jenis perangkat akan disetel ke pointer.
  • Jika perangkat input melaporkan keberadaan sumbu relatif REL_X atau REL_Y, jenis perangkat akan disetel ke touchpad. Kondisi ini menyelesaikan ambiguitas untuk perangkat input yang terdiri dari mouse dan touchpad. Dalam hal ini, touchpad tidak digunakan untuk mengontrol kursor karena mouse sudah mengontrolnya.
  • Jika tidak, jenis perangkat ditetapkan ke pointer. Setelan default ini memastikan bahwa touchpad yang belum ditetapkan untuk tujuan khusus lainnya mengontrol pointer.

Tombol

Tombol adalah kontrol opsional yang dapat digunakan aplikasi untuk menjalankan fungsi tambahan. Tombol di perangkat sentuh berperilaku mirip dengan tombol mouse dan terutama digunakan dengan perangkat sentuh jenis pointer atau dengan stilus.

Tombol berikut didukung:

  • BTN_LEFT: Dipetakan ke MotionEvent.BUTTON_PRIMARY.
  • BTN_RIGHT: Dipetakan ke MotionEvent.BUTTON_SECONDARY.
  • BTN_MIDDLE: Dipetakan ke MotionEvent.BUTTON_MIDDLE.
  • BTN_BACK dan BTN_SIDE: Dipetakan ke MotionEvent.BUTTON_BACK. Menekan tombol ini juga menyintesis penekanan tombol dengan kode tombol KeyEvent.KEYCODE_BACK.
  • BTN_FORWARD dan BTN_EXTRA: Dipetakan ke MotionEvent.BUTTON_FORWARD. Menekan tombol ini juga menyintesis penekanan tombol dengan kode kunci KeyEvent.KEYCODE_FORWARD.
  • BTN_STYLUS: Dipetakan ke MotionEvent.BUTTON_SECONDARY.
  • BTN_STYLUS2: Dipetakan ke MotionEvent.BUTTON_TERTIARY.

Alat dan jenis alat

Alat adalah jari, stilus, atau alat lainnya yang digunakan untuk berinteraksi dengan perangkat sentuh. Beberapa perangkat sentuh dapat membedakan antara berbagai jenis alat.

Di tempat lain di Android, seperti di MotionEvent API, alat sering kali disebut sebagai pointer.

Jenis alat berikut didukung:

  • BTN_TOOL_FINGER dan MT_TOOL_FINGER: Dipetakan ke MotionEvent.TOOL_TYPE_FINGER.
  • BTN_TOOL_PEN dan MT_TOOL_PEN: Dipetakan ke MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_RUBBER: Dipetakan ke MotionEvent.TOOL_TYPE_ERASER.
  • BTN_TOOL_BRUSH: Dipetakan ke MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_PENCIL: Dipetakan ke MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_AIRBRUSH: Dipetakan ke MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_MOUSE: Dipetakan ke MotionEvent.TOOL_TYPE_MOUSE.
  • BTN_TOOL_LENS: Dipetakan ke MotionEvent.TOOL_TYPE_MOUSE.
  • BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP, dan BTN_TOOL_QUADTAP: Dipetakan ke MotionEvent.TOOL_TYPE_FINGER.

Alat pengarahan kursor versus alat sentuh

Alat dapat bersentuhan dengan perangkat sentuh atau berada dalam jangkauan dan melayang di atasnya. Tidak semua perangkat sentuh dapat mendeteksi kehadiran alat yang diarahkan ke atas perangkat sentuh. Alat yang memiliki kemampuan tersebut, seperti digitizer stilus berbasis RF, sering kali dapat mendeteksi saat alat berada dalam rentang terbatas digitizer.

Komponen InputReader membedakan alat sentuh dari alat kursor. Demikian pula, alat sentuh dan alat pengarahan kursor dilaporkan ke aplikasi dengan cara yang berbeda.

Alat sentuh dilaporkan ke aplikasi sebagai peristiwa sentuh menggunakan MotionEvent.ACTION_DOWN, MotionEvent.ACTION_MOVE, MotionEvent.ACTION_DOWN, MotionEvent.ACTION_POINTER_DOWN, dan MotionEvent.ACTION_POINTER_UP.

Alat pengarahan kursor dilaporkan ke aplikasi sebagai peristiwa gerakan umum menggunakan MotionEvent.ACTION_HOVER_ENTER, MotionEvent.ACTION_HOVER_MOVE, dan MotionEvent.ACTION_HOVER_EXIT.

Persyaratan driver perangkat sentuh

  • Driver perangkat sentuh hanya boleh mendaftarkan sumbu dan kode kunci untuk sumbu dan tombol yang didukungnya. Mendaftarkan sumbu atau kode kunci yang tidak didukung dapat membingungkan algoritma klasifikasi perangkat atau menyebabkan sistem salah mendeteksi kemampuan perangkat. Misalnya, jika perangkat melaporkan kode kunci BTN_TOUCH, sistem mengasumsikan bahwa BTN_TOUCH selalu digunakan untuk menunjukkan apakah alat menyentuh layar. Oleh karena itu, BTN_TOUCH tidak boleh digunakan untuk menunjukkan bahwa alat hanya berada dalam rentang dan melayang.
  • Perangkat sekali sentuh menggunakan peristiwa input Linux berikut:
    • ABS_X: (WAJIB) Melaporkan koordinat X alat.
    • ABS_Y: (WAJIB) Melaporkan koordinat Y alat.
    • ABS_PRESSURE: (opsional) Melaporkan tekanan fisik yang diterapkan ke ujung alat atau kekuatan sinyal kontak sentuh.
    • ABS_TOOL_WIDTH: (opsional) Melaporkan area atau lebar penampang kontak sentuh atau alat itu sendiri.
    • ABS_DISTANCE: (opsional) Melaporkan jarak alat dari permukaan perangkat sentuh.
    • ABS_TILT_X: (opsional) Melaporkan kemiringan alat dari permukaan perangkat sentuh di sepanjang sumbu X.
    • ABS_TILT_Y: (opsional) Melaporkan kemiringan alat dari permukaan perangkat sentuh di sepanjang sumbu Y.
    • BTN_TOUCH: (WAJIB) Menunjukkan apakah alat menyentuh perangkat.
    • BTN_LEFT, BTN_RIGHT, BTN_MIDDLE, BTN_BACK, BTN_SIDE, BTN_FORWARD, BTN_EXTRA, BTN_STYLUS, BTN_STYLUS2: (opsional) Status tombol laporan.
    • BTN_TOOL_FINGER, BTN_TOOL_PEN, BTN_TOOL_RUBBER, BTN_TOOL_BRUSH, BTN_TOOL_PENCIL, BTN_TOOL_AIRBRUSH, BTN_TOOL_MOUSE, BTN_TOOL_LENS, BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP, BTN_TOOL_QUADTAP: (opsional) Melaporkan jenis alat.
  • Perangkat multi-sentuh menggunakan peristiwa input Linux berikut:
    • ABS_MT_POSITION_X: (WAJIB) Melaporkan koordinat X alat.
    • ABS_MT_POSITION_Y: (WAJIB) Melaporkan koordinat Y alat.
    • ABS_MT_PRESSURE: (opsional) Melaporkan tekanan fisik yang diterapkan ke ujung alat atau kekuatan sinyal kontak sentuh.
    • ABS_MT_TOUCH_MAJOR: (opsional) Melaporkan area penampang kontak sentuh, atau panjang dimensi kontak sentuh yang lebih panjang.
    • ABS_MT_TOUCH_MINOR: (opsional) Melaporkan panjang dimensi yang lebih pendek dari kontak sentuh. Sumbu ini tidak boleh digunakan jika ABS_MT_TOUCH_MAJOR melaporkan pengukuran area.
    • ABS_MT_WIDTH_MAJOR: (opsional) Melaporkan area penampang alat itu sendiri, atau panjang dimensi yang lebih panjang dari alat itu sendiri. Jangan gunakan sumbu ini kecuali jika Anda mengetahui dimensi alat itu sendiri.
    • ABS_MT_WIDTH_MINOR: (opsional) Melaporkan panjang dimensi yang lebih pendek dari alat itu sendiri. Sumbu ini tidak boleh digunakan jika ABS_MT_WIDTH_MAJOR melaporkan pengukuran area atau jika dimensi alat itu sendiri tidak diketahui.
    • ABS_MT_ORIENTATION: (opsional) Melaporkan orientasi alat.
    • ABS_MT_DISTANCE: (opsional) Melaporkan jarak alat dari permukaan perangkat sentuh.
    • ABS_MT_TOOL_TYPE: (opsional) Melaporkan jenis alat sebagai MT_TOOL_FINGER atau MT_TOOL_PEN.
    • ABS_MT_TRACKING_ID: (opsional) Melaporkan ID pelacakan alat. ID pelacakan adalah bilangan bulat non-negatif arbitrer yang digunakan untuk mengidentifikasi dan melacak setiap alat secara independen saat beberapa alat aktif. Misalnya, saat beberapa jari menyentuh perangkat, setiap jari harus diberi ID pelacakan yang berbeda yang digunakan selama jari tetap bersentuhan. ID pelacakan dapat digunakan kembali saat alat terkaitnya keluar dari jangkauan.
    • ABS_MT_SLOT: (opsional) Melaporkan ID slot alat, saat menggunakan protokol multi-sentuh Linux 'B'. Lihat dokumentasi protokol multi-sentuh Linux untuk mengetahui detail selengkapnya.
    • BTN_TOUCH: (WAJIB) Menunjukkan apakah alat menyentuh perangkat.
    • BTN_LEFT, BTN_RIGHT, BTN_MIDDLE, BTN_BACK, BTN_SIDE, BTN_FORWARD, BTN_EXTRA, BTN_STYLUS, BTN_STYLUS2: (opsional) Status tombol laporan.
    • BTN_TOOL_FINGER, BTN_TOOL_PEN, BTN_TOOL_RUBBER, BTN_TOOL_BRUSH, BTN_TOOL_PENCIL, BTN_TOOL_AIRBRUSH, BTN_TOOL_MOUSE, BTN_TOOL_LENS, BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP, BTN_TOOL_QUADTAP: (opsional) Melaporkan jenis alat.
  • Jika sumbu untuk protokol sentuh tunggal dan multi-sentuh ditentukan, hanya sumbu multi-sentuh yang digunakan dan sumbu sentuh tunggal akan diabaikan.

  • Nilai minimum dan maksimum sumbu ABS_X, ABS_Y, ABS_MT_POSITION_X, dan ABS_MT_POSITION_Y menentukan batas area aktif perangkat dalam unit platform khusus perangkat. Dalam kasus layar sentuh, area aktif menjelaskan bagian perangkat sentuh yang benar-benar menutupi layar.

    Untuk layar sentuh, sistem akan otomatis melakukan interpolasi posisi sentuhan yang dilaporkan dalam satuan platform untuk mendapatkan posisi sentuhan dalam piksel layar sesuai dengan penghitungan berikut:

        displayX = (x - minX) * displayWidth / (maxX - minX + 1)
    displayY = (y - minY) * displayHeight / (maxY - minY + 1)

    Layar sentuh mungkin melaporkan sentuhan di luar area aktif yang dilaporkan.

    Sentuhan yang dimulai di luar area aktif tidak dikirim ke aplikasi, tetapi dapat digunakan untuk tombol virtual.

    Sentuhan yang dimulai di dalam area aktif, atau yang masuk dan keluar dari area tampilan akan dikirim ke aplikasi. Akibatnya, jika sentuhan dimulai dalam batas aplikasi, lalu dipindahkan ke luar area aktif, aplikasi mungkin menerima peristiwa sentuh dengan koordinat tampilan yang negatif atau di luar batas tampilan. Ini adalah perilaku yang diharapkan.

    Perangkat sentuh tidak boleh menyetel koordinat sentuh ke batas area aktif. Jika sentuhan keluar dari area aktif, sentuhan tersebut harus dilaporkan sebagai berada di luar area aktif, atau tidak boleh dilaporkan sama sekali.

    Misalnya, jika jari pengguna menyentuh di dekat sudut kiri atas layar sentuh, jari tersebut mungkin melaporkan koordinat (minX, minY). Jika jari terus bergerak lebih jauh di luar area aktif, layar sentuh harus mulai melaporkan koordinat dengan komponen kurang dari minX dan minY, seperti (minX - 2, minY - 3), atau harus berhenti melaporkan sentuhan sama sekali. Dengan kata lain, layar sentuh tidak boleh melaporkan (minX, minY) saat jari pengguna benar-benar menyentuh di luar area aktif.

    Membatasi koordinat sentuh ke tepi layar akan membuat batas keras buatan di sekitar tepi layar yang mencegah sistem melacak gerakan yang masuk atau keluar dari batas area tampilan dengan lancar.

  • Nilai yang dilaporkan oleh ABS_PRESSURE atau ABS_MT_PRESSURE, jika dilaporkan, harus bukan nol saat alat menyentuh perangkat dan nol jika tidak untuk menunjukkan bahwa alat sedang melayang.

    Melaporkan informasi tekanan bersifat opsional, tetapi sangat direkomendasikan. Aplikasi dapat menggunakan informasi tekanan untuk menerapkan gambar sensitif tekanan dan efek lainnya.

  • Nilai yang dilaporkan oleh ABS_TOOL_WIDTH, ABS_MT_TOUCH_MAJOR, ABS_MT_TOUCH_MINOR, ABS_MT_WIDTH_MAJOR, atau ABS_MT_WIDTH_MINOR harus bukan nol saat alat menyentuh perangkat dan nol jika tidak, tetapi ini tidak diperlukan. Misalnya, perangkat sentuh mungkin dapat mengukur ukuran kontak sentuhan jari, tetapi tidak dapat mengukur kontak sentuhan stilus.

    Informasi ukuran pelaporan bersifat opsional, tetapi sangat direkomendasikan. Aplikasi dapat menggunakan informasi tekanan untuk menerapkan gambar sensitif ukuran dan efek lainnya.

  • Nilai yang dilaporkan oleh ABS_DISTANCE atau ABS_MT_DISTANCE harus mendekati nol saat alat menyentuh perangkat. Jarak dapat tetap bukan nol bahkan saat alat bersentuhan langsung. Nilai yang tepat yang dilaporkan bergantung pada cara hardware mengukur jarak.

    Pelaporan informasi jarak bersifat opsional, tetapi direkomendasikan untuk perangkat stilus.

  • Nilai yang dilaporkan oleh ABS_TILT_X dan ABS_TILT_Y harus nol saat alat tegak lurus dengan perangkat. Kemiringan non-nol menunjukkan bahwa alat dipegang di tempat yang miring.

    Sudut kemiringan di sepanjang sumbu X dan Y diasumsikan ditentukan dalam derajat dari tegak lurus. Titik tengah (sempurna tegak lurus) diberikan oleh (max + min) / 2 untuk setiap sumbu. Nilai yang lebih kecil dari titik tengah mewakili kemiringan ke atas atau ke kiri, nilai yang lebih besar dari titik tengah mewakili kemiringan ke bawah atau ke kanan.

    InputReader mengonversi komponen kemiringan X dan Y menjadi sudut kemiringan tegak lurus yang berkisar dari 0 hingga PI / 2 radian dan sudut orientasi planar yang berkisar dari -PI hingga PI radian. Representasi ini menghasilkan deskripsi orientasi yang kompatibel dengan yang digunakan untuk menjelaskan sentuhan jari.

    Melaporkan informasi kemiringan bersifat opsional, tetapi direkomendasikan untuk perangkat stilus.

  • Jika jenis alat dilaporkan oleh ABS_MT_TOOL_TYPE, jenis alat tersebut akan menggantikan informasi jenis alat apa pun yang dilaporkan oleh BTN_TOOL_*. Jika tidak ada informasi jenis alat yang tersedia, jenis alat akan ditetapkan secara default ke MotionEvent.TOOL_TYPE_FINGER.

  • Alat ditentukan aktif berdasarkan kondisi berikut:

    • Saat menggunakan protokol sekali sentuh, alat akan aktif jika BTN_TOUCH, atau BTN_TOOL_* adalah 1.

      Kondisi ini menyiratkan bahwa InputReader harus memiliki setidaknya beberapa informasi tentang sifat alat, baik apakah alat tersebut menyentuh, atau setidaknya jenis alat. Jika tidak ada informasi yang tersedia, alat ini dianggap tidak aktif (keluar jangkauan).

    • Saat menggunakan protokol multi-sentuh 'A', alat ini aktif setiap kali muncul dalam laporan sinkronisasi terbaru. Jika alat berhenti muncul dalam laporan sinkronisasi, alat tersebut akan dihapus.
    • Saat menggunakan protokol multi-sentuh 'B', alat ini aktif selama memiliki slot aktif. Saat slotnya dihapus, alat tersebut akan berhenti ada.
  • Alat ditentukan untuk melayang berdasarkan kondisi berikut:
    • Jika alat adalah BTN_TOOL_MOUSE atau BTN_TOOL_LENS, alat tersebut tidak akan melayang, meskipun salah satu kondisi berikut terpenuhi.
    • Jika alat aktif dan driver melaporkan informasi tekanan, dan tekanan yang dilaporkan nol, alat akan melayang.
    • Jika alat aktif dan driver mendukung kode kunci BTN_TOUCH dan BTN_TOUCH memiliki nilai nol, alat akan melayang.
  • InputReader mendukung protokol multi-sentuh 'A' dan 'B'. Driver baru harus menggunakan protokol 'B', tetapi keduanya berfungsi.

  • Mulai Android 4.0, driver layar sentuh mungkin perlu diubah agar sesuai dengan spesifikasi protokol input Linux.

    Perubahan berikut mungkin diperlukan:

    • Jika alat menjadi tidak aktif (jari "naik"), alat tersebut akan berhenti muncul dalam laporan sinkronisasi multi-sentuh berikutnya. Saat semua alat menjadi tidak aktif (semua jari "naik"), driver harus mengirim paket laporan sinkronisasi kosong, seperti SYN_MT_REPORT diikuti dengan SYN_REPORT.

      Versi Android sebelumnya mengharapkan peristiwa "up" dilaporkan dengan mengirimkan nilai tekanan 0. Perilaku lama tidak kompatibel dengan spesifikasi protokol input Linux dan tidak lagi didukung.

    • Informasi tekanan fisik atau kekuatan sinyal harus dilaporkan menggunakan ABS_MT_PRESSURE.

      Versi Android sebelumnya mengambil informasi tekanan dari ABS_MT_TOUCH_MAJOR. Perilaku lama tidak kompatibel dengan spesifikasi protokol input Linux dan tidak lagi didukung.

    • Informasi ukuran sentuh harus dilaporkan menggunakan ABS_MT_TOUCH_MAJOR.

      Versi Android sebelumnya mengambil informasi ukuran dari ABS_MT_TOOL_MAJOR. Perilaku lama tidak kompatibel dengan spesifikasi protokol input Linux dan tidak lagi didukung.

    Driver perangkat sentuh tidak lagi memerlukan penyesuaian khusus Android. Dengan mengandalkan protokol input Linux standar, Android dapat mendukung berbagai periferal sentuh yang lebih luas, seperti layar sentuh multi-sentuh HID eksternal, menggunakan driver yang tidak dimodifikasi.

Operasi perangkat sentuh

Berikut adalah ringkasan singkat tentang operasi perangkat sentuh di Android.

  1. EventHub membaca peristiwa mentah dari driver evdev.
  2. InputReader menggunakan peristiwa mentah dan memperbarui status internal tentang posisi dan karakteristik lain dari setiap alat. Fungsi ini juga melacak status tombol.
  3. Jika KEMBALI atau MAJU ditekan atau dilepaskan, InputReader akan memberi tahu InputDispatcher tentang peristiwa utama.
  4. InputReader menentukan apakah penekanan tombol virtual terjadi. Jika ya, peristiwa tersebut akan memberi tahu InputDispatcher tentang peristiwa utama.
  5. InputReader menentukan apakah sentuhan dimulai dalam batas tampilan. Jika ya, peristiwa ini akan memberi tahu InputDispatcher tentang peristiwa sentuh.
  6. Jika tidak ada alat sentuh, tetapi ada setidaknya satu alat pengarahan kursor, InputReader akan memberi tahu InputDispatcher tentang peristiwa pengarahan kursor.
  7. Jika jenis perangkat sentuh adalah pointer, InputReader akan melakukan deteksi gestur pointer, memindahkan pointer dan titik yang sesuai, serta memberi tahu InputDispatcher tentang peristiwa pointer.
  8. InputDispatcher menggunakan WindowManagerPolicy untuk menentukan apakah peristiwa harus dikirim dan apakah peristiwa tersebut harus membangunkan perangkat. Kemudian, InputDispatcher mengirimkan peristiwa ke aplikasi yang sesuai.

Konfigurasi perangkat sentuh

Perilaku perangkat sentuh ditentukan oleh sumbu, tombol, properti input, konfigurasi perangkat input, peta tombol virtual, dan tata letak tombol perangkat.

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

Properti

Sistem ini mengandalkan banyak properti konfigurasi perangkat input untuk mengonfigurasi dan mengkalibrasi perilaku perangkat sentuh.

Salah satu alasannya adalah driver perangkat untuk perangkat sentuh sering melaporkan karakteristik sentuhan menggunakan unit khusus perangkat.

Misalnya, banyak perangkat sentuh mengukur area kontak sentuh menggunakan skala khusus perangkat internal, seperti jumlah total node sensor yang dipicu oleh sentuhan. Nilai ukuran mentah ini tidak akan bermakna bagi aplikasi karena aplikasi perlu mengetahui ukuran fisik dan karakteristik lain dari node sensor perangkat sentuh.

Sistem menggunakan parameter kalibrasi yang dienkode dalam file konfigurasi perangkat input untuk mendekode, mengubah, dan menormalisasi nilai yang dilaporkan oleh perangkat sentuh menjadi representasi standar yang lebih sederhana yang dapat dipahami aplikasi.

Konvensi dokumentasi

Untuk tujuan dokumentasi, kami menggunakan konvensi berikut untuk menjelaskan nilai yang digunakan oleh sistem selama proses kalibrasi.

Nilai sumbu mentah

Ekspresi berikut menunjukkan nilai mentah yang dilaporkan oleh driver perangkat sentuh sebagai peristiwa EV_ABS.

raw.x
Nilai sumbu ABS_X atau ABS_MT_POSITION_X.
raw.y
Nilai sumbu ABS_Y atau ABS_MT_POSITION_Y.
raw.pressure
Nilai sumbu ABS_PRESSURE atau ABS_MT_PRESSURE, atau 0 jika tidak tersedia.
raw.touchMajor
Nilai sumbu ABS_MT_TOUCH_MAJOR, atau 0 jika tidak tersedia.
raw.touchMinor
Nilai sumbu ABS_MT_TOUCH_MINOR, atau raw.touchMajor jika tidak tersedia.
raw.toolMajor
Nilai sumbu ABS_TOOL_WIDTH atau ABS_MT_WIDTH_MAJOR, atau 0 jika tidak tersedia.
raw.toolMinor
Nilai sumbu ABS_MT_WIDTH_MINOR, atau raw.toolMajor jika tidak tersedia.
raw.orientation
Nilai sumbu ABS_MT_ORIENTATION, atau 0 jika tidak tersedia.
raw.distance
Nilai sumbu ABS_DISTANCE atau ABS_MT_DISTANCE, atau 0 jika tidak tersedia.
raw.tiltX
Nilai sumbu ABS_TILT_X, atau 0 jika tidak tersedia.
raw.tiltY
Nilai sumbu ABS_TILT_Y, atau 0 jika tidak tersedia.

Rentang sumbu mentah

Ekspresi berikut menunjukkan batas nilai mentah. Nilai ini diperoleh dengan memanggil ioctl EVIOCGABS untuk setiap sumbu.

raw.*.min
Nilai minimum inklusif dari sumbu mentah.
raw.*.max
Nilai maksimum inklusif dari sumbu mentah.
raw.*.range
Setara dengan raw.*.max - raw.*.min.
raw.*.fuzz
Akurasi sumbu mentah. Misalnya, fuzz = 1 menyiratkan nilai akurat hingga +/- 1 unit.
raw.width
Lebar inklusif area sentuh, setara dengan raw.x.range + 1.
raw.height
Tinggi inklusif area sentuh, setara dengan raw.y.range + 1.

Rentang output

Ekspresi berikut menunjukkan karakteristik sistem koordinat output. Sistem menggunakan interpolasi linear untuk menerjemahkan informasi posisi sentuh dari unit platform yang digunakan oleh perangkat sentuh menjadi unit output yang dilaporkan ke aplikasi seperti piksel layar.

output.width
Lebar output. Untuk layar sentuh (dikaitkan dengan layar), ini adalah lebar layar dalam piksel. Untuk touchpad (tidak terkait dengan layar), lebar output sama dengan raw.width, yang menunjukkan bahwa tidak ada interpolasi yang dilakukan.
output.height
Tinggi output. Untuk layar sentuh (dikaitkan dengan layar), ini adalah tinggi layar dalam piksel. Untuk touchpad (tidak terkait dengan layar), tinggi output sama dengan raw.height, yang menunjukkan bahwa tidak ada interpolasi yang dilakukan.
output.diag
Panjang diagonal sistem koordinat output, setara dengan sqrt(output.width ^2 + output.height ^2).

Konfigurasi dasar

Pemetaan input sentuh menggunakan banyak properti konfigurasi dalam file konfigurasi perangkat input untuk menentukan nilai kalibrasi. Tabel berikut menjelaskan beberapa properti konfigurasi tujuan umum. Semua properti lainnya dijelaskan di bagian berikut beserta kolom yang digunakan untuk melakukan kalibrasi.

touch.deviceType

Definisi: touch.deviceType = touchScreen | touchPad | pointer | default

Menentukan jenis perangkat sentuh.

  • Jika nilainya touchScreen, perangkat sentuh adalah layar sentuh yang terkait dengan layar.

  • Jika nilainya touchPad, perangkat sentuh adalah touchpad yang tidak terkait dengan layar.

  • Jika nilainya pointer, perangkat sentuh adalah touchpad yang tidak terkait dengan layar, dan gerakannya digunakan untuk gestur pointer multi-sentuh tidak langsung.

  • Jika nilainya default, sistem akan otomatis mendeteksi jenis perangkat sesuai dengan algoritma klasifikasi.

Lihat bagian Klasifikasi untuk mengetahui detail selengkapnya tentang pengaruh jenis perangkat terhadap perilaku perangkat sentuh.

Di Android 3 dan yang lebih lama, semua perangkat sentuh dianggap sebagai layar sentuh.

touch.orientationAware

Definisi: touch.orientationAware = 0 | 1

Menentukan apakah perangkat sentuh harus bereaksi terhadap perubahan orientasi layar.

  • Jika nilainya 1, posisi sentuh yang dilaporkan oleh perangkat sentuh akan diputar setiap kali orientasi layar berubah.

  • Jika nilainya 0, posisi sentuh yang dilaporkan oleh perangkat sentuh tidak terpengaruh perubahan orientasi tampilan.

Nilai defaultnya adalah 1 jika perangkat adalah layar sentuh, 0 jika tidak.

Sistem membedakan antara layar sentuh dan layar internal dan eksternal. Layar sentuh internal yang mengetahui orientasi diputar berdasarkan orientasi layar internal. Layar sentuh eksternal yang peka orientasi diputar berdasarkan orientasi layar eksternal.

Kesadaran orientasi digunakan untuk mendukung rotasi layar sentuh di perangkat seperti Nexus One. Misalnya, saat perangkat diputar searah jarum jam 90 derajat dari orientasi alaminya, posisi absolut sentuhan akan dipetakan ulang sehingga sentuhan di sudut kiri atas sistem koordinat absolut layar sentuh dilaporkan sebagai sentuhan di sudut kiri atas sistem koordinat yang diputar layar. Hal ini dilakukan agar sentuhan dilaporkan dengan sistem koordinat yang sama dengan yang digunakan aplikasi untuk menggambar elemen visualnya.

Sebelum Honeycomb, semua perangkat sentuh diasumsikan mengetahui orientasi.

touch.gestureMode

Definisi: touch.gestureMode = pointer | spots | default

Menentukan mode presentasi untuk gestur pointer. Properti konfigurasi ini hanya relevan jika perangkat sentuh berjenis pointer.

  • Jika nilainya adalah pointer, gestur touchpad ditampilkan melalui kursor yang mirip dengan pointer mouse.

  • Jika nilainya adalah spots, gestur touchpad ditampilkan oleh anchor yang mewakili centroid gestur dan serangkaian titik melingkar yang mewakili posisi setiap jari.

Nilai defaultnya adalah pointer jika properti input INPUT_PROP_SEMI_MT ditetapkan, atau spots jika tidak.

Kolom X dan Y

Kolom X dan Y memberikan informasi posisi untuk pusat area kontak.

Perhitungan

Penghitungannya mudah: informasi posisi dari driver sentuh diinterpolasi secara linear ke sistem koordinat output.

xScale = output.width / raw.width
yScale = output.height / raw.height

If not orientation aware or screen rotation is 0 degrees:
output.x = (raw.x - raw.x.min) * xScale
output.y = (raw.y - raw.y.min) * yScale
Else If rotation is 90 degrees:
    output.x = (raw.y - raw.y.min) * yScale
    output.y = (raw.x.max - raw.x) * xScale
Else If rotation is 180 degrees:
    output.x = (raw.x.max - raw.x) * xScale
    output.y = (raw.y.max - raw.y) * yScale
Else If rotation is 270 degrees:
    output.x = (raw.y.max - raw.y) * yScale
    output.y = (raw.x - raw.x.min) * xScale
End If

Kolom touchMajor, touchMinor, toolMajor, toolMinor, size

Kolom touchMajor dan touchMinor menjelaskan perkiraan dimensi area kontak dalam unit output (piksel).

Kolom toolMajor dan toolMinor menjelaskan perkiraan dimensi alat itu sendiri dalam satuan output (piksel).

Kolom size menjelaskan ukuran sentuh yang dinormalisasi relatif terhadap sentuhan terbesar yang dapat dideteksi perangkat sentuh. Ukuran normal terkecil yang mungkin adalah 0,0 (tidak ada kontak, atau tidak dapat diukur), dan ukuran normal terbesar yang mungkin adalah 1,0 (area sensor jenuh).

Jika perkiraan panjang dan lebar dapat diukur, kolom touchMajor akan menentukan dimensi yang lebih panjang dan kolom touchMinor akan menentukan dimensi yang lebih pendek dari area kontak. Jika hanya perkiraan diameter area kontak yang dapat diukur, kolom touchMajor dan touchMinor akan sama.

Demikian pula, kolom toolMajor menentukan dimensi yang lebih panjang dan kolom toolMinor menentukan dimensi yang lebih pendek dari area penampang alat.

Jika ukuran sentuh tidak tersedia, tetapi ukuran alat tersedia, ukuran alat akan disetel sama dengan ukuran sentuh. Sebaliknya, jika ukuran alat tidak tersedia, tetapi ukuran sentuh tersedia, ukuran sentuh akan disetel sama dengan ukuran alat.

Perangkat sentuh mengukur atau melaporkan ukuran sentuh dan ukuran alat dengan berbagai cara. Implementasi saat ini mendukung tiga jenis pengukuran yang berbeda: diameter, area, dan kotak pembatas geometris dalam satuan permukaan.

Definisi: touch.size.calibration = none | geometric | diameter | area | default

Menentukan jenis pengukuran yang digunakan oleh driver sentuh untuk melaporkan ukuran sentuh dan ukuran alat.

  • Jika nilainya none, ukurannya ditetapkan ke nol.

  • Jika nilainya adalah geometric, ukuran diasumsikan ditentukan dalam unit platform yang sama dengan posisi, sehingga diskalakan dengan cara yang sama.

  • Jika nilainya adalah diameter, ukurannya diasumsikan sebanding dengan diameter (lebar) sentuhan atau alat.

  • Jika nilainya adalah area, ukurannya dianggap sebanding dengan area sentuhan atau alat.

  • Jika nilainya adalah default, sistem akan menggunakan kalibrasi geometric jika sumbu raw.touchMajor atau raw.toolMajor tersedia, jika tidak, sistem akan menggunakan kalibrasi none.

touch.size.scale

Definisi: touch.size.scale = <bilangan floating point non-negatif>

Menentukan faktor skala konstan yang digunakan dalam kalibrasi.

Nilai default-nya adalah 1.0.

touch.size.bias

Definisi: touch.size.bias = <bilangan floating point non-negatif>

Menentukan nilai bias konstan yang digunakan dalam kalibrasi.

Nilai default-nya adalah 0.0.

touch.size.isSummed

Definisi: touch.size.isSummed = 0 | 1

Menentukan apakah ukuran dilaporkan sebagai jumlah ukuran semua kontak aktif, atau dilaporkan satu per satu untuk setiap kontak.

  • Jika nilainya adalah 1, ukuran yang dilaporkan dibagi dengan jumlah kontak sebelum digunakan.

  • Jika nilainya adalah 0, ukuran yang dilaporkan akan digunakan apa adanya.

Nilai default-nya adalah 0.

Beberapa perangkat sentuh, terutama perangkat "Semi-MT", tidak dapat membedakan setiap dimensi dari beberapa kontak sehingga melaporkan pengukuran ukuran yang mewakili total area atau lebarnya. Properti ini hanya boleh ditetapkan ke 1 untuk perangkat tersebut. Jika ragu, tetapkan nilai ini ke 0.

Perhitungan

Penghitungan kolom touchMajor, touchMinor, toolMajor, toolMinor, dan size bergantung pada parameter kalibrasi yang ditentukan.

If raw.touchMajor and raw.toolMajor are available:
    touchMajor = raw.touchMajor
    touchMinor = raw.touchMinor
    toolMajor = raw.toolMajor
    toolMinor = raw.toolMinor
Else If raw.touchMajor is available:
    toolMajor = touchMajor = raw.touchMajor
    toolMinor = touchMinor = raw.touchMinor
Else If raw.toolMajor is available:
    touchMajor = toolMajor = raw.toolMajor
    touchMinor = toolMinor = raw.toolMinor
Else
    touchMajor = toolMajor = 0
    touchMinor = toolMinor = 0
    size = 0
End If

size = avg(touchMajor, touchMinor)

If touch.size.isSummed == 1:
    touchMajor = touchMajor / numberOfActiveContacts
    touchMinor = touchMinor / numberOfActiveContacts
    toolMajor = toolMajor / numberOfActiveContacts
    toolMinor = toolMinor / numberOfActiveContacts
    size = size / numberOfActiveContacts
End If

If touch.size.calibration == "none":
    touchMajor = toolMajor = 0
    touchMinor = toolMinor = 0
    size = 0
Else If touch.size.calibration == "geometric":
    outputScale = average(output.width / raw.width, output.height / raw.height)
    touchMajor = touchMajor * outputScale
    touchMinor = touchMinor * outputScale
    toolMajor = toolMajor * outputScale
    toolMinor = toolMinor * outputScale
Else If touch.size.calibration == "area":
    touchMajor = sqrt(touchMajor)
    touchMinor = touchMajor
    toolMajor = sqrt(toolMajor)
    toolMinor = toolMajor
Else If touch.size.calibration == "diameter":
    touchMinor = touchMajor
    toolMinor = toolMajor
End If

If touchMajor != 0:
    output.touchMajor = touchMajor * touch.size.scale + touch.size.bias
Else
    output.touchMajor = 0
End If

If touchMinor != 0:
    output.touchMinor = touchMinor * touch.size.scale + touch.size.bias
Else
    output.touchMinor = 0
End If

If toolMajor != 0:
    output.toolMajor = toolMajor * touch.size.scale + touch.size.bias
Else
    output.toolMajor = 0
End If

If toolMinor != 0:
    output.toolMinor = toolMinor * touch.size.scale + touch.size.bias
Else
    output.toolMinor = 0
End If

output.size = size

medan tekanan

Kolom pressure menjelaskan perkiraan tekanan fisik yang diterapkan ke perangkat sentuh sebagai nilai yang dinormalisasi antara 0,0 (tanpa sentuhan) dan 1,0 (tekanan normal).

Tekanan nol menunjukkan bahwa alat sedang diarahkan.

touch.pressure.calibration

Definisi: touch.pressure.calibration = none | physical | amplitude | default

Menentukan jenis pengukuran yang digunakan oleh driver sentuh untuk melaporkan tekanan.

  • Jika nilainya none, tekanan tidak diketahui sehingga ditetapkan ke 1,0 saat menyentuh dan 0,0 saat mengarahkan kursor.

  • Jika nilainya physical, sumbu tekanan diasumsikan untuk mengukur intensitas fisik tekanan yang sebenarnya diterapkan ke touchpad.

  • Jika nilainya amplitude, sumbu tekanan diasumsikan untuk mengukur amplitudo sinyal, yang terkait dengan ukuran kontak dan tekanan yang diterapkan.

  • Jika nilainya default, sistem akan menggunakan kalibrasi physical jika sumbu tekanan tersedia, jika tidak, gunakan none.

touch.pressure.scale

Definisi: touch.pressure.scale = <bilangan floating point non-negatif>

Menentukan faktor skala konstan yang digunakan dalam kalibrasi.

Nilai default-nya adalah 1.0 / raw.pressure.max.

Perhitungan

Perhitungan kolom pressure bergantung pada parameter kalibrasi yang ditentukan.

If touch.pressure.calibration == "physical" or "amplitude":
    output.pressure = raw.pressure * touch.pressure.scale
Else
    If hovering:
        output.pressure = 0
    Else
        output.pressure = 1
    End If
End If

kolom orientasi dan kemiringan

Kolom orientation menjelaskan orientasi sentuhan dan alat sebagai pengukuran sudut. Orientasi 0 menunjukkan bahwa sumbu utama berorientasi vertikal, -PI/2 menunjukkan bahwa sumbu utama berorientasi ke kiri, PI/2 menunjukkan bahwa sumbu utama berorientasi ke kanan. Jika alat stilus ada, rentang orientasi dapat dijelaskan dalam rentang lingkaran penuh dari -PI atau PI.

Kolom tilt menjelaskan kemiringan alat sebagai pengukuran sudut. Kemiringan 0 menunjukkan bahwa alat tegak lurus terhadap permukaan. Kemiringan PI/2 menunjukkan bahwa alat tersebut rata di permukaan.

touch.orientation.calibration

Definisi: touch.orientation.calibration = none | interpolated | vector | default

Menentukan jenis pengukuran yang digunakan oleh driver sentuh untuk melaporkan orientasi.

  • Jika nilainya none, orientasi tidak diketahui sehingga ditetapkan ke 0.
  • Jika nilainya adalah interpolated, orientasi akan diinterpolasi secara linear sehingga nilai mentah raw.orientation.min dipetakan ke -PI/2 dan nilai mentah raw.orientation.max dipetakan ke PI/2. Nilai tengah (raw.orientation.min + raw.orientation.max) / 2 dipetakan ke 0.
  • Jika nilainya vector, orientasi akan ditafsirkan sebagai vektor yang dikemas yang terdiri dari dua kolom 4-bit bertanda. Representasi ini digunakan pada bagian Protokol Berbasis Objek Atmel. Saat didekode, vektor menghasilkan sudut orientasi dan magnitudo keyakinan. Magnitudo keyakinan digunakan untuk menskalakan informasi ukuran, kecuali jika geometris.
  • Jika nilainya default, sistem akan menggunakan kalibrasi interpolated jika sumbu orientasi tersedia, jika tidak, gunakan none.

Perhitungan

Penghitungan kolom orientation dan tilt bergantung pada parameter kalibrasi yang ditentukan dan input yang tersedia.

If touch.tiltX and touch.tiltY are available:
    tiltXCenter = average(raw.tiltX.min, raw.tiltX.max)
    tiltYCenter = average(raw.tiltY.min, raw.tiltY.max)
    tiltXAngle = (raw.tiltX - tiltXCenter) * PI / 180
    tiltYAngle = (raw.tiltY - tiltYCenter) * PI / 180
    output.orientation = atan2(-sin(tiltXAngle), sinf(tiltYAngle))
    output.tilt = acos(cos(tiltXAngle) * cos(tiltYAngle))
Else If touch.orientation.calibration == "interpolated":
    center = average(raw.orientation.min, raw.orientation.max)
    output.orientation = PI / (raw.orientation.max - raw.orientation.min)
    output.tilt = 0
Else If touch.orientation.calibration == "vector":
    c1 = (raw.orientation & 0xF0) >> 4
    c2 = raw.orientation & 0x0F

    If c1 != 0 or c2 != 0:
        If c1 >= 8 Then c1 = c1 - 16
        If c2 >= 8 Then c2 = c2 - 16
        angle = atan2(c1, c2) / 2
        confidence = sqrt(c1*c1 + c2*c2)

        output.orientation = angle

        If touch.size.calibration == "diameter" or "area":
            scale = 1.0 + confidence / 16
            output.touchMajor *= scale
            output.touchMinor /= scale
            output.toolMajor *= scale
            output.toolMinor /= scale
        End If
    Else
        output.orientation = 0
    End If
    output.tilt = 0
Else
    output.orientation = 0
    output.tilt = 0
End If

If orientation aware:
    If screen rotation is 90 degrees:
        output.orientation = output.orientation - PI / 2
    Else If screen rotation is 270 degrees:
        output.orientation = output.orientation + PI / 2
    End If
End If

kolom jarak

Kolom distance menjelaskan jarak antara alat dan permukaan perangkat sentuh. Nilai 0,0 menunjukkan kontak langsung dan nilai yang lebih besar menunjukkan peningkatan jarak dari permukaan.

touch.distance.calibration

Definisi: touch.distance.calibration = none | scaled | default

Menentukan jenis pengukuran yang digunakan oleh driver sentuh untuk melaporkan jarak.

  • Jika nilainya none, jarak tidak diketahui sehingga ditetapkan ke 0.

  • Jika nilainya adalah scaled, jarak yang dilaporkan akan dikalikan dengan faktor skala konstan.

  • Jika nilainya default, sistem akan menggunakan kalibrasi scaled jika sumbu jarak tersedia, jika tidak, gunakan none.

touch.distance.scale

Definisi: touch.distance.scale = <bilangan floating point non-negatif>

Menentukan faktor skala konstan yang digunakan dalam kalibrasi.

Nilai default-nya adalah 1.0.

Perhitungan

Perhitungan kolom distance bergantung pada parameter kalibrasi yang ditentukan.

If touch.distance.calibration == "scaled":
    output.distance = raw.distance * touch.distance.scale
Else
    output.distance = 0
End If

Contoh

# Input device configuration file for a touch screen that supports pressure,
# size and orientation. The pressure and size scale factors were obtained
# by measuring the characteristics of the device itself and deriving
# useful approximations based on the resolution of the touch sensor and the
# display.
#
# Note that these parameters are specific to a particular device model.
# Different parameters need to be used for other devices.

# Basic Parameters
touch.deviceType = touchScreen
touch.orientationAware = 1

# Size
# Based on empirical measurements, we estimate the size of the contact
# using size = sqrt(area) * 28 + 0.
touch.size.calibration = area
touch.size.scale = 28
touch.size.bias = 0
touch.size.isSummed = 0

# Pressure
# Driver reports signal strength as pressure.
#
# A normal index finger touch typically registers about 80 signal strength
# units although we don't expect these values to be accurate.
touch.pressure.calibration = amplitude
touch.pressure.scale = 0.0125

# Orientation
touch.orientation.calibration = vector

Catatan kompatibilitas

Properti konfigurasi untuk perangkat sentuh berubah secara signifikan di Android Ice Cream Sandwich 4.0. Semua file konfigurasi perangkat input untuk perangkat sentuh harus diupdate untuk menggunakan properti konfigurasi baru.

Driver perangkat sentuh lama mungkin juga perlu diupdate.

File peta tombol virtual

Perangkat sentuh dapat digunakan untuk menerapkan tombol virtual.

Ada beberapa cara untuk melakukannya, bergantung pada kemampuan pengontrol sentuh. Beberapa pengontrol sentuh dapat dikonfigurasi secara langsung untuk menerapkan tombol virtual dengan menetapkan register firmware. Terkadang, sebaiknya Anda melakukan pemetaan dari koordinat sentuh ke kode kunci dalam software.

Saat kunci virtual diterapkan dalam software, kernel harus mengekspor file peta tombol virtual yang disebut virtualkeys.<devicename> sebagai properti board. Misalnya, jika driver perangkat layar sentuh melaporkan namanya sebagai "touchyfeely", file peta tombol virtual harus memiliki jalur /sys/board_properties/virtualkeys.touchyfeely.

File peta tombol virtual menjelaskan koordinat dan kode tombol Linux dari tombol virtual di layar sentuh.

Selain file peta tombol virtual, harus ada file tata letak tombol dan file peta karakter tombol yang sesuai untuk memetakan kode tombol Linux ke kode tombol Android dan untuk menentukan jenis perangkat keyboard (biasanya SPECIAL_FUNCTION).

Sintaksis

File peta tombol virtual adalah file teks biasa yang terdiri dari urutan deskripsi tata letak tombol virtual yang dipisahkan oleh baris baru atau titik dua.

Baris komentar dimulai dengan '#' dan berlanjut ke akhir baris.

Setiap kunci virtual dijelaskan oleh 6 komponen yang dipisahkan titik dua:

  • 0x01: Kode versi. Harus selalu 0x01.
  • <Linux key code>: Kode kunci Linux dari kunci virtual.
  • <centerX>: Koordinat piksel X dari pusat tombol virtual.
  • <centerY>: Koordinat piksel Y dari pusat tombol virtual.
  • <width>: Lebar tombol virtual dalam piksel.
  • <height>: Tinggi tombol virtual dalam piksel.

Semua koordinat dan ukuran ditentukan dalam hal sistem koordinat tampilan.

Berikut adalah file peta tombol virtual yang semuanya ditulis dalam satu baris.

# All on one line
0x01:158:55:835:90:55:0x01:139:172:835:125:55:0x01:102:298:835:115:55:0x01:217:412:835:95:55

File peta tombol virtual yang sama juga dapat ditulis di beberapa baris.

# One key per line
0x01:158:55:835:90:55
0x01:139:172:835:125:55
0x01:102:298:835:115:55
0x01:217:412:835:95:55

Pada contoh di atas, layar sentuh memiliki resolusi 480x800. Oleh karena itu, semua tombol virtual memiliki koordinat <centerY> 835, yang sedikit di bawah area yang terlihat di layar sentuh.

Kunci pertama memiliki kode pemindaian Linux 158 (KEY_BACK), centerX 55, centerY 835, lebar 90, dan tinggi 55.

Contoh

File peta tombol virtual: /sys/board_properties/virtualkeys.touchyfeely.

0x01:158:55:835:90:55
0x01:139:172:835:125:55
0x01:102:298:835:115:55
0x01:217:412:835:95:55

File tata letak kunci: /system/usr/keylayout/touchyfeely.kl.

key 158 BACK
key 139 MENU
key 172 HOME
key 217 SEARCH

File peta karakter kunci: /system/usr/keychars/touchyfeely.kcm.

type SPECIAL_FUNCTION

Gestur pointer multi-kontrol tidak langsung

Dalam mode pointer, sistem menafsirkan gestur berikut:

  • Ketuk dengan satu jari: klik.
  • Gerakan satu jari: menggerakkan kursor.
  • Gerakan satu jari plus penekanan tombol: tarik kursor.
  • Gerakan dua jari, kedua jari bergerak ke arah yang sama: tarik area di bawah kursor ke arah tersebut. Pointer itu sendiri tidak bergerak.
  • Gerakan dua jari, kedua jari bergerak saling mendekat atau menjauh dalam arah yang berbeda: geser/skalakan/putar area di sekitar pointer. Pointer itu sendiri tidak bergerak.
  • Gerakan beberapa jari: gestur bentuk bebas.

Penolakan telapak tangan

Mulai Android 13, sistem dapat otomatis menolak input dari telapak tangan saat framework bawaan diaktifkan. Solusi buatan sendiri yang dibuat khusus masih didukung, meskipun mungkin perlu dimodifikasi untuk menampilkan tanda TOOL_TYPE_PALM saat telapak tangan terdeteksi. Framework bawaan juga berfungsi bersama dengan solusi kustom.

Model sebenarnya melihat data gestur 90 milidetik pertama, pada pointer saat ini, dan pada pointer di sekitarnya, lalu mempertimbangkan seberapa jauh sentuhan dari tepi layar. Kemudian, metode ini menentukan, berdasarkan per pointer, pointer mana yang merupakan telapak tangan. Hal ini juga memperhitungkan ukuran setiap kontak, seperti yang dilaporkan oleh touchMajor dan touchMinor. Framework Android kemudian menghapus pointer yang ditandai sebagai telapak tangan dari aliran sentuh.

Jika pointer sudah dikirim ke aplikasi, sistem akan:

  • (Jika ada pointer aktif lainnya) Membatalkan pointer dengan ACTION_POINTER_UP dan FLAG_CANCELED yang ditetapkan.
  • (Jika ini adalah satu-satunya pointer) Membatalkan pointer dengan ACTION_CANCEL.

API publik, MotionEvent.FLAG_CANCELED, menunjukkan bahwa peristiwa saat ini tidak boleh memicu tindakan pengguna. Flag ini ditetapkan untuk ACTION_CANCEL dan ACTION_POINTER_UP.

Jika pointer telapak tangan tidak dikirim ke aplikasi, sistem akan menghapus pointer.

Mengaktifkan penolakan telapak tangan

  1. Di driver sentuh, gunakan makro input_abs_set_res untuk menetapkan resolusi untuk kolom berikut (unitnya adalah piksel per mm):
    • ABS_MT_POSITION_X
    • ABS_MT_POSITION_Y
    • ABS_MT_TOUCH_MAJOR
    • ABS_MT_TOUCH_MINOR

    Dukungan untuk ABS_MT_TOUCH_MINOR bersifat opsional. Namun, jika perangkat Anda mendukung fitur ini, pastikan resolusinya disetel dengan benar.

  2. Untuk mengonfirmasi bahwa kolom telah ditetapkan dengan benar, jalankan: 
        $ adb shell getevent -li
  3. Untuk mengaktifkan fitur selama runtime, jalankan: 
        $ adb shell device_config put input_native_boot palm_rejection_enabled 1
  4. Mulai ulang proses system_server. 
         $ adb shell stop && adb shell start
  5. Pastikan adb shell dumpsys input menunjukkan bahwa ada penolakan telapak tangan di dalam UnwantedInteractionBlocker. Jika tidak, periksa log terkait input untuk menemukan petunjuk tentang apa yang mungkin salah dikonfigurasi.

    Lihat contoh berikut untuk referensi:

    UnwantedInteractionBlocker:
  mEnablePalmRejection: true
  isPalmRejectionEnabled (flag value): true
  mPalmRejectors:
    deviceId = 3:
      mDeviceInfo:
        max_x = 
        max_y = 
        x_res = 11.00
        y_res = 11.00
        major_radius_res = 1.00
        minor_radius_res = 1.00
        minor_radius_supported = true
        touch_major_res = 1
        touch_minor_res = 1
      mSlotState:
        mSlotsByPointerId:

        mPointerIdsBySlot:

      mSuppressedPointerIds: {}
  6. Untuk mengaktifkan fitur ini secara permanen, tambahkan perintah sysprop yang sesuai dalam file init**rc Anda:

    setprop persist.device_config.input_native_boot.palm_rejection_enabled 1

Bacaan lebih lanjut