GestureDetector.OnGestureListener 詳解

Android Touch Screen 與傳統Click Touch Screen不一樣，會有一些手勢(Gesture)，例如Fling，Scroll等等。這些Gesture會使用戶體驗大大提高。Android中的Gesture識別(detector)是經過GestureDetector.OnGestureListener接口實現的。

首先，Android事件處理機制是基於Listener實現的，好比觸摸屏相關的事件，就是經過onTouchListener實現；

其次，全部View的子類均可以經過setOnTouchListener()、setOnKeyListener()等方法來添加對某一類事件的Listener；

第三，Listener通常會以Interface的方式來提供，其中包含一個或多個abstract方法，咱們須要實現這些方法來完成onTouch()、onKey()等操做。這樣，程序即可以在特定的事件被dispatch到該view的時候，經過callback函數給予適當的響應。

 

1. Touch Screen Click舉例

Java代碼  

1. public class MyGesture extends Activity implements OnTouchListener {   
2.     public void onCreate(Bundle savedInstanceState) {   
3.         super.onCreate(savedInstanceState);   
4.         setContentView(R.layout.main);   
5.         TextView tv = (TextView) findViewById(R.id.tv);   
6.         tv.setOnTouchListener(this);   
7.     }   
8.     public boolean onTouch(View v, MotionEvent event) {   
9.         Toast.makeText(this, "Touch Touch", Toast.LENGTH_SHORT).show();   
10.         return false;   
11.     }   
12. }  

[java] view plain copy print ?

1. public class MyGesture extends Activity implements OnTouchListener {  
2.     public void onCreate(Bundle savedInstanceState) {  
3.         super.onCreate(savedInstanceState);  
4.         setContentView(R.layout.main);  
5.         TextView tv = (TextView) findViewById(R.id.tv);  
6.         tv.setOnTouchListener(this);  
7.     }  
8.     public boolean onTouch(View v, MotionEvent event) {  
9.         Toast.makeText(this, "Touch Touch", Toast.LENGTH_SHORT).show();  
10.         return false;  
11.     }  
12. }  

咱們能夠經過MotionEvent的getAction()方法來獲取Touch事件的類型，包括 ACTION_DOWN（按下觸摸屏）, ACTION_MOVE（按下觸摸屏後移動受力點）, ACTION_UP（鬆開觸摸屏）和ACTION_CANCEL（不會由用戶直接觸發）。藉助對於用戶不一樣操做的判斷，結合getRawX()、getRawY()、getX()和getY()等方法來獲取座標後，咱們能夠實現諸如拖動某一個按鈕，拖動滾動條等功能。

2. 回到今天的重點，當咱們捕捉到Touch操做的時候，如何識別出用戶的Gesture？這裏咱們須要GestureDetector.OnGestureListener接口的幫助，代碼以下：

