使用者將一根手指放到觸控螢幕上，應用程式就會將此觸控模式解讀為手勢。手勢偵測分為兩個階段：
- 收集觸控事件資料。
- 解讀資料，判斷資料是否符合應用程式支援的手勢條件。
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;
}
}
}