使用者將一根手指放到觸控螢幕上,應用程式就會將此觸控模式解讀為手勢。手勢偵測分為兩個階段:
- 收集觸控事件資料。
- 解讀資料,判斷資料是否符合應用程式支援的手勢條件。
AndroidX 類別
本文件中的範例使用 GestureDetectorCompat
和 MotionEventCompat
類別。這些類別位於 AndroidX 程式庫中。請盡可能使用 AndroidX 類別,為舊版裝置提供相容性。MotionEventCompat
「不會」取代 MotionEvent
類別。而是提供靜態公用程式方法,您傳遞 MotionEvent
物件以接收與該事件相關聯的動作。
收集資料
當使用者在畫面上用一根手指時,系統會在接收觸控事件的檢視畫面中觸發回呼 onTouchEvent()
。對於識別為手勢的每個觸控事件序列 (例如位置、壓力、大小和新增其他手指),系統會觸發 onTouchEvent()
次。
手勢會在使用者首次輕觸螢幕時啟動,隨著系統會追蹤使用者手指或手指的位置,並擷取使用者最後一個手指離開螢幕畫面的最終事件。在這次互動中,傳送至 onTouchEvent()
的 MotionEvent
可提供每次互動的詳細資料。應用程式可以使用 MotionEvent
提供的資料,判斷重視的手勢是否發生。
為活動或檢視畫面擷取觸控事件
如要攔截 Activity
或 View
中的觸控事件,請覆寫 onTouchEvent()
回呼。
下列程式碼片段使用 getAction()
從 event
參數擷取使用者執行的動作。這可讓您取得所需的原始資料,以便判斷您重視的手勢是否出現。
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); } }
當使用者輕觸、按住及拖曳時,這個程式碼會在 Logcat 中產生類似如下的訊息:
GESTURES D Action was DOWN GESTURES D Action was UP GESTURES D Action was MOVE
對於自訂手勢,您可以接著對這些事件自行處理,判斷這些事件是否代表需要處理的手勢。不過,如果您的應用程式使用常用手勢 (例如輕觸兩下、按住、快速滑過等),則可利用 GestureDetector
類別。GestureDetector
可讓您輕鬆偵測常見手勢,而不必自行處理個別觸控事件。詳情請參閱「偵測手勢」一文。
擷取單一檢視畫面的觸控事件
除了 onTouchEvent()
以外,您也可以使用 setOnTouchListener()
方法,將 View.OnTouchListener
物件附加至任何 View
物件。如此一來,您不必將現有的 View
設為子類別,就能監聽觸控事件,如以下範例所示:
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; } });
請務必建立可為 ACTION_DOWN
事件回傳 false
的事件監聽器。這樣一來,系統就不會針對後續的 ACTION_MOVE
和 ACTION_UP
事件呼叫事件監聽器。這是因為 ACTION_DOWN
是所有觸控事件的起點。
如要建立自訂檢視區塊,可以覆寫 onTouchEvent()
,如前文所述。
偵測手勢
Android 提供用於偵測常見手勢的 GestureDetector
類別。支援的手勢包括 onDown()
、onLongPress()
和 onFling()
。您可以將 GestureDetector
與前述的 onTouchEvent()
方法搭配使用。
偵測所有支援的手勢
將 GestureDetectorCompat
物件執行個體化時,使用的其中一個參數是實作 GestureDetector.OnGestureListener
介面的類別。GestureDetector.OnGestureListener
會在發生特定觸控事件時通知使用者。如要讓 GestureDetector
物件接收事件,請覆寫檢視畫面或活動的 onTouchEvent()
方法,並將所有觀察到的事件傳送至偵測工具執行個體。
在以下程式碼片段中,從個別 on<TouchEvent>
方法傳回 true
的值代表觸控事件已處理。false
的傳回值會透過檢視畫面堆疊向下傳遞事件,直到觸控作業成功為止。
如果您在測試應用程式中執行以下程式碼片段,就可以瞭解當您與觸控螢幕互動時如何觸發動作,以及每個觸控事件的 MotionEvent
內容。您接著會看到系統為簡單的互動產生多少資料。
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; } }
偵測支援的手勢子集
如果只想處理幾個手勢,您可以擴充 GestureDetector.SimpleOnGestureListener
,而非實作 GestureDetector.OnGestureListener
介面。
GestureDetector.SimpleOnGestureListener
為所有on<TouchEvent>
方法傳回 false
,藉此提供所有方法的實作。這可讓您只覆寫您重視的方法。舉例來說,下列程式碼片段會建立可擴充 GestureDetector.SimpleOnGestureListener
並覆寫 onFling()
和 onDown()
的類別。
無論您使用 GestureDetector.OnGestureListener
或 GestureDetector.SimpleOnGestureListener
,最佳做法就是實作會傳回 true
的 onDown()
方法。這是因為所有手勢的開頭都是 onDown()
訊息。如果您從 onDown()
傳回 false
(如同 GestureDetector.SimpleOnGestureListener
預設),系統會假設您要忽略其餘的手勢,而不會呼叫 GestureDetector.OnGestureListener
的其他方法。這可能會導致應用程式發生非預期的問題。只有在您確實想忽略整個手勢時,才需要從 onDown()
傳回 false
。
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; } } }