1. public class MyGesture extends Activity implements OnTouchListener, OnGestureListener {   
2.     private GestureDetector mGestureDetector;   
3.     public MyGesture() {   
4.         mGestureDetector = new GestureDetector(this);   
5.     }   
6.     public void onCreate(Bundle savedInstanceState) {   
7.         super.onCreate(savedInstanceState);   
8.         setContentView(R.layout.main);   
9.         TextView tv = (TextView) findViewById(R.id.tv);   
10.         tv.setOnTouchListener(this);   
11.         tv.setFocusable(true);   
12.         tv.setClickable(true);   
13.         tv.setLongClickable(true);   
14.         mGestureDetector.setIsLongpressEnabled(true);   
15.     }   
16.        
17.     /*  
18.      * 在onTouch()方法中，咱們調用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給GestureDetector  
19.      * 來分析是否有合適的callback函數來處理用戶的手勢  
20.      */    
21.     public boolean onTouch(View v, MotionEvent event) {   
22.         return mGestureDetector.onTouchEvent(event);   
23.     }   
24.   
25.     // 用戶輕觸觸摸屏，由1個MotionEvent ACTION_DOWN觸發   
26.     public boolean onDown(MotionEvent arg0) {   
27.         Log.i("MyGesture", "onDown");   
28.         Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show();   
29.         return true;   
30.     }   
31.        
32.     /*  
33.      * 用戶輕觸觸摸屏，還沒有鬆開或拖動，由一個1個MotionEvent ACTION_DOWN觸發  
34.      * 注意和onDown()的區別，強調的是沒有鬆開或者拖動的狀態  
35.      */  
36.     public void onShowPress(MotionEvent e) {   
37.         Log.i("MyGesture", "onShowPress");   
38.         Toast.makeText(this, "onShowPress", Toast.LENGTH_SHORT).show();   
39.     }   
40.        
41.     // 用戶（輕觸觸摸屏後）鬆開，由一個1個MotionEvent ACTION_UP觸發   
42.     public boolean onSingleTapUp(MotionEvent e) {   
43.         Log.i("MyGesture", "onSingleTapUp");   
44.         Toast.makeText(this, "onSingleTapUp", Toast.LENGTH_SHORT).show();   
45.         return true;   
46.     }   
47.        
48.     // 用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發   
49.     public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {   
50.         Log.i("MyGesture", "onFling");   
51.         Toast.makeText(this, "onFling", Toast.LENGTH_LONG).show();   
52.         return true;   
53.     }   
54.        
55.     // 用戶按下觸摸屏，並拖動，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發   
56.     public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {   
57.         Log.i("MyGesture", "onScroll");   
58.         Toast.makeText(this, "onScroll", Toast.LENGTH_LONG).show();   
59.         return true;   
60.     }   
61.        
62.     // 用戶長按觸摸屏，由多個MotionEvent ACTION_DOWN觸發   
63.     public void onLongPress(MotionEvent e) {   
64.         Log.i("MyGesture", "onLongPress");   
65.         Toast.makeText(this, "onLongPress", Toast.LENGTH_LONG).show();   
66.     }   
67. }  

3. Fling事件的處理代碼：除了第一個觸發Fling的ACTION_DOWN和最後一個ACTION_MOVE中包含的座標等信息外，咱們還能夠根據用戶在X軸或者Y軸上的移動速度做爲條件。好比下面的代碼中咱們就在用戶移動超過100個像素，且X軸上每秒的移動速度大於200像素時才進行處理。

1. public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {   
2.     // 參數解釋：   
3.     // e1：第1個ACTION_DOWN MotionEvent   
4.     // e2：最後一個ACTION_MOVE MotionEvent   
5.     // velocityX：X軸上的移動速度，像素/秒   
6.     // velocityY：Y軸上的移動速度，像素/秒   
7.   
8.     // 觸發條件 ：   
9.     // X軸的座標位移大於FLING_MIN_DISTANCE，且移動速度大於FLING_MIN_VELOCITY個像素/秒   
10.        
11.     final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;   
12.     if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) {   
13.         // Fling left   
14.         Log.i("MyGesture", "Fling left");   
15.         Toast.makeText(this, "Fling Left", Toast.LENGTH_SHORT).show();   
16.     } else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) {   
17.         // Fling right   
18.         Log.i("MyGesture", "Fling right");   
19.         Toast.makeText(this, "Fling Right", Toast.LENGTH_SHORT).show();   
20.     }   
21.     return false;   

這個例子中，tv.setLongClickable(true)是必須的，由於只有這樣，view纔可以處理不一樣於Tap（輕觸）的hold（即ACTION_MOVE，或者多個ACTION_DOWN），咱們一樣能夠經過layout定義中的android:longClickable來作到這一點。

4. SimpleOnGestureListener

Java代碼  

