Android mendukung berbagai layar sentuh dan bantalan sentuh, termasuk tablet digitizer berbasis stylus.
Layar sentuh adalah perangkat sentuh yang diasosiasikan dengan tampilan sedemikian rupa sehingga pengguna mempunyai kesan memanipulasi item di layar secara langsung.
Bantalan sentuh adalah perangkat sentuh yang tidak dikaitkan dengan layar, seperti tablet digitizer. Bantalan sentuh biasanya digunakan untuk menunjuk atau untuk penentuan posisi tidak langsung absolut atau kontrol berbasis gerakan pada antarmuka pengguna.
Perangkat sentuh dapat memiliki tombol yang fungsinya mirip dengan tombol mouse.
Perangkat sentuh terkadang dapat dimanipulasi menggunakan berbagai alat berbeda seperti jari atau stylus, bergantung pada teknologi sensor sentuh yang mendasarinya.
Perangkat sentuh terkadang digunakan untuk mengimplementasikan kunci virtual. Misalnya, pada beberapa perangkat Android, area sensor layar sentuh melampaui tepi layar dan memiliki fungsi ganda sebagai bagian dari bantalan tombol sensitif sentuhan.
Karena banyaknya variasi perangkat sentuh, Android mengandalkan sejumlah besar properti konfigurasi untuk mendeskripsikan karakteristik dan perilaku yang diinginkan setiap perangkat.
Klasifikasi perangkat sentuh
Perangkat input diklasifikasikan sebagai perangkat multisentuh jika kedua kondisi berikut terpenuhi:
- Perangkat input melaporkan keberadaan sumbu absolut
ABS_MT_POSITION_X
danABS_MT_POSITION_Y
. - Perangkat input tidak memiliki tombol gamepad. Kondisi ini menyelesaikan ambiguitas pada gamepad tertentu yang melaporkan sumbu dengan kode yang tumpang tindih dengan sumbu MT.
Perangkat input diklasifikasikan sebagai perangkat sekali sentuh jika kedua kondisi berikut terpenuhi:
- Perangkat input tidak diklasifikasikan sebagai perangkat multisentuh. Perangkat input diklasifikasikan sebagai perangkat satu sentuhan atau perangkat multisentuh, tidak pernah keduanya.
- Perangkat input melaporkan keberadaan sumbu absolut
ABS_X
danABS_Y
, serta keberadaan kode kunciBTN_TOUCH
.
Ketika perangkat input diklasifikasikan sebagai perangkat sentuh, keberadaan kunci virtual ditentukan dengan mencoba memuat file peta kunci virtual untuk perangkat tersebut. Jika peta kunci virtual tersedia, maka file tata letak kunci untuk perangkat juga dimuat. Lihat [File peta kunci virtual](#file peta kunci virtual) untuk informasi tentang lokasi dan format file ini.
Selanjutnya, sistem memuat file konfigurasi perangkat input untuk perangkat sentuh.
Semua perangkat sentuh internal harus memiliki file konfigurasi perangkat input. Jika tidak ada file konfigurasi perangkat input, sistem akan memilih konfigurasi default yang sesuai untuk periferal sentuh serbaguna seperti layar sentuh atau bantalan sentuh USB atau Bluetooth HID eksternal. Pengaturan default ini tidak dirancang untuk layar sentuh internal dan dapat mengakibatkan perilaku yang salah.
Setelah konfigurasi perangkat input dimuat, sistem mengklasifikasikan perangkat input sebagai perangkat layar sentuh , panel sentuh , atau penunjuk .
- Perangkat layar sentuh digunakan untuk manipulasi langsung objek di layar. Pengguna langsung menyentuh layar, sehingga sistem tidak memerlukan biaya tambahan untuk menunjukkan objek yang sedang dimanipulasi.
- Perangkat panel sentuh digunakan untuk memberikan informasi posisi absolut ke aplikasi tentang sentuhan pada area sensor tertentu. Ini dapat berguna untuk tablet digitizer.
- Perangkat penunjuk digunakan untuk manipulasi tidak langsung objek di layar menggunakan kursor. Jari diartikan sebagai isyarat penunjuk multi-sentuh. Alat lain, seperti stylus, diinterpretasikan menggunakan posisi absolut. Lihat Gerakan penunjuk multisentuh tidak langsung untuk informasi lebih lanjut.
Aturan berikut digunakan untuk mengklasifikasikan perangkat input sebagai layar sentuh, panel sentuh, atau perangkat penunjuk.
- Jika properti
touch.deviceType
disetel, maka jenis perangkat disetel seperti yang ditunjukkan. - Jika perangkat input melaporkan keberadaan properti input
INPUT_PROP_DIRECT
(melaluiEVIOCGPROP
ioctl), maka jenis perangkat diatur ke layar sentuh . Kondisi ini mengasumsikan bahwa perangkat sentuh input langsung dipasang ke layar yang juga tersambung. - Jika perangkat input melaporkan keberadaan properti input
INPUT_PROP_POINTER
(melaluiEVIOCGPROP
ioctl), maka jenis perangkat disetel ke pointer . - Jika perangkat input melaporkan keberadaan sumbu relatif
REL_X
atauREL_Y
, maka jenis perangkat diatur ke touch pad . Kondisi ini menyelesaikan ambiguitas perangkat input yang terdiri dari mouse dan panel sentuh. Dalam hal ini, panel sentuh tidak digunakan untuk mengontrol penunjuk karena mouse sudah mengontrolnya. - Jika tidak, jenis perangkat disetel ke pointer . Default ini memastikan bahwa bantalan sentuh yang belum ditetapkan untuk tujuan khusus lainnya mengontrol penunjuk.
Tombol
Tombol adalah kontrol opsional yang dapat digunakan aplikasi untuk menjalankan fungsi tambahan. Tombol pada perangkat sentuh berperilaku mirip dengan tombol mouse dan terutama digunakan dengan perangkat sentuh tipe penunjuk atau dengan stylus.
Tombol-tombol berikut ini didukung:
-
BTN_LEFT
: Dipetakan keMotionEvent.BUTTON_PRIMARY
. -
BTN_RIGHT
: Dipetakan keMotionEvent.BUTTON_SECONDARY
. -
BTN_MIDDLE
: Dipetakan keMotionEvent.BUTTON_MIDDLE
. -
BTN_BACK
danBTN_SIDE
: Dipetakan keMotionEvent.BUTTON_BACK
. Menekan tombol ini juga menyatukan penekanan tombol dengan kode kunciKeyEvent.KEYCODE_BACK
. -
BTN_FORWARD
danBTN_EXTRA
: Dipetakan keMotionEvent.BUTTON_FORWARD
. Menekan tombol ini juga menyatukan penekanan tombol dengan kode kunciKeyEvent.KEYCODE_FORWARD
. -
BTN_STYLUS
: Dipetakan keMotionEvent.BUTTON_SECONDARY
. -
BTN_STYLUS2
: Dipetakan keMotionEvent.BUTTON_TERTIARY
.
Alat dan jenis alat
Alat adalah jari, stylus, atau peralatan lain yang digunakan untuk berinteraksi dengan perangkat sentuh. Beberapa perangkat sentuh dapat membedakan berbagai jenis alat.
Di tempat lain di Android, seperti di MotionEvent
API, alat sering disebut sebagai pointer .
Jenis alat berikut ini didukung:
-
BTN_TOOL_FINGER
danMT_TOOL_FINGER
: Dipetakan keMotionEvent.TOOL_TYPE_FINGER
. -
BTN_TOOL_PEN
danMT_TOOL_PEN
: Dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_RUBBER
: Dipetakan keMotionEvent.TOOL_TYPE_ERASER
. -
BTN_TOOL_BRUSH
: Dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_PENCIL
: Dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_AIRBRUSH
: Dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_MOUSE
: Dipetakan keMotionEvent.TOOL_TYPE_MOUSE
. -
BTN_TOOL_LENS
: Dipetakan keMotionEvent.TOOL_TYPE_MOUSE
. -
BTN_TOOL_DOUBLETAP
,BTN_TOOL_TRIPLETAP
, danBTN_TOOL_QUADTAP
: Dipetakan keMotionEvent.TOOL_TYPE_FINGER
.
Melayang versus menyentuh alat
Alat dapat bersentuhan dengan perangkat sentuh atau berada dalam jangkauan dan melayang di atasnya. Tidak semua perangkat sentuh dapat merasakan keberadaan alat yang melayang di atas perangkat sentuh tersebut. Alat yang dapat melakukannya, seperti digitizer stylus berbasis RF, sering kali dapat mendeteksi ketika alat tersebut berada dalam jangkauan digitizer yang terbatas.
Komponen InputReader
membedakan alat sentuh dan alat melayang. Demikian pula, alat sentuh dan alat melayang 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 melayang 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 sebaiknya hanya 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 berasumsi bahwaBTN_TOUCH
selalu digunakan untuk menunjukkan apakah alat tersebut menyentuh layar. Oleh karena itu,BTN_TOUCH
tidak boleh digunakan untuk menunjukkan bahwa alat tersebut hanya berada dalam jangkauan dan melayang. - Perangkat sekali sentuh menggunakan peristiwa masukan Linux berikut:
-
ABS_X
: (WAJIB) Melaporkan koordinat X alat. -
ABS_Y
: (WAJIB) Melaporkan koordinat Y alat. -
ABS_PRESSURE
: (opsional) Melaporkan tekanan fisik yang diterapkan pada ujung alat atau kekuatan sinyal kontak sentuh. -
ABS_TOOL_WIDTH
: (opsional) Melaporkan luas penampang atau lebar kontak sentuh atau alat itu sendiri. -
ABS_DISTANCE
: (opsional) Melaporkan jarak alat dari permukaan perangkat sentuh. -
ABS_TILT_X
: (opsional) Melaporkan kemiringan pahat dari permukaan perangkat sentuh sepanjang sumbu X. -
ABS_TILT_Y
: (opsional) Melaporkan kemiringan pahat dari permukaan perangkat sentuh 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 masukan Linux berikut:
-
ABS_MT_POSITION_X
: (DIPERLUKAN) Melaporkan koordinat X alat. -
ABS_MT_POSITION_Y
: (WAJIB) Melaporkan koordinat Y alat. -
ABS_MT_PRESSURE
: (opsional) Melaporkan tekanan fisik yang diterapkan pada ujung alat atau kekuatan sinyal kontak sentuh. -
ABS_MT_TOUCH_MAJOR
: (opsional) Melaporkan luas penampang kontak sentuh, atau panjang dimensi yang lebih panjang dari kontak sentuh. -
ABS_MT_TOUCH_MINOR
: (opsional) Melaporkan panjang dimensi kontak sentuh yang lebih pendek. Sumbu ini tidak boleh digunakan jikaABS_MT_TOUCH_MAJOR
melaporkan pengukuran area. -
ABS_MT_WIDTH_MAJOR
: (opsional) Melaporkan luas penampang pahat itu sendiri, atau panjang dimensi yang lebih panjang dari pahat itu sendiri. Jangan gunakan sumbu ini kecuali Anda mengetahui dimensi alat itu sendiri. -
ABS_MT_WIDTH_MINOR
: (opsional) Melaporkan panjang dimensi terpendek dari pahat itu sendiri. Sumbu ini tidak boleh digunakan jikaABS_MT_WIDTH_MAJOR
melaporkan pengukuran luas 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 sebagaiMT_TOOL_FINGER
atauMT_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 ketika beberapa alat aktif. Misalnya, ketika beberapa jari menyentuh perangkat, setiap jari harus diberi ID pelacakan berbeda yang digunakan selama jari tersebut tetap bersentuhan. ID Pelacakan dapat digunakan kembali ketika alat terkaitnya berada di luar jangkauan. -
ABS_MT_SLOT
: (opsional) Melaporkan ID slot alat, saat menggunakan protokol multi-sentuh Linux 'B'. Lihat dokumentasi protokol multi-sentuh Linux untuk lebih jelasnya. -
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 sentuhan tunggal dan multisentuh ditentukan, maka hanya sumbu multisentuh yang digunakan dan sumbu sentuhan tunggal diabaikan.
Nilai minimum dan maksimum sumbu
ABS_X
,ABS_Y
,ABS_MT_POSITION_X
, danABS_MT_POSITION_Y
menentukan batas area aktif perangkat dalam unit permukaan khusus perangkat. Dalam kasus layar sentuh, area aktif menggambarkan bagian perangkat sentuh yang sebenarnya menutupi layar.Untuk layar sentuh, sistem secara otomatis menginterpolasi posisi sentuh yang dilaporkan dalam unit permukaan untuk mendapatkan posisi sentuh dalam piksel tampilan berdasarkan perhitungan 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 dikirimkan ke aplikasi namun dapat digunakan untuk kunci virtual.
Sentuhan yang dimulai di dalam area aktif, atau yang masuk dan keluar dari area tampilan akan dikirimkan ke aplikasi. Akibatnya, jika sentuhan dimulai dalam batas aplikasi dan kemudian berpindah ke luar area aktif, aplikasi mungkin menerima kejadian sentuhan dengan koordinat tampilan yang negatif atau di luar batas tampilan. Ini adalah perilaku yang diharapkan.
Perangkat sentuh tidak boleh menjepit koordinat sentuhan ke batas area aktif. Jika sentuhan keluar dari area aktif, maka harus dilaporkan sebagai berada di luar area aktif, atau tidak boleh dilaporkan sama sekali.
Misalnya, jika jari pengguna menyentuh di dekat pojok kiri atas layar sentuh, ia mungkin melaporkan koordinat (minX, minY). Jika jari terus bergerak lebih jauh ke luar area aktif, layar sentuh akan mulai melaporkan koordinat dengan komponen yang 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) ketika jari pengguna benar-benar menyentuh di luar area aktif.
Menjepit koordinat sentuhan ke tepi layar menciptakan 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
atauABS_MT_PRESSURE
, jika dilaporkan, harus bukan nol ketika pahat menyentuh perangkat dan nol jika tidak untuk menunjukkan bahwa pahat sedang melayang.Melaporkan informasi tekanan bersifat opsional tetapi sangat disarankan. Aplikasi dapat menggunakan informasi tekanan untuk menerapkan gambar yang peka terhadap tekanan dan efek lainnya.
Nilai yang dilaporkan oleh
ABS_TOOL_WIDTH
,ABS_MT_TOUCH_MAJOR
,ABS_MT_TOUCH_MINOR
,ABS_MT_WIDTH_MAJOR
, atauABS_MT_WIDTH_MINOR
harus bukan nol saat alat menyentuh perangkat dan nol jika tidak, namun hal ini tidak diperlukan. Misalnya, perangkat sentuh mungkin dapat mengukur ukuran kontak sentuhan jari namun tidak dapat mengukur kontak sentuh stylus.Informasi ukuran pelaporan bersifat opsional tetapi sangat disarankan. Aplikasi dapat menggunakan informasi tekanan untuk menerapkan gambar yang peka terhadap ukuran dan efek lainnya.
Nilai yang dilaporkan oleh
ABS_DISTANCE
atauABS_MT_DISTANCE
harus mendekati nol saat alat menyentuh perangkat. Jaraknya bisa tetap bukan nol meskipun alat bersentuhan langsung. Nilai pasti yang dilaporkan bergantung pada cara perangkat keras mengukur jarak.Melaporkan informasi jarak bersifat opsional tetapi disarankan untuk perangkat stylus.
Nilai yang dilaporkan oleh
ABS_TILT_X
danABS_TILT_Y
harus nol ketika pahat tegak lurus terhadap perangkat. Kemiringan yang bukan nol menunjukkan bahwa alat dipegang pada suatu bidang miring.Sudut kemiringan sepanjang sumbu X dan Y diasumsikan ditentukan dalam derajat dari tegak lurus. Titik pusat (tegak lurus sempurna) diberikan oleh
(max + min) / 2
untuk setiap sumbu. Nilai yang lebih kecil dari titik pusat menunjukkan kemiringan ke atas atau ke kiri, nilai yang lebih besar dari titik pusat menunjukkan kemiringan ke bawah atau ke kanan.InputReader
mengubah komponen kemiringan X dan Y menjadi sudut kemiringan tegak lurus mulai dari 0 hinggaPI / 2
radian dan sudut orientasi planar mulai dari-PI
hinggaPI
radian. Representasi ini menghasilkan gambaran orientasi yang sesuai dengan apa yang digunakan untuk menggambarkan sentuhan jari.Melaporkan informasi kemiringan bersifat opsional namun disarankan untuk perangkat stylus.
Jika jenis alat dilaporkan oleh
ABS_MT_TOOL_TYPE
, informasi jenis alat tersebut akan menggantikan informasi jenis alat apa pun yang dilaporkan olehBTN_TOOL_*
. Jika tidak ada informasi jenis alat yang tersedia sama sekali, jenis alat akan ditetapkan secara default keMotionEvent.TOOL_TYPE_FINGER
.Suatu alat ditentukan aktif berdasarkan ketentuan sebagai berikut:
Saat menggunakan protokol sekali sentuh, alat akan aktif jika
BTN_TOUCH
, atauBTN_TOOL_*
bernilai 1.Kondisi ini menyiratkan bahwa
InputReader
perlu memiliki setidaknya beberapa informasi tentang sifat dari alat tersebut, apakah itu sentuhan, atau setidaknya jenis alatnya. Jika tidak ada informasi yang tersedia, maka alat tersebut dianggap tidak aktif (di luar jangkauan).- Saat menggunakan protokol multi-sentuh 'A', alat ini aktif setiap kali muncul di laporan sinkronisasi terbaru. Ketika alat tersebut berhenti muncul dalam laporan sinkronisasi, alat tersebut tidak ada lagi.
- Saat menggunakan protokol multi-sentuh 'B', alat ini aktif selama memiliki slot yang aktif. Ketika slot itu dibersihkan, alat itu tidak ada lagi.
- Suatu alat ditentukan melayang berdasarkan kondisi berikut:
- Jika alat tersebut adalah
BTN_TOOL_MOUSE
atauBTN_TOOL_LENS
, maka alat tersebut tidak akan melayang, meskipun salah satu kondisi berikut ini benar. - Jika alat aktif dan pengemudi melaporkan informasi tekanan, dan tekanan yang dilaporkan adalah nol, maka alat tersebut melayang.
- Jika alat aktif dan driver mendukung kode kunci
BTN_TOUCH
danBTN_TOUCH
bernilai nol, maka alat tersebut melayang.
- Jika alat tersebut adalah
-
InputReader
mendukung protokol multi-sentuh 'A' dan 'B'. Pengemudi baru harus menggunakan protokol 'B' tetapi keduanya berfungsi. Mulai Android 4.0, driver layar sentuh mungkin perlu diubah untuk mematuhi spesifikasi protokol input Linux.
Perubahan berikut mungkin diperlukan:
Bila suatu alat menjadi tidak aktif (jari "naik"), alat tersebut akan berhenti muncul dalam laporan sinkronisasi multi-sentuh berikutnya. Ketika semua alat menjadi tidak aktif (semua jari "naik"), pengemudi harus mengirimkan paket laporan sinkronisasi kosong, seperti
SYN_MT_REPORT
diikuti olehSYN_REPORT
.Versi Android sebelumnya mengharapkan peristiwa "naik" dilaporkan dengan mengirimkan nilai tekanan 0. Perilaku lama tidak kompatibel dengan spesifikasi protokol masukan 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 masukan Linux dan tidak lagi didukung.- Informasi ukuran sentuhan 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 masukan Linux dan tidak lagi didukung.
Sentuh pengoperasian perangkat
Berikut ringkasan singkat pengoperasian perangkat sentuh di Android.
-
EventHub
membaca kejadian mentah dari driverevdev
. -
InputReader
menggunakan peristiwa mentah dan memperbarui keadaan internal tentang posisi dan karakteristik lain dari setiap alat. Ini juga melacak status tombol. - Jika BACK atau FORWARD ditekan atau dilepaskan,
InputReader
memberi tahuInputDispatcher
tentang peristiwa penting. -
InputReader
menentukan apakah terjadi penekanan tombol virtual. Jika demikian, ini akan memberi tahuInputDispatcher
tentang peristiwa penting tersebut. -
InputReader
menentukan apakah sentuhan dimulai dalam batas-batas tampilan. Jika demikian, ia akan memberitahukanInputDispatcher
tentang peristiwa sentuhan. - Jika tidak ada alat yang menyentuh tetapi setidaknya ada satu alat yang melayang,
InputReader
memberi tahuInputDispatcher
tentang peristiwa melayang tersebut. - Jika jenis perangkat sentuh adalah pointer ,
InputReader
melakukan deteksi gerakan penunjuk, menggerakkan penunjuk dan titik yang sesuai, serta memberi tahuInputDispatcher
tentang peristiwa penunjuk. -
InputDispatcher
menggunakanWindowManagerPolicy
untuk menentukan apakah peristiwa harus dikirim dan apakah peristiwa tersebut harus membangunkan perangkat. Kemudian,InputDispatcher
mengirimkan peristiwa tersebut ke aplikasi yang sesuai.
Sentuh konfigurasi perangkat
Perilaku perangkat sentuh ditentukan oleh sumbu perangkat, tombol, properti input, konfigurasi perangkat input, peta kunci virtual, dan tata letak tombol.
Lihat bagian berikut untuk rincian lebih lanjut tentang file yang berpartisipasi dalam konfigurasi keyboard:
Properti
Sistem bergantung pada banyak properti konfigurasi perangkat masukan untuk mengonfigurasi dan mengkalibrasi perilaku perangkat sentuh.
Salah satu alasannya adalah driver perangkat untuk perangkat sentuh sering kali melaporkan karakteristik sentuhan menggunakan unit khusus perangkat.
Misalnya, banyak perangkat sentuh mengukur area kontak sentuh menggunakan skala internal khusus perangkat, seperti jumlah total node sensor yang dipicu oleh sentuhan. Nilai ukuran mentah ini tidak akan berarti bagi aplikasi karena mereka perlu mengetahui ukuran fisik dan karakteristik lain dari node sensor perangkat sentuh.
Sistem menggunakan parameter kalibrasi yang dikodekan dalam file konfigurasi perangkat input untuk memecahkan kode, mengubah, dan menormalkan nilai yang dilaporkan oleh perangkat sentuh menjadi representasi standar yang lebih sederhana yang dapat dipahami oleh 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
atauABS_MT_POSITION_X
. -
raw.y
- Nilai sumbu
ABS_Y
atauABS_MT_POSITION_Y
. -
raw.pressure
- Nilai sumbu
ABS_PRESSURE
atauABS_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
, atauraw.touchMajor
jika tidak tersedia. -
raw.toolMajor
- Nilai sumbu
ABS_TOOL_WIDTH
atauABS_MT_WIDTH_MAJOR
, atau 0 jika tidak tersedia. -
raw.toolMinor
- Nilai sumbu
ABS_MT_WIDTH_MINOR
, atauraw.toolMajor
jika tidak tersedia. -
raw.orientation
- Nilai sumbu
ABS_MT_ORIENTATION
, atau 0 jika tidak tersedia. -
raw.distance
- Nilai sumbu
ABS_DISTANCE
atauABS_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. Mereka diperoleh dengan memanggil EVIOCGABS
ioctl 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
- Keakuratan 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
- Ketinggian inklusif area sentuh, setara dengan
raw.y.range + 1
.
Rentang keluaran
Ekspresi berikut menunjukkan karakteristik sistem koordinat keluaran. Sistem ini menggunakan interpolasi linier untuk menerjemahkan informasi posisi sentuhan dari unit permukaan yang digunakan oleh perangkat sentuh menjadi unit keluaran yang dilaporkan ke aplikasi seperti piksel tampilan.
-
output.width
- Lebar keluaran. Untuk layar sentuh (yang terkait dengan tampilan), ini adalah lebar tampilan dalam piksel. Untuk bantalan sentuh (tidak terkait dengan layar), lebar keluaran sama dengan
raw.width
, yang menunjukkan bahwa tidak ada interpolasi yang dilakukan. -
output.height
- Ketinggian keluaran. Untuk layar sentuh (yang terkait dengan tampilan), ini adalah tinggi tampilan dalam piksel. Untuk bantalan sentuh (tidak terkait dengan layar), tinggi keluaran sama dengan
raw.height
, yang menunjukkan bahwa tidak ada interpolasi yang dilakukan. -
output.diag
- Panjang diagonal sistem koordinat keluaran, setara dengan
sqrt(output.width ^2 + output.height ^2)
.
Konfigurasi dasar
Pemeta input sentuh menggunakan banyak properti konfigurasi di file konfigurasi perangkat input untuk menentukan nilai kalibrasi. Tabel berikut menjelaskan beberapa properti konfigurasi tujuan umum. Semua properti lainnya dijelaskan di bagian berikut bersama dengan bidang yang digunakan untuk mengkalibrasi.
sentuh.deviceType
Definisi: touch.deviceType
= touchScreen
| touchPad
| pointer
| default
Menentukan jenis perangkat sentuh.
Jika nilainya
touchScreen
, perangkat sentuh adalah layar sentuh yang terkait dengan tampilan.Jika nilainya adalah
touchPad
, perangkat sentuh adalah panel sentuh yang tidak terkait dengan layar.Jika nilainya adalah
pointer
, perangkat sentuh adalah papan sentuh yang tidak dikaitkan dengan layar, dan gerakannya digunakan untuk gerakan penunjuk multisentuh tidak langsung .Jika nilainya
default
, sistem secara otomatis mendeteksi jenis perangkat sesuai dengan algoritma klasifikasi.
Lihat bagian Klasifikasi untuk rincian lebih lanjut tentang bagaimana jenis perangkat memengaruhi perilaku perangkat sentuh.
Di Android 3 dan lebih rendah, semua perangkat sentuh diasumsikan sebagai layar sentuh.
sentuh.orientasi Sadar
Definisi: touch.orientationAware
= 0
| 1
Menentukan apakah perangkat sentuh harus bereaksi terhadap perubahan orientasi tampilan.
Jika nilainya
1
, posisi sentuh yang dilaporkan oleh perangkat sentuh akan diputar setiap kali orientasi tampilan berubah.Jika nilainya
0
, posisi sentuh yang dilaporkan oleh perangkat sentuh kebal terhadap perubahan orientasi tampilan.
Nilai defaultnya adalah 1
jika perangkatnya adalah layar sentuh, 0
jika tidak.
Sistem membedakan antara layar sentuh dan tampilan internal dan eksternal. Layar sentuh internal yang sadar orientasi diputar berdasarkan orientasi tampilan internal. Layar sentuh eksternal yang sadar orientasi diputar berdasarkan orientasi layar eksternal.
Kesadaran orientasi digunakan untuk mendukung rotasi layar sentuh pada perangkat seperti Nexus One. Misalnya, saat perangkat diputar searah jarum jam 90 derajat dari orientasi alaminya, posisi absolut dari sentuhan dipetakan ulang sehingga sentuhan di pojok kiri atas sistem koordinat absolut layar sentuh dilaporkan sebagai sentuhan di kiri atas. sudut sistem koordinat yang diputar pada 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 sadar akan orientasi.
sentuh.gestureMode
Definisi: touch.gestureMode
= pointer
| spots
| default
Menentukan mode presentasi untuk gerakan penunjuk. Properti konfigurasi ini hanya relevan bila perangkat sentuh bertipe pointer .
Jika nilainya adalah
pointer
, gerakan papan sentuh disajikan melalui kursor yang mirip dengan penunjuk tetikus.Jika nilainya adalah
spots
, gerakan pada panel sentuh ditampilkan oleh jangkar yang mewakili pusat gerakan dan serangkaian titik melingkar yang mewakili posisi masing-masing jari.
Nilai defaultnya adalah pointer
ketika properti input INPUT_PROP_SEMI_MT
disetel, atau spots
.
bidang X dan Y
Bidang X dan Y memberikan informasi posisi untuk pusat area kontak.
Perhitungan
Perhitungannya mudah: informasi posisi dari driver sentuh diinterpolasi secara linier ke sistem koordinat keluaran.
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
touchMajor, touchMinor, toolMajor, toolMinor, bidang ukuran
Bidang touchMajor
dan touchMinor
menjelaskan perkiraan dimensi area kontak dalam satuan output (piksel).
Bidang toolMajor
dan toolMinor
menjelaskan perkiraan dimensi alat itu sendiri dalam satuan keluaran (piksel).
Bidang size
menjelaskan ukuran sentuhan yang dinormalisasi relatif terhadap kemungkinan sentuhan terbesar yang dapat dirasakan oleh perangkat sentuh. Ukuran normalisasi terkecil yang mungkin adalah 0,0 (tidak ada kontak, atau tidak dapat diukur), dan ukuran normalisasi terbesar yang mungkin adalah 1,0 (area sensor jenuh).
Ketika perkiraan panjang dan lebar dapat diukur, maka bidang touchMajor
menentukan dimensi yang lebih panjang dan bidang touchMinor
menentukan dimensi yang lebih pendek dari area kontak. Jika hanya perkiraan diameter area kontak yang dapat diukur, maka bidang touchMajor
dan touchMinor
adalah sama.
Demikian pula, bidang toolMajor
menentukan dimensi yang lebih panjang dan bidang toolMinor
menentukan dimensi yang lebih pendek dari luas penampang pahat.
Jika ukuran sentuh tidak tersedia namun ukuran pahat tersedia, maka ukuran pahat diatur sama dengan ukuran sentuh. Sebaliknya jika ukuran pahat tidak tersedia namun ukuran sentuh tersedia, maka ukuran sentuh diatur sama dengan ukuran pahat.
Perangkat sentuh mengukur atau melaporkan ukuran sentuhan dan ukuran alat dengan berbagai cara. Implementasi saat ini mendukung tiga jenis pengukuran berbeda: diameter, luas, 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 sentuhan dan ukuran pahat.
Jika nilainya
none
, ukurannya diatur ke nol.Jika nilainya
geometric
, ukurannya diasumsikan ditentukan dalam satuan permukaan yang sama dengan posisinya, sehingga diskalakan dengan cara yang sama.Jika nilainya
diameter
, maka ukurannya diasumsikan sebanding dengan diameter (lebar) alat sentuh atau alat.Jika nilainya adalah
area
, maka ukurannya diasumsikan sebanding dengan luas sentuhan atau alat.Jika nilainya
default
, sistem akan menggunakan kalibrasigeometric
jika sumburaw.touchMajor
atauraw.toolMajor
tersedia, jika tidak maka sistem akan menggunakan kalibrasinone
.
sentuh.ukuran.skala
Definisi: touch.size.scale
= <angka floating point non-negatif>
Menentukan faktor skala konstan yang digunakan dalam kalibrasi.
Nilai defaultnya adalah 1.0
.
sentuh.ukuran.bias
Definisi: touch.size.bias
= <angka floating point non-negatif>
Menentukan nilai bias konstan yang digunakan dalam kalibrasi.
Nilai defaultnya adalah 0.0
.
sentuh.ukuran.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
1
, ukuran yang dilaporkan dibagi dengan jumlah kontak sebelum digunakan.Jika nilainya
0
, ukuran yang dilaporkan digunakan apa adanya.
Nilai defaultnya adalah 0
.
Beberapa perangkat sentuh, khususnya perangkat "Semi-MT" tidak dapat membedakan dimensi individual dari beberapa kontak sehingga perangkat tersebut melaporkan pengukuran ukuran yang mewakili total luas atau lebarnya. Properti ini hanya boleh disetel ke 1
untuk perangkat tersebut. Jika ragu, setel nilai ini ke 0
.
Perhitungan
Penghitungan bidang 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
bidang tekanan
Bidang pressure
menggambarkan perkiraan tekanan fisik yang diterapkan pada perangkat sentuh sebagai nilai yang dinormalisasi antara 0,0 (tanpa sentuhan) dan 1,0 (tekanan normal).
Tekanan nol menunjukkan bahwa alat sedang melayang.
sentuh.tekanan.kalibrasi
Definisi: touch.pressure.calibration
= none
| physical
| amplitude
| default
Menentukan jenis pengukuran yang digunakan oleh driver sentuh untuk melaporkan tekanan.
Jika nilainya
none
, maka tekanannya tidak diketahui sehingga disetel ke 1,0 saat menyentuh dan 0,0 saat melayang.Jika nilainya bersifat
physical
, sumbu tekanan diasumsikan mengukur intensitas fisik sebenarnya dari tekanan yang diterapkan pada panel sentuh.Jika nilainya adalah
amplitude
, sumbu tekanan diasumsikan mengukur amplitudo sinyal, yang terkait dengan ukuran kontak dan tekanan yang diberikan.Jika nilainya
default
, sistem akan menggunakan kalibrasiphysical
jika sumbu tekanan tersedia, jika tidak, tidak akan menggunakannone
.
sentuh.tekanan.skala
Definisi: touch.pressure.scale
= <angka floating point non-negatif>
Menentukan faktor skala konstan yang digunakan dalam kalibrasi.
Nilai defaultnya adalah 1.0 / raw.pressure.max
.
Perhitungan
Perhitungan bidang pressure
tergantung 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
bidang orientasi dan kemiringan
Bidang orientation
menggambarkan 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. Ketika alat stylus hadir, rentang orientasi dapat dijelaskan dalam kisaran lingkaran penuh dari -PI
atau PI
.
Bidang tilt
menggambarkan kemiringan alat sebagai pengukuran sudut. Kemiringan 0
menunjukkan bahwa alat tersebut 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 diatur ke 0. - Jika nilainya
interpolated
, orientasi diinterpolasi secara linear sedemikian rupa sehingga nilai mentahraw.orientation.min
memetakan ke-PI/2
dan nilai mentahraw.orientation.max
Maps kePI/2
. Nilai tengah(raw.orientation.min + raw.orientation.max) / 2
peta ke0
. - Jika nilainya adalah
vector
, orientasi ditafsirkan sebagai vektor yang dikemas dengan dua bidang 4-bit yang ditandatangani. Representasi ini digunakan pada bagian protokol berbasis objek Atmel. Saat didekodekan, vektor menghasilkan sudut orientasi dan besarnya kepercayaan diri. Besarnya kepercayaan diri digunakan untuk mengukur informasi ukuran, kecuali jika geometris. - Jika nilainya
default
, sistem menggunakan kalibrasiinterpolated
jika sumbu orientasi tersedia, jika tidak menggunakannone
.
Perhitungan
Perhitungan bidang orientation
dan tilt
tergantung 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
bidang jarak
Bidang distance
menggambarkan 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
, jaraknya tidak diketahui sehingga diatur ke 0.Jika nilainya
scaled
, jarak yang dilaporkan dikalikan dengan faktor skala konstan.Jika nilainya
default
, sistem menggunakan kalibrasiscaled
jika sumbu jarak tersedia, jika tidak menggunakannone
.
Touch.Distance.Scale
Definisi: touch.distance.scale
Menentukan faktor skala konstan yang digunakan dalam kalibrasi.
Nilai defaultnya adalah 1.0
.
Perhitungan
Perhitungan bidang distance
tergantung 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 diperbarui untuk menggunakan properti konfigurasi baru.
Driver perangkat sentuh yang lebih tua mungkin juga perlu diperbarui.
File peta kunci virtual
Perangkat sentuh dapat digunakan untuk mengimplementasikan kunci virtual.
Ada beberapa cara untuk melakukan ini, tergantung pada kemampuan pengontrol sentuh. Beberapa pengontrol sentuh dapat secara langsung dikonfigurasi untuk mengimplementasikan tombol lunak dengan mengatur register firmware. Di lain waktu diinginkan untuk melakukan pemetaan dari koordinat sentuh ke kode -kode kunci dalam perangkat lunak.
Ketika tombol virtual diimplementasikan dalam perangkat lunak, kernel harus mengekspor file peta kunci virtual yang disebut virtualkeys.<devicename>
Sebagai properti papan. Misalnya, jika driver perangkat layar sentuh melaporkan namanya sebagai "touchyfeely" maka file peta kunci virtual harus memiliki path /sys/board_properties/virtualkeys.touchyfeely
.
File peta kunci virtual menjelaskan kode kunci koordinat dan linux dari tombol virtual pada layar sentuh.
Selain file peta kunci virtual, harus ada file tata letak kunci yang sesuai dan file peta karakter kunci untuk memetakan kode kunci Linux ke kode kunci Android dan untuk menentukan jenis perangkat keyboard (biasanya SPECIAL_FUNCTION
).
Sintaksis
File peta kunci virtual adalah file teks biasa yang terdiri dari urutan deskripsi tata letak kunci virtual yang dipisahkan oleh Newline atau oleh Colons.
Baris komentar dimulai dengan '#' dan lanjutkan ke akhir baris.
Setiap kunci virtual dijelaskan oleh 6 komponen yang dibatasi oleh usus besar:
-
0x01
: kode versi. Harus selalu0x01
. - <Linux Key Code>: Kode kunci Linux dari kunci virtual.
- <tenterx>: Koordinat x piksel dari pusat kunci virtual.
- <Edery>: Koordinat piksel y dari pusat kunci virtual.
- <bulth>: Lebar kunci virtual dalam piksel.
- <tight>: Ketinggian kunci virtual dalam piksel.
Semua koordinat dan ukuran ditentukan dalam hal sistem koordinat tampilan.
Berikut adalah file peta kunci virtual yang semuanya ditulis pada 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 kunci virtual yang sama juga dapat ditulis pada 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
Dalam contoh di atas, layar sentuh memiliki resolusi 480x800. Dengan demikian, semua kunci virtual memiliki koordinat <Centery> 835, yang sedikit di bawah area yang terlihat dari layar sentuh.
Kunci pertama memiliki kode pemindaian Linux 158
( KEY_BACK
), Centre dari 55
, Centery dari 835
, lebar 90
, dan tinggi 55
.
Contoh
File peta kunci 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
Gerakan pointer multi-touch tidak langsung
Dalam mode pointer, sistem menafsirkan gerakan berikut:
- Tap jari tunggal: Klik.
- Gerakan jari tunggal: Pindahkan pointer.
- Tombol Tombol Tombol Plus Single Finger: Seret pointer.
- Gerakan dua jari kedua jari bergerak ke arah yang sama: seret area di bawah pointer ke arah itu. Pointer itu sendiri tidak bergerak.
- Gerakan dua jari kedua jari bergerak ke arah satu sama lain atau terpisah dalam arah yang berbeda: pan/skala/putar area di sekitar pointer. Pointer itu sendiri tidak bergerak.
- Gerakan beberapa jari: Gerakan bentuk bebas.
Penolakan telapak tangan
Pada Android 13, sistem dapat secara otomatis menolak input dari telapak tangan ketika kerangka kerja bawaan diaktifkan. In-house, solusi yang dibuat khusus masih didukung, meskipun mereka mungkin perlu dimodifikasi untuk mengembalikan bendera TOOL_TYPE_PALM
ketika telapak tangan terdeteksi. Kerangka kerja bawaan juga berfungsi bersama dengan solusi khusus.
Model aktual melihat 90 ms pertama dari data gerakan, pada pointer saat ini, dan pada pointer di sekitarnya, kemudian mempertimbangkan seberapa jauh dari tepi tampilan sentuhan. Kemudian menentukan, berdasarkan per-pointer, manakah dari petunjuknya adalah telapak tangan. Ini juga memperhitungkan ukuran setiap kontak, seperti yang dilaporkan oleh touchMajor
dan touchMinor
. Kerangka Android kemudian menghilangkan petunjuk yang ditandai sebagai telapak tangan dari aliran sentuh.
Jika pointer sudah dikirim ke aplikasi, maka sistemnya juga:
- (Jika ada pointer aktif lainnya) membatalkan pointer dengan
ACTION_POINTER_UP
dan setFLAG_CANCELED
. - (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. Bendera ini diatur untuk ACTION_CANCEL
dan ACTION_POINTER_UP
.
Jika Palm Pointer tidak dikirim ke aplikasi, maka sistem hanya menjatuhkan pointer.
Aktifkan penolakan palem
- Di driver sentuh Anda, gunakan makro
input_abs_set_res
untuk mengatur resolusi untuk bidang berikut (unit 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
adalah opsional. Namun, jika perangkat Anda mendukungnya, pastikan resolusi diatur dengan benar. -
- Untuk mengonfirmasi bidang diatur dengan benar, jalankan:
$ adb shell getevent -li
- Untuk mengaktifkan fitur selama runtime, jalankan:
$ adb shell device_config put input_native_boot palm_rejection_enabled 1
- Mulai ulang proses
system_server
.$ adb shell stop && adb shell start
- Konfirmasikan bahwa
adb shell dumpsys input
menunjukkan bahwa ada penolakan telapak tangan di dalamUnwantedInteractionBlocker
. Jika tidak, periksa log terkait input untuk menemukan petunjuk tentang apa yang mungkin salah konfigurasi.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: {} - Untuk mengaktifkan fitur secara permanen, tambahkan perintah SYSPROP yang sesuai di file
init**rc
Anda:setprop persist.device_config.input_native_boot.palm_rejection_enabled 1
Bacaan lebih lanjut
,Android mendukung berbagai layar sentuh dan bantalan sentuh, termasuk tablet digitizer berbasis stylus.
Layar sentuh adalah perangkat sentuh yang dikaitkan dengan tampilan sehingga pengguna memiliki kesan secara langsung memanipulasi item di layar.
Touch Pads adalah perangkat sentuh yang tidak terkait dengan layar, seperti tablet digitizer. Touch bantalan biasanya digunakan untuk menunjuk atau untuk penentuan posisi tidak langsung absolut atau kontrol berbasis gerakan dari antarmuka pengguna.
Perangkat sentuh dapat memiliki tombol yang fungsinya mirip dengan tombol mouse.
Perangkat sentuh kadang -kadang dapat dimanipulasi menggunakan berbagai alat yang berbeda seperti jari atau stylus tergantung pada teknologi sensor sentuh yang mendasarinya.
Perangkat sentuh terkadang digunakan untuk mengimplementasikan kunci virtual. Misalnya, pada beberapa perangkat Android, area sensor layar sentuh memanjang melampaui tepi tampilan dan melayani tujuan ganda sebagai bagian dari bantalan kunci yang sensitif terhadap sentuhan.
Karena banyaknya perangkat sentuh, Android bergantung pada sejumlah besar properti konfigurasi untuk menggambarkan karakteristik dan perilaku yang diinginkan dari setiap perangkat.
Klasifikasi Perangkat Sentuh
Perangkat input diklasifikasikan sebagai perangkat multi-sentuh jika kedua kondisi berikut berlaku:
- Perangkat input melaporkan keberadaan sumbu absolut
ABS_MT_POSITION_X
danABS_MT_POSITION_Y
. - Perangkat input tidak memiliki tombol gamepad. Kondisi ini menyelesaikan ambiguitas dengan gamepads tertentu yang melaporkan sumbu dengan kode yang tumpang tindih dengan sumbu MT.
Perangkat input diklasifikasikan sebagai perangkat sentuhan tunggal jika kedua kondisi berikut berlaku:
- Perangkat input tidak diklasifikasikan sebagai perangkat multi-sentuh. Perangkat input diklasifikasikan sebagai perangkat sentuhan tunggal atau sebagai perangkat multi-sentuh, tidak pernah keduanya.
- Perangkat input melaporkan keberadaan sumbu absolut
ABS_X
danABS_Y
, dan keberadaan kode kunciBTN_TOUCH
.
Ketika perangkat input diklasifikasikan sebagai perangkat sentuh, keberadaan tombol virtual ditentukan dengan mencoba memuat file peta kunci virtual untuk perangkat. Jika peta kunci virtual tersedia, maka file tata letak kunci untuk perangkat juga dimuat. Lihat [File Peta Kunci Virtual] (#Virtual-Key-Map-Files) untuk informasi tentang tentang lokasi dan format file-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 memilih konfigurasi default yang sesuai untuk periferal sentuh tujuan umum seperti USB eksternal atau layar sentuh HID Bluetooth atau bantalan sentuh. Default ini tidak dirancang untuk layar sentuh bawaan dan dapat menghasilkan perilaku yang salah.
Setelah konfigurasi perangkat input dimuat, sistem mengklasifikasikan perangkat input sebagai layar sentuh , pad sentuh , atau perangkat pointer .
- Perangkat layar sentuh digunakan untuk manipulasi langsung objek di layar. Pengguna secara langsung menyentuh layar, sehingga sistem tidak memerlukan biaya tambahan untuk menunjukkan objek yang dimanipulasi.
- Perangkat pad sentuh digunakan untuk memberikan informasi penentuan posisi absolut ke aplikasi tentang sentuhan pada area sensor yang diberikan. Ini bisa berguna untuk tablet digitizer.
- Perangkat pointer digunakan untuk manipulasi tidak langsung objek di layar menggunakan kursor. Jari-jari ditafsirkan sebagai gerakan pointer multi-sentuh. Alat lain, seperti stylus, ditafsirkan menggunakan posisi absolut. Lihat Gerakan Pointer Multi-Touch Tidak Langsung untuk informasi lebih lanjut.
Aturan berikut digunakan untuk mengklasifikasikan perangkat input sebagai layar sentuh, pad sentuh, atau perangkat pointer.
- Jika properti
touch.deviceType
diatur, maka jenis perangkat diatur seperti yang ditunjukkan. - Jika perangkat input melaporkan keberadaan properti input
INPUT_PROP_DIRECT
(melaluiEVIOCGPROP
ioctl), maka jenis perangkat diatur ke layar sentuh . Kondisi ini mengasumsikan bahwa perangkat sentuh input langsung dilampirkan ke tampilan yang juga terhubung. - Jika perangkat input melaporkan keberadaan properti input
INPUT_PROP_POINTER
(melalui IoctlEVIOCGPROP
), maka jenis perangkat diatur ke pointer . - Jika perangkat input melaporkan keberadaan sumbu relatif
REL_X
atauREL_Y
, maka jenis perangkat diatur ke pad sentuh . Kondisi ini menyelesaikan ambiguitas untuk perangkat input yang terdiri dari mouse dan pad sentuh. Dalam hal ini, pad sentuh tidak digunakan untuk mengontrol pointer karena mouse sudah mengendalikannya. - Kalau tidak, jenis perangkat diatur ke pointer . Default ini memastikan bahwa bantalan sentuh yang belum ditetapkan untuk mengontrol pointer tujuan khusus lainnya.
Tombol
Tombol adalah kontrol opsional yang dapat digunakan aplikasi untuk melakukan fungsi tambahan. Tombol pada perangkat sentuh berperilaku mirip dengan tombol mouse dan terutama digunakan dengan perangkat sentuh tipe pointer atau dengan stylus.
Tombol -tombol berikut didukung:
-
BTN_LEFT
: dipetakan keMotionEvent.BUTTON_PRIMARY
. -
BTN_RIGHT
: dipetakan keMotionEvent.BUTTON_SECONDARY
. -
BTN_MIDDLE
: dipetakan keMotionEvent.BUTTON_MIDDLE
. -
BTN_BACK
danBTN_SIDE
: dipetakan keMotionEvent.BUTTON_BACK
. Menekan tombol ini juga mensintesis tombol tekan dengan kode tombolKeyEvent.KEYCODE_BACK
. -
BTN_FORWARD
danBTN_EXTRA
: dipetakan keMotionEvent.BUTTON_FORWARD
. Menekan tombol ini juga mensintesis tombol tekan dengan kode tombolKeyEvent.KEYCODE_FORWARD
. -
BTN_STYLUS
: dipetakan keMotionEvent.BUTTON_SECONDARY
. -
BTN_STYLUS2
: dipetakan keMotionEvent.BUTTON_TERTIARY
.
Jenis Alat dan Alat
Alat adalah jari, stylus, atau peralatan lain yang digunakan untuk berinteraksi dengan perangkat sentuh. Beberapa perangkat sentuh dapat membedakan antara berbagai jenis alat.
Di tempat lain di Android, seperti di API MotionEvent
, sebuah alat sering disebut sebagai penunjuk .
Jenis alat berikut didukung:
-
BTN_TOOL_FINGER
danMT_TOOL_FINGER
: dipetakan keMotionEvent.TOOL_TYPE_FINGER
. -
BTN_TOOL_PEN
danMT_TOOL_PEN
: dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_RUBBER
: dipetakan keMotionEvent.TOOL_TYPE_ERASER
. -
BTN_TOOL_BRUSH
: dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_PENCIL
: dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_AIRBRUSH
: dipetakan keMotionEvent.TOOL_TYPE_STYLUS
. -
BTN_TOOL_MOUSE
: dipetakan keMotionEvent.TOOL_TYPE_MOUSE
. -
BTN_TOOL_LENS
: dipetakan keMotionEvent.TOOL_TYPE_MOUSE
. -
BTN_TOOL_DOUBLETAP
,BTN_TOOL_TRIPLETAP
, danBTN_TOOL_QUADTAP
: dipetakan keMotionEvent.TOOL_TYPE_FINGER
.
Melayang versus alat menyentuh
Alat dapat bersentuhan dengan perangkat sentuh atau dalam jangkauan dan melayang di atasnya. Tidak semua perangkat sentuh dapat merasakan keberadaan alat yang melayang di atas perangkat sentuh. Mereka yang melakukan, seperti digitizer stylus berbasis RF, sering dapat mendeteksi ketika alat berada dalam kisaran digitizer terbatas.
Komponen InputReader
membedakan alat yang menyentuh dari melayang. Demikian juga, alat menyentuh dan alat melayang dilaporkan ke aplikasi dengan cara yang berbeda.
Alat menyentuh 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 melayang dilaporkan ke aplikasi sebagai peristiwa gerak generik menggunakan MotionEvent.ACTION_HOVER_ENTER
, MotionEvent.ACTION_HOVER_MOVE
, dan MotionEvent.ACTION_HOVER_EXIT
.
Sentuh Persyaratan Driver Perangkat
- Touch Device Driver hanya harus mendaftarkan sumbu dan kode kunci untuk sumbu dan tombol yang mereka dukung. 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 bahwaBTN_TOUCH
selalu digunakan untuk menunjukkan apakah alat menyentuh layar. Oleh karena itu,BTN_TOUCH
tidak boleh digunakan untuk menunjukkan bahwa alat ini hanya dalam jangkauan dan melayang. - Perangkat satu sentuhan menggunakan peristiwa input Linux berikut:
-
ABS_X
: (Diperlukan) melaporkan koordinat x alat. -
ABS_Y
: (wajib) melaporkan koordinat Y dari alat. -
ABS_PRESSURE
: (Opsional) melaporkan tekanan fisik yang diterapkan pada ujung alat atau kekuatan sinyal dari kontak sentuh. -
ABS_TOOL_WIDTH
: (Opsional) melaporkan area cross-sectional atau lebar 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
: (Diperlukan) menunjukkan apakah alat menyentuh perangkat. -
BTN_LEFT
,BTN_RIGHT
,BTN_MIDDLE
,BTN_SIDE
,BTN_FORWARD
,BTN_EXTRA
BTN_BACK
btn_extra,BTN_STYLUS
,BTN_STYLUS2
: (opsional) Laporan menyatakan tombol . -
BTN_TOOL_FINGER
,BTN_TOOL_PEN
BTN_TOOL_LENS
BTN_TOOL_BRUSH
BTN_TOOL_TRIPLETAP
BTN_TOOL_RUBBER
BTN_TOOL_QUADTAP
BTN_TOOL_AIRBRUSH
BTN_TOOL_DOUBLETAP
BTN_TOOL_PENCIL
,BTN_TOOL_MOUSE
jenis alat .
-
- Perangkat multi-touch menggunakan peristiwa input Linux berikut:
-
ABS_MT_POSITION_X
: (Diperlukan) melaporkan koordinat x alat. -
ABS_MT_POSITION_Y
: (Diperlukan) melaporkan koordinat Y dari alat. -
ABS_MT_PRESSURE
: (Opsional) melaporkan tekanan fisik yang diterapkan pada ujung alat atau kekuatan sinyal dari kontak sentuh. -
ABS_MT_TOUCH_MAJOR
: (Opsional) melaporkan area cross-sectional dari kontak sentuh, atau panjang dimensi yang lebih panjang dari kontak sentuh. -
ABS_MT_TOUCH_MINOR
: (Opsional) melaporkan panjang dimensi yang lebih pendek dari kontak sentuh. Sumbu ini tidak boleh digunakan jikaABS_MT_TOUCH_MAJOR
melaporkan pengukuran area. -
ABS_MT_WIDTH_MAJOR
: (Opsional) melaporkan area cross-sectional dari alat itu sendiri, atau panjang dimensi yang lebih panjang dari alat itu sendiri. Jangan gunakan sumbu ini kecuali Anda tahu dimensi alat itu sendiri. -
ABS_MT_WIDTH_MINOR
: (Opsional) melaporkan panjang dimensi yang lebih pendek dari alat itu sendiri. Sumbu ini tidak boleh digunakan jikaABS_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 sebagaiMT_TOOL_FINGER
atauMT_TOOL_PEN
. -
ABS_MT_TRACKING_ID
: (Opsional) melaporkan ID pelacakan alat. ID pelacakan adalah bilangan bulat non-negatif yang sewenang-wenang yang digunakan untuk mengidentifikasi dan melacak setiap alat secara independen ketika beberapa alat aktif. Misalnya, ketika beberapa jari menyentuh perangkat, setiap jari harus diberi ID pelacakan berbeda yang digunakan selama jari tetap bersentuhan. Pelacakan ID dapat digunakan kembali ketika alat terkait mereka keluar dari jangkauan. -
ABS_MT_SLOT
: (Opsional) melaporkan ID slot alat, saat menggunakan protokol multi-touch Linux 'B'. Lihat dokumentasi protokol multi-sentuh Linux untuk lebih jelasnya. -
BTN_TOUCH
: (Diperlukan) menunjukkan apakah alat menyentuh perangkat. -
BTN_LEFT
,BTN_RIGHT
,BTN_MIDDLE
,BTN_SIDE
,BTN_FORWARD
,BTN_EXTRA
BTN_BACK
btn_extra,BTN_STYLUS
,BTN_STYLUS2
: (opsional) Laporan menyatakan tombol . -
BTN_TOOL_FINGER
,BTN_TOOL_PEN
BTN_TOOL_LENS
BTN_TOOL_BRUSH
BTN_TOOL_TRIPLETAP
BTN_TOOL_RUBBER
BTN_TOOL_QUADTAP
BTN_TOOL_AIRBRUSH
BTN_TOOL_DOUBLETAP
BTN_TOOL_PENCIL
,BTN_TOOL_MOUSE
jenis alat .
-
- Jika sumbu untuk protokol sentuhan tunggal dan multi-sentuh didefinisikan, maka hanya sumbu multi-touch yang digunakan dan sumbu sentuhan tunggal diabaikan.
Nilai minimum dan maksimum dari
ABS_X
,ABS_Y
,ABS_MT_POSITION_X
, danABS_MT_POSITION_Y
AXES menentukan batas-batas area aktif perangkat dalam unit permukaan khusus perangkat. Dalam kasus layar sentuh, area aktif menggambarkan bagian perangkat sentuh yang benar -benar menutupi layar.Untuk layar sentuh, sistem secara otomatis menginterpolasi posisi sentuh yang dilaporkan dalam unit permukaan untuk mendapatkan posisi sentuh dalam piksel tampilan sesuai dengan perhitungan 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 kunci virtual.
Sentuhan yang dimulai di dalam area aktif, atau yang masuk dan keluar dari area tampilan dikirim ke aplikasi. Akibatnya, jika sentuhan dimulai dalam batas -batas aplikasi dan kemudian bergerak di luar area aktif, aplikasi mungkin menerima acara sentuh dengan koordinat tampilan yang negatif atau di luar batas layar. Ini adalah perilaku yang diharapkan.
Perangkat sentuh tidak boleh menjepit sentuh koordinat ke batas -batas area aktif. Jika sentuhan keluar dari area aktif, itu harus dilaporkan berada di luar area aktif, atau tidak boleh dilaporkan sama sekali.
Misalnya, jika jari pengguna menyentuh di dekat sudut kiri atas layar sentuh, itu 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) ketika jari pengguna benar -benar menyentuh di luar area aktif.
Koordinat sentuhan penjepit ke tepi tampilan menciptakan batas keras buatan di sekitar tepi layar yang mencegah sistem dari gerakan pelacakan yang lancar yang masuk atau keluar dari batas area tampilan.
Nilai-nilai yang dilaporkan oleh
ABS_PRESSURE
atauABS_MT_PRESSURE
, jika dilaporkan sama sekali, harus tidak nol ketika alat menyentuh perangkat dan nol sebaliknya untuk menunjukkan bahwa alat tersebut melayang.Melaporkan informasi tekanan adalah opsional tetapi sangat disarankan. Aplikasi dapat menggunakan informasi tekanan untuk mengimplementasikan gambar yang peka terhadap tekanan dan efek lainnya.
Nilai-nilai yang dilaporkan oleh
ABS_TOOL_WIDTH
,ABS_MT_TOUCH_MAJOR
,ABS_MT_TOUCH_MINOR
,ABS_MT_WIDTH_MAJOR
, atauABS_MT_WIDTH_MINOR
harus tidak nol ketika alat menyentuh perangkat dan nol sebaliknya, tetapi ini tidak diperlukan. Misalnya, perangkat sentuh mungkin dapat mengukur ukuran kontak sentuh jari tetapi tidak kontak sentuh stylus.Pelaporan informasi ukuran adalah opsional tetapi sangat disarankan. Aplikasi dapat menggunakan informasi tekanan untuk mengimplementasikan gambar yang peka terhadap ukuran dan efek lainnya.
Nilai yang dilaporkan oleh
ABS_DISTANCE
atauABS_MT_DISTANCE
harus mendekati nol ketika alat menyentuh perangkat. Jarak dapat tetap tidak nol bahkan ketika alat tersebut bersentuhan langsung. Nilai pasti yang dilaporkan tergantung pada cara di mana perangkat keras mengukur jarak.Pelaporan informasi jarak adalah opsional tetapi direkomendasikan untuk perangkat stylus.
Nilai yang dilaporkan oleh
ABS_TILT_X
danABS_TILT_Y
harus nol ketika alat tegak lurus terhadap perangkat. Kemiringan yang tidak nol menunjukkan bahwa alat ini dipegang di lereng.Sudut kemiringan di sepanjang sumbu X dan Y diasumsikan ditentukan dalam derajat dari tegak lurus. Titik tengah (tegak lurus) sempurna diberikan oleh
(max + min) / 2
untuk setiap sumbu. Nilai lebih kecil dari titik tengah mewakili kemiringan ke atas atau ke kiri, nilai lebih besar dari titik tengah mewakili kemiringan ke bawah atau ke kanan.InputReader
mengubah komponen X dan Y tilt menjadi sudut kemiringan tegak lurus mulai dari 0 hingga radianPI / 2
dan sudut orientasi planar mulai dari-PI
hingga radianPI
. Representasi ini menghasilkan deskripsi orientasi yang kompatibel dengan apa yang digunakan untuk menggambarkan sentuhan jari.Melaporkan informasi kemiringan adalah opsional tetapi direkomendasikan untuk perangkat stylus.
Jika jenis alat dilaporkan oleh
ABS_MT_TOOL_TYPE
, itu menggantikan informasi jenis alat yang dilaporkan olehBTN_TOOL_*
. Jika tidak ada informasi jenis alat yang tersedia sama sekali, jenis alat default keMotionEvent.TOOL_TYPE_FINGER
.Alat ditentukan untuk aktif berdasarkan kondisi berikut:
Saat menggunakan protokol sentuhan tunggal, alat ini aktif jika
BTN_TOUCH
, atauBTN_TOOL_*
adalah 1.Kondisi ini menyiratkan bahwa
InputReader
perlu memiliki setidaknya beberapa informasi tentang sifat alat, baik itu menyentuh, atau setidaknya jenis alatnya. Jika tidak ada informasi yang tersedia, maka alat ini diasumsikan tidak aktif (di luar jangkauan).- Saat menggunakan protokol multi-sentuh 'A', alat ini aktif setiap kali muncul dalam laporan sinkronisasi terbaru. Ketika alat berhenti muncul dalam laporan sinkronisasi, itu tidak ada lagi.
- Saat menggunakan protokol multi-sentuh 'B', alat ini aktif selama memiliki slot aktif. Saat slot itu dibersihkan, alat tidak ada lagi.
- Alat ditentukan untuk melayang berdasarkan kondisi berikut:
- Jika alatnya adalah
BTN_TOOL_MOUSE
atauBTN_TOOL_LENS
, maka alat ini tidak melayang, bahkan jika salah satu dari kondisi berikut ini benar. - Jika alat aktif dan driver melaporkan informasi tekanan, dan tekanan yang dilaporkan nol, maka alatnya melayang.
- Jika alat aktif dan driver mendukung kode kunci
BTN_TOUCH
danBTN_TOUCH
memiliki nilai nol, maka alat ini melayang.
- Jika alatnya adalah
-
InputReader
mendukung protokol multi-sentuh 'A' dan 'B'. Driver baru harus menggunakan protokol 'B' tetapi keduanya berfungsi. Pada Android 4.0, driver layar sentuh mungkin perlu diubah untuk mematuhi spesifikasi protokol input Linux.
Perubahan berikut mungkin diperlukan:
Ketika sebuah alat menjadi tidak aktif (jari naik "ke atas"), ia harus berhenti muncul dalam laporan sinkronisasi multi-touch berikutnya. Ketika semua alat menjadi tidak aktif (semua jari naik "ke atas"), pengemudi harus mengirim paket laporan sinkronisasi kosong, seperti
SYN_MT_REPORT
diikuti olehSYN_REPORT
.Versi sebelumnya dari peristiwa "UP" yang diharapkan untuk dilaporkan dengan mengirimkan nilai tekanan 0. Perilaku lama tidak sesuai dengan spesifikasi protokol input Linux dan tidak lagi didukung.
Tekanan fisik atau informasi kekuatan sinyal harus dilaporkan menggunakan
ABS_MT_PRESSURE
.Versi sebelumnya dari Android mengambil informasi tekanan dari
ABS_MT_TOUCH_MAJOR
. Perilaku lama tidak sesuai dengan spesifikasi protokol input Linux dan tidak lagi didukung.- Informasi ukuran sentuh harus dilaporkan menggunakan
ABS_MT_TOUCH_MAJOR
.Versi sebelumnya dari Android mengambil informasi ukuran dari
ABS_MT_TOOL_MAJOR
. Perilaku lama tidak sesuai dengan spesifikasi protokol input Linux dan tidak lagi didukung.
Operasi Perangkat Sentuh
Berikut ini adalah ringkasan singkat dari operasi perangkat sentuh di Android.
-
EventHub
membaca acara mentah dari driverevdev
. -
InputReader
mengkonsumsi acara mentah dan memperbarui keadaan internal tentang posisi dan karakteristik lain dari masing -masing alat. Ini juga melacak status tombol. - Jika kembali atau maju ditekan atau dirilis,
InputReader
memberi tahuInputDispatcher
tentang acara kunci. -
InputReader
menentukan apakah pers tombol virtual terjadi. Jika demikian, ia memberi tahuInputDispatcher
tentang acara utama. -
InputReader
menentukan apakah sentuhan dimulai dalam batas layar. Jika demikian, itu memberi tahuInputDispatcher
tentang acara Touch. - Jika tidak ada alat yang menyentuh tetapi setidaknya ada satu alat yang melayang,
InputReader
memberi tahuInputDispatcher
tentang acara Hover. - Jika jenis perangkat sentuh adalah pointer ,
InputReader
melakukan deteksi gerakan pointer, memindahkan pointer dan bintik -bintik sesuai dan memberi tahuInputDispatcher
tentang acara pointer. -
InputDispatcher
menggunakanWindowManagerPolicy
untuk menentukan apakah peristiwa tersebut harus dikirim dan apakah mereka harus membangunkan perangkat. Kemudian,InputDispatcher
memberikan acara ke aplikasi yang sesuai.
Konfigurasi Perangkat Sentuh
Perilaku perangkat sentuh ditentukan oleh sumbu perangkat, tombol, properti input, konfigurasi perangkat input, peta kunci virtual dan tata letak kunci.
Lihat bagian berikut untuk detail lebih lanjut tentang file yang berpartisipasi dalam konfigurasi keyboard:
Properti
Sistem bergantung pada banyak properti konfigurasi perangkat input untuk mengonfigurasi dan mengkalibrasi perilaku perangkat sentuh.
Salah satu alasan untuk ini adalah bahwa driver perangkat untuk perangkat sentuh sering melaporkan karakteristik sentuhan menggunakan unit khusus perangkat.
Sebagai contoh, banyak perangkat sentuh mengukur area kontak sentuh menggunakan skala spesifik perangkat internal, seperti jumlah total node sensor yang dipicu oleh sentuhan. Nilai ukuran mentah ini tidak akan bermakna bagi aplikasi karena mereka perlu tahu tentang ukuran fisik dan karakteristik lain dari node sensor perangkat sentuh.
Sistem menggunakan parameter kalibrasi yang dikodekan dalam file konfigurasi perangkat input untuk mendekode, mengubah, dan menormalkan nilai yang dilaporkan oleh perangkat sentuh menjadi representasi standar yang lebih sederhana yang dapat dipahami oleh aplikasi.
Konvensi dokumentasi
Untuk tujuan dokumentasi, kami menggunakan konvensi berikut untuk menggambarkan nilai -nilai yang digunakan oleh sistem selama proses kalibrasi.
Nilai sumbu mentah
Ekspresi berikut menunjukkan nilai -nilai mentah yang dilaporkan oleh driver perangkat sentuh sebagai acara EV_ABS
.
-
raw.x
- Nilai sumbu
ABS_X
atauABS_MT_POSITION_X
. -
raw.y
- Nilai sumbu
ABS_Y
atauABS_MT_POSITION_Y
. -
raw.pressure
- Nilai
ABS_PRESSURE
atauABS_MT_PRESSURE
AXIS, 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
, atauraw.touchMajor
jika tidak tersedia. -
raw.toolMajor
- Nilai
ABS_TOOL_WIDTH
atauABS_MT_WIDTH_MAJOR
AXIS, atau 0 jika tidak tersedia. -
raw.toolMinor
- Nilai sumbu
ABS_MT_WIDTH_MINOR
, atauraw.toolMajor
jika tidak tersedia. -
raw.orientation
- Nilai sumbu
ABS_MT_ORIENTATION
, atau 0 jika tidak tersedia. -
raw.distance
- Nilai sumbu
ABS_DISTANCE
atauABS_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 -batas nilai mentah. Mereka diperoleh dengan memanggil EVIOCGABS
ioctl 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
- Keakuratan sumbu mentah. misalnya. Fuzz = 1 menyiratkan nilai akurat hingga +/- 1 unit.
-
raw.width
- Lebar inklusif dari 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 ini menggunakan interpolasi linier untuk menerjemahkan informasi posisi sentuh dari unit permukaan yang digunakan oleh perangkat sentuh ke dalam unit output yang dilaporkan ke aplikasi seperti piksel tampilan.
-
output.width
- Lebar output. Untuk layar sentuh (terkait dengan layar), ini adalah lebar tampilan dalam piksel. Untuk bantalan sentuh (tidak terkait dengan tampilan), lebar output sama dengan
raw.width
, menunjukkan bahwa tidak ada interpolasi yang dilakukan. -
output.height
- Tinggi output. For touch screens (associated with a display), this is the display height in pixels. For touch pads (not associated with a display), the output height equals
raw.height
, indicating that no interpolation is performed. -
output.diag
- The diagonal length of the output coordinate system, equivalent to
sqrt(output.width ^2 + output.height ^2)
.
Konfigurasi dasar
The touch input mapper uses many configuration properties in the input device configuration file to specify calibration values. The following table describes some general purpose configuration properties. All other properties are described in the following sections along with the fields they are used to calibrate.
touch.deviceType
Definition: touch.deviceType
= touchScreen
| touchPad
| pointer
| default
Specifies the touch device type.
If the value is
touchScreen
, the touch device is a touch screen associated with a display.If the value is
touchPad
, the touch device is a touch pad not associated with a display.If the value is
pointer
, the touch device is a touch pad not associated with a display, and its motions are used for indirect multi-touch pointer gestures .If the value is
default
, the system automatically detects the device type according to the classification algorithm.
Refer to the Classification section for more details about how the device type influences the behavior of the touch device.
In Android 3 and lower, all touch devices were assumed to be touch screens.
touch.orientationAware
Definition: touch.orientationAware
= 0
| 1
Specifies whether the touch device should react to display orientation changes.
If the value is
1
, touch positions reported by the touch device are rotated whenever the display orientation changes.If the value is
0
, touch positions reported by the touch device are immune to display orientation changes.
The default value is 1
if the device is a touch screen, 0
otherwise.
The system distinguishes between internal and external touch screens and displays. An orientation aware internal touch screen is rotated based on the orientation of the internal display. An orientation aware external touch screen is rotated based on the orientation of the external display.
Orientation awareness is used to support rotation of touch screens on devices like the Nexus One. For example, when the device is rotated clockwise 90 degrees from its natural orientation, the absolute positions of touches are remapped such that a touch in the top-left corner of the touch screen's absolute coordinate system is reported as a touch in the top-left corner of the display's rotated coordinate system. This is done so that touches are reported with the same coordinate system that apps use to draw their visual elements.
Prior to Honeycomb, all touch devices were assumed to be orientation aware.
touch.gestureMode
Definition: touch.gestureMode
= pointer
| spots
| default
Specifies the presentation mode for pointer gestures. This configuration property is only relevant when the touch device is of type pointer .
If the value is
pointer
, the touch pad gestures are presented by way of a cursor similar to a mouse pointer.If the value is
spots
, the touch pad gestures are presented by an anchor that represents the centroid of the gesture and a set of circular spots that represent the position of individual fingers.
The default value is pointer
when the INPUT_PROP_SEMI_MT
input property is set, or spots
otherwise.
X and Y fields
The X and Y fields provide positional information for the center of the contact area.
Perhitungan
The calculation is straightforward: positional information from the touch driver is linearly interpolated to the output coordinate system.
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
touchMajor, touchMinor, toolMajor, toolMinor, size fields
The touchMajor
and touchMinor
fields describe the approximate dimensions of the contact area in output units (pixels).
The toolMajor
and toolMinor
fields describe the approximate dimensions of the tool itself in output units (pixels).
The size
field describes the normalized size of the touch relative to the largest possible touch that the touch device can sense. The smallest possible normalized size is 0.0 (no contact, or it is unmeasurable), and the largest possible normalized size is 1.0 (sensor area is saturated).
When both the approximate length and breadth can be measured, then the touchMajor
field specifies the longer dimension and the touchMinor
field specifies the shorter dimension of the contact area. When only the approximate diameter of the contact area can be measured, then the touchMajor
and touchMinor
fields are equal.
Likewise, the toolMajor
field specifies the longer dimension and the toolMinor
field specifies the shorter dimension of the tool's cross-sectional area.
If the touch size is unavailable but the tool size is available, then the tool size is set equal to the touch size. Conversely, if the tool size is unavailable but the touch size is available, then the touch size is set equal to the tool size.
Touch devices measure or report the touch size and tool size in various ways. The current implementation supports three different kinds of measurements: diameter, area, and geometric bounding box in surface units.
Definition: touch.size.calibration
= none
| geometric
| diameter
| area
| default
Specifies the kind of measurement used by the touch driver to report the touch size and tool size.
If the value is
none
, the size is set to zero.If the value is
geometric
, the size is assumed to be specified in the same surface units as the position, so it is scaled in the same manner.If the value is
diameter
, the size is assumed to be proportional to the diameter (width) of the touch or tool.If the value is
area
, the size is assumed to be proportional to the area of the touch or tool.If the value is
default
, the system uses thegeometric
calibration if theraw.touchMajor
orraw.toolMajor
axis is available, otherwise it uses thenone
calibration.
touch.size.scale
Definition: touch.size.scale
= <a non-negative floating point number>
Specifies a constant scale factor used in the calibration.
Nilai defaultnya adalah 1.0
.
touch.size.bias
Definition: touch.size.bias
= <a non-negative floating point number>
Specifies a constant bias value used in the calibration.
Nilai defaultnya adalah 0.0
.
touch.size.isSummed
Definition: touch.size.isSummed
= 0
| 1
Specifies whether the size is reported as the sum of the sizes of all active contacts, or is reported individually for each contact.
If the value is
1
, the reported size is divided by the number of contacts prior to use.If the value is
0
, the reported size is used as is.
Nilai defaultnya adalah 0
.
Some touch devices, particularly "Semi-MT" devices cannot distinguish the individual dimensions of multiple contacts so they report a size measurement that represents their total area or width. This property should only be set to 1
for such devices. If in doubt, set this value to 0
.
Perhitungan
The calculation of the touchMajor
, touchMinor
, toolMajor
, toolMinor
, and size
fields depends on the specified calibration parameters.
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
pressure field
The pressure
field describes the approximate physical pressure applied to the touch device as a normalized value between 0.0 (no touch) and 1.0 (normal pressure).
A zero pressure indicates that the tool is hovering.
touch.pressure.calibration
Definition: touch.pressure.calibration
= none
| physical
| amplitude
| default
Specifies the kind of measurement used by the touch driver to report the pressure.
If the value is
none
, the pressure is unknown so it is set to 1.0 when touching and 0.0 when hovering.If the value is
physical
, the pressure axis is assumed to measure the actual physical intensity of pressure applied to the touch pad.If the value is
amplitude
, the pressure axis is assumed to measure the signal amplitude, which is related to the size of the contact and the pressure applied.If the value is
default
, the system uses thephysical
calibration if the pressure axis available, otherwise usesnone
.
touch.pressure.scale
Definition: touch.pressure.scale
= <a non-negative floating point number>
Specifies a constant scale factor used in the calibration.
The default value is 1.0 / raw.pressure.max
.
Perhitungan
The calculation of the pressure
field depends on the specified calibration parameters.
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
orientation and tilt fields
The orientation
field describes the orientation of the touch and tool as an angular measurement. An orientation of 0
indicates that the major axis is oriented vertically, -PI/2
indicates that the major axis is oriented to the left, PI/2
indicates that the major axis is oriented to the right. When a stylus tool is present, the orientation range can be described in a full circle range from -PI
or PI
.
The tilt
field describes the inclination of the tool as an angular measurement. A tilt of 0
indicates that the tool is perpendicular to the surface. A tilt of PI/2
indicates that the tool is flat on the surface.
touch.orientation.calibration
Definition: touch.orientation.calibration
= none
| interpolated
| vector
| default
Specifies the kind of measurement used by the touch driver to report the orientation.
- If the value is
none
, the orientation is unknown so it is set to 0. - If the value is
interpolated
, the orientation is linearly interpolated such that a raw value ofraw.orientation.min
maps to-PI/2
and a raw value ofraw.orientation.max
maps toPI/2
. The center value of(raw.orientation.min + raw.orientation.max) / 2
maps to0
. - If the value is
vector
, the orientation is interpreted as a packed vector consisiting of two signed 4-bit fields. This representation is used on Atmel Object Based Protocol parts. When decoded, the vector yields an orientation angle and confidence magnitude. The confidence magnitude is used to scale the size information, unless it is geometric. - If the value is
default
, the system uses theinterpolated
calibration if the orientation axis available, otherwise usesnone
.
Perhitungan
The calculation of the orientation
and tilt
fields depends on the specified calibration parameters and available input.
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
distance field
The distance
field describes the distance between the tool and the touch device surface. A value of 0.0 indicates direct contact and larger values indicate increasing distance from the surface.
touch.distance.calibration
Definition: touch.distance.calibration
= none
| scaled
| default
Specifies the kind of measurement used by the touch driver to report the distance.
If the value is
none
, the distance is unknown so it is set to 0.If the value is
scaled
, the reported distance is multiplied by a constant scale factor.If the value is
default
, the system uses thescaled
calibration if the distance axis available, otherwise usesnone
.
touch.distance.scale
Definition: touch.distance.scale
= <a non-negative floating point number>
Specifies a constant scale factor used in the calibration.
Nilai defaultnya adalah 1.0
.
Perhitungan
The calculation of the distance
field depends on the specified calibration parameters.
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
The configuration properties for touch devices changed significantly in Android Ice Cream Sandwich 4.0. All input device configuration files for touch devices must be updated to use the new configuration properties.
Older touch device drivers might also need to be updated.
Virtual key map files
Touch devices can be used to implement virtual keys.
There are several ways of doing this, depending on the capabilities of the touch controller. Some touch controllers can be directly configured to implement soft keys by setting firmware registers. Other times it is desirable to perform the mapping from touch coordinates to key codes in software.
When virtual keys are implemented in software, the kernel must export a virtual key map file called virtualkeys.<devicename>
as a board property. For example, if the touch screen device drivers reports its name as "touchyfeely" then the virtual key map file must have the path /sys/board_properties/virtualkeys.touchyfeely
.
A virtual key map file describes the coordinates and Linux key codes of virtual keys on the touch screen.
In addition to the virtual key map file, there must be a corresponding key layout file and key character map file to map the Linux key codes to Android key codes and to specify the type of the keyboard device (usually SPECIAL_FUNCTION
).
Sintaksis
A virtual key map file is a plain text file consisting of a sequence of virtual key layout descriptions either separated by newlines or by colons.
Comment lines begin with '#' and continue to the end of the line.
Each virtual key is described by 6 colon-delimited components:
-
0x01
: A version code. Must always be0x01
. - <Linux key code>: The Linux key code of the virtual key.
- <centerX>: The X pixel coordinate of the center of the virtual key.
- <centerY>: The Y pixel coordinate of the center of the virtual key.
- <width>: The width of the virtual key in pixels.
- <height>: The height of the virtual key in pixels.
All coordinates and sizes are specified in terms of the display coordinate system.
Here is a virtual key map file all written on one line.
# 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
The same virtual key map file can also be written on multiple lines.
# 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
In the above example, the touch screen has a resolution of 480x800. Accordingly, all of the virtual keys have a <centerY> coordinate of 835, which is a little bit below the visible area of the touch screen.
The first key has a Linux scan code of 158
( KEY_BACK
), centerX of 55
, centerY of 835
, width of 90
, and height of 55
.
Contoh
Virtual key map file: /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
Key layout file: /system/usr/keylayout/touchyfeely.kl
.
key 158 BACK key 139 MENU key 172 HOME key 217 SEARCH
Key character map file: /system/usr/keychars/touchyfeely.kcm
.
type SPECIAL_FUNCTION
Indirect multi-touch pointer gestures
In pointer mode, the system interprets the following gestures:
- Single finger tap: click.
- Single finger motion: move the pointer.
- Single finger motion plus button presses: drag the pointer.
- Two finger motion both fingers moving in the same direction: drag the area under the pointer in that direction. The pointer itself does not move.
- Two finger motion both fingers moving towards each other or apart in different directions: pan/scale/rotate the area surrounding the pointer. The pointer itself does not move.
- Multiple finger motion: freeform gesture.
Penolakan telapak tangan
As of Android 13, the system can automatically reject inputs from palms when the built-in framework is enabled. In-house, custom-built solutions are still supported, though they might need to be modified to return the TOOL_TYPE_PALM
flag when a palm is detected. The built-in framework also works in conjunction with custom solutions.
The actual model looks at the first 90 ms of gesture data, at the current pointer, and at the surrounding pointers, then considers how far away from the display edge the touches are. It then determines, on a per-pointer basis, which of the pointers are palms. It also takes into account the size of each contact, as reported by touchMajor
and touchMinor
. The Android framework then removes the pointers that are marked as palms from the touch stream.
If a pointer was already sent to the apps, then the system either:
- (If there are other active pointers) Cancels the pointer with
ACTION_POINTER_UP
andFLAG_CANCELED
set. - (If this is the only pointer) Cancels the pointer with
ACTION_CANCEL
.
A public API, MotionEvent.FLAG_CANCELED
, indicates that the current event shouldn't trigger user action. This flag is set for both ACTION_CANCEL
and ACTION_POINTER_UP
.
If the palm pointer wasn't sent to apps, then the system simply drops the pointer.
Enable palm rejection
- In your touch driver, use the
input_abs_set_res
macro to set the resolutions for the following fields (units are pixels per mm ):-
ABS_MT_POSITION_X
-
ABS_MT_POSITION_Y
-
ABS_MT_TOUCH_MAJOR
-
ABS_MT_TOUCH_MINOR
Support for
ABS_MT_TOUCH_MINOR
is optional. However, if your device does support it, make sure the resolution is set correctly. -
- To confirm the fields are set correctly, run:
$ adb shell getevent -li
- To enable the feature during runtime, run:
$ adb shell device_config put input_native_boot palm_rejection_enabled 1
- Restart the
system_server
process.$ adb shell stop && adb shell start
- Confirm that
adb shell dumpsys input
shows that there are palm rejectors insideUnwantedInteractionBlocker
. If it doesn't, check the input-related logs to find clues on what might be misconfigured.See the following example for reference:
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: {} - To permanently enable the feature, add the corresponding sysprop command in your
init**rc
file:setprop persist.device_config.input_native_boot.palm_rejection_enabled 1