Gestur sentuh terjadi saat pengguna menempatkan satu atau beberapa jari di layar sentuh, dan aplikasi Anda akan menafsirkan pola sentuhan ini sebagai gestur. Ada dua fase untuk mendeteksi gestur:
- Mengumpulkan data peristiwa sentuh.
- Menafsirkan data untuk menentukan apakah data memenuhi kriteria gestur yang didukung aplikasi Anda.
Class AndroidX
Contoh dalam dokumen ini menggunakan
class
GestureDetectorCompat
dan
MotionEventCompat
. Class ini berada di Library
AndroidX. Gunakan class AndroidX jika memungkinkan untuk menyediakan kompatibilitas dengan
perangkat sebelumnya.
MotionEventCompat
bukan pengganti untuk
class
MotionEvent
. Sebaliknya, menyediakan metode utilitas statis tempat Anda meneruskan
objek MotionEvent
untuk menerima tindakan yang terkait dengan peristiwa
tersebut.
Mengumpulkan data
Saat pengguna menempatkan satu atau beberapa jari di layar, hal ini akan memicu
callback
onTouchEvent()
pada tampilan yang menerima peristiwa sentuh. Untuk setiap urutan peristiwa
sentuh—seperti posisi, tekanan, ukuran, dan penambahan jari
lain—yang diidentifikasi sebagai gestur, onTouchEvent()
diaktifkan beberapa kali.
Gestur dimulai saat pengguna pertama kali menyentuh layar, berlanjut saat
sistem melacak posisi jari atau jari pengguna, dan berakhir dengan
menangkap peristiwa terakhir dari jari terakhir pengguna yang meninggalkan layar.
Selama interaksi ini, MotionEvent
yang dikirimkan ke
onTouchEvent()
memberikan detail setiap interaksi. Aplikasi Anda
dapat menggunakan data yang disediakan oleh MotionEvent
untuk menentukan apakah
gestur yang penting terjadi atau tidak.
Menangkap peristiwa sentuhan untuk Aktivitas atau Tampilan
Untuk mencegat peristiwa sentuh dalam Activity
atau
View
, ganti callback onTouchEvent()
.
Cuplikan kode berikut menggunakan
getAction()
untuk mengekstrak tindakan yang dilakukan pengguna dari parameter event
.
Hal ini memberi Anda data mentah yang diperlukan untuk menentukan apakah gestur yang Anda pedulikan terjadi atau tidak.
Kotlin
class MainActivity : Activity() { ... // This example shows an Activity. You can use the same approach if you are // subclassing a View. override fun onTouchEvent(event: MotionEvent): Boolean { return when (event.action) { MotionEvent.ACTION_DOWN -> { Log.d(DEBUG_TAG, "Action was DOWN") true } MotionEvent.ACTION_MOVE -> { Log.d(DEBUG_TAG, "Action was MOVE") true } MotionEvent.ACTION_UP -> { Log.d(DEBUG_TAG, "Action was UP") true } MotionEvent.ACTION_CANCEL -> { Log.d(DEBUG_TAG, "Action was CANCEL") true } MotionEvent.ACTION_OUTSIDE -> { Log.d(DEBUG_TAG, "Movement occurred outside bounds of current screen element") true } else -> super.onTouchEvent(event) } } }
Java
public class MainActivity extends Activity { ... // This example shows an Activity. You can use the same approach if you are // subclassing a View. @Override public boolean onTouchEvent(MotionEvent event){ switch(event.getAction()) { case (MotionEvent.ACTION_DOWN) : Log.d(DEBUG_TAG,"Action was DOWN"); return true; case (MotionEvent.ACTION_MOVE) : Log.d(DEBUG_TAG,"Action was MOVE"); return true; case (MotionEvent.ACTION_UP) : Log.d(DEBUG_TAG,"Action was UP"); return true; case (MotionEvent.ACTION_CANCEL) : Log.d(DEBUG_TAG,"Action was CANCEL"); return true; case (MotionEvent.ACTION_OUTSIDE) : Log.d(DEBUG_TAG,"Movement occurred outside bounds of current screen element"); return true; default : return super.onTouchEvent(event); } }
Kode ini menghasilkan pesan seperti berikut di Logcat saat pengguna mengetuk, menyentuh & menahan, serta menarik:
GESTURES D Action was DOWN GESTURES D Action was UP GESTURES D Action was MOVE
Untuk gestur kustom, Anda dapat melakukan pemrosesan sendiri pada peristiwa ini untuk menentukan apakah peristiwa tersebut mewakili gestur yang perlu ditangani. Namun, jika aplikasi
Anda menggunakan gestur umum, seperti ketuk dua kali, sentuh lama, ayunkan jari, dan sebagainya,
Anda dapat memanfaatkan
class
GestureDetector
. GestureDetector
memudahkan Anda mendeteksi gestur umum
tanpa memproses sendiri setiap peristiwa sentuh. Hal ini
dibahas lebih lanjut di Mendeteksi gestur.
Menangkap peristiwa sentuhan untuk satu tampilan
Sebagai alternatif onTouchEvent()
, Anda dapat melampirkan objek
View.OnTouchListener
ke objek View
apa pun menggunakan
metode
setOnTouchListener()
. Hal ini memungkinkan peristiwa sentuh diproses tanpa membuat subclass
View
yang ada, seperti yang ditunjukkan dalam contoh berikut:
Kotlin
findViewById<View>(R.id.my_view).setOnTouchListener { v, event -> // Respond to touch events. true }
Java
View myView = findViewById(R.id.my_view); myView.setOnTouchListener(new OnTouchListener() { public boolean onTouch(View v, MotionEvent event) { // Respond to touch events. return true; } });
Berhati-hatilah dalam membuat pemroses yang menampilkan false
untuk peristiwa ACTION_DOWN
.
Jika Anda melakukannya, pemroses tidak akan dipanggil untuk urutan peristiwa
ACTION_MOVE
dan
ACTION_UP
berikutnya. Hal ini karena ACTION_DOWN
adalah titik awal untuk semua
peristiwa sentuh.
Jika membuat tampilan kustom, Anda dapat mengganti
onTouchEvent()
, seperti yang dijelaskan sebelumnya.
Mendeteksi gestur
Android menyediakan class GestureDetector
untuk mendeteksi gestur
umum. Beberapa gestur yang didukungnya meliputi
onDown()
,
onLongPress()
,
dan
onFling()
.
Anda dapat menggunakan GestureDetector
bersama dengan
metode onTouchEvent()
yang dijelaskan sebelumnya.
Mendeteksi semua gestur yang didukung
Saat Anda membuat instance objek GestureDetectorCompat
, salah satu
parameter yang diperlukan adalah class yang mengimplementasikan
antarmuka
GestureDetector.OnGestureListener
. GestureDetector.OnGestureListener
memberi tahu pengguna saat
peristiwa sentuh tertentu terjadi. Agar objek GestureDetector
Anda dapat menerima peristiwa, ganti metode onTouchEvent()
tampilan atau aktivitas, lalu teruskan semua peristiwa yang diamati ke instance detektor.
Dalam cuplikan berikut, nilai yang ditampilkan true
dari
setiap metode on<TouchEvent>
menunjukkan bahwa
peristiwa sentuh ditangani. Nilai hasil false
akan meneruskan peristiwa melalui stack tampilan hingga sentuhan berhasil ditangani.
Jika menjalankan cuplikan berikut di aplikasi pengujian, Anda dapat mengetahui cara
tindakan dipicu saat berinteraksi dengan layar sentuh dan konten
MotionEvent
untuk setiap peristiwa sentuh. Anda kemudian melihat
berapa banyak data yang dihasilkan untuk interaksi sederhana.
Kotlin
private const val DEBUG_TAG = "Gestures" class MainActivity : Activity(), GestureDetector.OnGestureListener, GestureDetector.OnDoubleTapListener { private lateinit var mDetector: GestureDetectorCompat // Called when the activity is first created. public override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Instantiate the gesture detector with the // application context and an implementation of // GestureDetector.OnGestureListener. mDetector = GestureDetectorCompat(this, this) // Set the gesture detector as the double-tap // listener. mDetector.setOnDoubleTapListener(this) } override fun onTouchEvent(event: MotionEvent): Boolean { return if (mDetector.onTouchEvent(event)) { true } else { super.onTouchEvent(event) } } override fun onDown(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDown: $event") return true } override fun onFling( event1: MotionEvent, event2: MotionEvent, velocityX: Float, velocityY: Float ): Boolean { Log.d(DEBUG_TAG, "onFling: $event1 $event2") return true } override fun onLongPress(event: MotionEvent) { Log.d(DEBUG_TAG, "onLongPress: $event") } override fun onScroll( event1: MotionEvent, event2: MotionEvent, distanceX: Float, distanceY: Float ): Boolean { Log.d(DEBUG_TAG, "onScroll: $event1 $event2") return true } override fun onShowPress(event: MotionEvent) { Log.d(DEBUG_TAG, "onShowPress: $event") } override fun onSingleTapUp(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onSingleTapUp: $event") return true } override fun onDoubleTap(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDoubleTap: $event") return true } override fun onDoubleTapEvent(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDoubleTapEvent: $event") return true } override fun onSingleTapConfirmed(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onSingleTapConfirmed: $event") return true } }
Java
public class MainActivity extends Activity implements GestureDetector.OnGestureListener, GestureDetector.OnDoubleTapListener{ private static final String DEBUG_TAG = "Gestures"; private GestureDetectorCompat mDetector; // Called when the activity is first created. @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Instantiate the gesture detector with the // application context and an implementation of // GestureDetector.OnGestureListener. mDetector = new GestureDetectorCompat(this,this); // Set the gesture detector as the double-tap // listener. mDetector.setOnDoubleTapListener(this); } @Override public boolean onTouchEvent(MotionEvent event){ if (this.mDetector.onTouchEvent(event)) { return true; } return super.onTouchEvent(event); } @Override public boolean onDown(MotionEvent event) { Log.d(DEBUG_TAG,"onDown: " + event.toString()); return true; } @Override public boolean onFling(MotionEvent event1, MotionEvent event2, float velocityX, float velocityY) { Log.d(DEBUG_TAG, "onFling: " + event1.toString() + event2.toString()); return true; } @Override public void onLongPress(MotionEvent event) { Log.d(DEBUG_TAG, "onLongPress: " + event.toString()); } @Override public boolean onScroll(MotionEvent event1, MotionEvent event2, float distanceX, float distanceY) { Log.d(DEBUG_TAG, "onScroll: " + event1.toString() + event2.toString()); return true; } @Override public void onShowPress(MotionEvent event) { Log.d(DEBUG_TAG, "onShowPress: " + event.toString()); } @Override public boolean onSingleTapUp(MotionEvent event) { Log.d(DEBUG_TAG, "onSingleTapUp: " + event.toString()); return true; } @Override public boolean onDoubleTap(MotionEvent event) { Log.d(DEBUG_TAG, "onDoubleTap: " + event.toString()); return true; } @Override public boolean onDoubleTapEvent(MotionEvent event) { Log.d(DEBUG_TAG, "onDoubleTapEvent: " + event.toString()); return true; } @Override public boolean onSingleTapConfirmed(MotionEvent event) { Log.d(DEBUG_TAG, "onSingleTapConfirmed: " + event.toString()); return true; } }
Mendeteksi subset gestur yang didukung
Jika hanya ingin memproses beberapa gestur, Anda dapat memperluas
GestureDetector.SimpleOnGestureListener
,
bukan mengimplementasikan antarmuka
GestureDetector.OnGestureListener
.
GestureDetector.SimpleOnGestureListener
menyediakan
implementasi untuk semua
metode on<TouchEvent>
dengan menampilkan
false
untuk semua metode tersebut. Dengan begitu, Anda dapat mengganti metode yang diperlukan. Misalnya, cuplikan kode berikut membuat class yang memperluas
GestureDetector.SimpleOnGestureListener
dan mengganti
onFling()
dan onDown()
.
Baik Anda menggunakan GestureDetector.OnGestureListener
atau
GestureDetector.SimpleOnGestureListener
, ini adalah praktik terbaik untuk
mengimplementasikan metode onDown()
yang menampilkan true
. Hal ini
dikarenakan semua gestur dimulai dengan pesan onDown()
. Jika Anda
menampilkan false
dari onDown()
, seperti
GestureDetector.SimpleOnGestureListener
secara default, sistem menganggap Anda
ingin mengabaikan seluruh gestur, dan metode GestureDetector.OnGestureListener
lainnya tidak dipanggil. Hal ini dapat menyebabkan
masalah yang tidak terduga di aplikasi Anda. Hanya tampilkan false
dari
onDown()
jika Anda benar-benar ingin mengabaikan seluruh gestur.
Kotlin
private const val DEBUG_TAG = "Gestures" class MainActivity : Activity() { private lateinit var mDetector: GestureDetectorCompat public override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) mDetector = GestureDetectorCompat(this, MyGestureListener()) } override fun onTouchEvent(event: MotionEvent): Boolean { mDetector.onTouchEvent(event) return super.onTouchEvent(event) } private class MyGestureListener : GestureDetector.SimpleOnGestureListener() { override fun onDown(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDown: $event") return true } override fun onFling( event1: MotionEvent, event2: MotionEvent, velocityX: Float, velocityY: Float ): Boolean { Log.d(DEBUG_TAG, "onFling: $event1 $event2") return true } } }
Java
public class MainActivity extends Activity { private GestureDetectorCompat mDetector; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mDetector = new GestureDetectorCompat(this, new MyGestureListener()); } @Override public boolean onTouchEvent(MotionEvent event){ if (this.mDetector.onTouchEvent(event)) { return true; } return super.onTouchEvent(event); } class MyGestureListener extends GestureDetector.SimpleOnGestureListener { private static final String DEBUG_TAG = "Gestures"; @Override public boolean onDown(MotionEvent event) { Log.d(DEBUG_TAG,"onDown: " + event.toString()); return true; } @Override public boolean onFling(MotionEvent event1, MotionEvent event2, float velocityX, float velocityY) { Log.d(DEBUG_TAG, "onFling: " + event1.toString() + event2.toString()); return true; } } }