1. public class MyGesture extends Activity implements OnTouchListener {   
2.     private GestureDetector mGestureDetector;   
3.     public MyGesture() {   
4.         mGestureDetector = new GestureDetector(new MySimpleGesture());   
5.     }   
6.     public void onCreate(Bundle savedInstanceState) {   
7.         super.onCreate(savedInstanceState);   
8.         setContentView(R.layout.main);   
9.         TextView tv = (TextView) findViewById(R.id.tv);   
10.         tv.setOnTouchListener(this);   
11.         tv.setFocusable(true);   
12.         tv.setClickable(true);   
13.         tv.setLongClickable(true);   
14.     }   
15.     public boolean onTouch(View v, MotionEvent event) {   
16.         if (event.getAction() == MotionEvent.ACTION_UP) {   
17.             Log.i("MyGesture", "MotionEvent.ACTION_UP");   
18.         }   
19.         return mGestureDetector.onTouchEvent(event);   
20.     }   
21.        
22.     // SimpleOnGestureListener implements GestureDetector.OnDoubleTapListener, GestureDetector.OnGestureListener   
23.     private class MySimpleGesture extends SimpleOnGestureListener {   
24.         // 雙擊的第二下Touch down時觸發    
25.         public boolean onDoubleTap(MotionEvent e) {   
26.             Log.i("MyGesture", "onDoubleTap");   
27.             return super.onDoubleTap(e);   
28.         }   
29.            
30.         // 雙擊的第二下Touch down和up都會觸發，可用e.getAction()區分   
31.         public boolean onDoubleTapEvent(MotionEvent e) {   
32.             Log.i("MyGesture", "onDoubleTapEvent");   
33.             return super.onDoubleTapEvent(e);   
34.         }   
35.            
36.         // Touch down時觸發    
37.         public boolean onDown(MotionEvent e) {   
38.             Log.i("MyGesture", "onDown");   
39.             return super.onDown(e);   
40.         }   
41.            
42.         // Touch了滑動一點距離後，up時觸發   
43.         public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {   
44.             Log.i("MyGesture", "onFling");   
45.             return super.onFling(e1, e2, velocityX, velocityY);   
46.         }   
47.            
48.         // Touch了不移動一直Touch down時觸發   
49.         public void onLongPress(MotionEvent e) {   
50.             Log.i("MyGesture", "onLongPress");   
51.             super.onLongPress(e);   
52.         }   
53.            
54.         // Touch了滑動時觸發   
55.         public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {   
56.             Log.i("MyGesture", "onScroll");   
57.             return super.onScroll(e1, e2, distanceX, distanceY);   
58.         }   
59.            
60.         /*  
61.          * Touch了尚未滑動時觸發  
62.          * (1)onDown只要Touch Down必定馬上觸發  
63.          * (2)Touch Down後過一會沒有滑動先觸發onShowPress再觸發onLongPress  
64.          * So: Touch Down後一直不滑動，onDown -> onShowPress -> onLongPress這個順序觸發。  
65.          */  
66.         public void onShowPress(MotionEvent e) {   
67.             Log.i("MyGesture", "onShowPress");   
68.             super.onShowPress(e);   
69.         }   
70.   
71.         /*  
72.          * 兩個函數都是在Touch Down後又沒有滑動(onScroll)，又沒有長按(onLongPress)，而後Touch Up時觸發  
73.          * 點擊一下很是快的(不滑動)Touch Up: onDown->onSingleTapUp->onSingleTapConfirmed  
74.          * 點擊一下稍微慢點的(不滑動)Touch Up: onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed   
75.          */    
76.         public boolean onSingleTapConfirmed(MotionEvent e) {   
77.             Log.i("MyGesture", "onSingleTapConfirmed");   
78.             return super.onSingleTapConfirmed(e);   
79.         }   
80.         public boolean onSingleTapUp(MotionEvent e) {   
81.             Log.i("MyGesture", "onSingleTapUp");   
82.             return super.onSingleTapUp(e);   
83.         }   
84.     }   
85. }