Android手勢識別GestureDetector詳解

一、概述

當用戶觸摸屏幕的時候，會產生許多手勢，例如down，up，scroll，filing等等。
一般情況下，我們知道View類有個View.OnTouchListener內部接口，通過重寫他的onTouch(View v, MotionEvent event)方法，我們可以處理一些touch事件，但是這個方法太過簡單，如果需要處理一些複雜的手勢，用這個接口就會很麻煩（因爲我們要自己根據用戶觸摸的軌跡去判斷是什麼手勢）。
Android sdk給我們提供了GestureDetector（Gesture：手勢Detector：識別）類，通過這個類我們可以識別很多的手勢，主要是通過他的onTouchEvent(event)方法完成了不同手勢的識別。雖然他能識別手勢，但是不同的手勢要怎麼處理，應該是提供給程序員實現的。

GestureDetector這個類對外提供了兩個接口和一個外部類
接口：OnGestureListener，OnDoubleTapListener
內部類:SimpleOnGestureListener

這個外部類，其實是兩個接口中所有函數的集成，它包含了這兩個接口裏所有必須要實現的函數而且都已經重寫，但所有方法體都是空的；不同點在於：該類是static class，程序員可以在外部繼承這個類，重寫裏面的手勢處理方法。

下面我們先看OnGestureListener接口；

二、GestureDetector.OnGestureListener---接口

1、基本講解

如果我們寫一個類並implements OnGestureListener，會提示有幾個必須重寫的函數，加上之後是這個樣子的：

[java]view plain copy
 
private class gesturelistener implements GestureDetector.OnGestureListener{  
  
    public boolean onDown(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public void onShowPress(MotionEvent e) {  
        // TODO Auto-generated method stub  
          
    }  
  
    public boolean onSingleTapUp(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onScroll(MotionEvent e1, MotionEvent e2,  
            float distanceX, float distanceY) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public void onLongPress(MotionEvent e) {  
        // TODO Auto-generated method stub  
          
    }  
  
    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
            float velocityY) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
      
}  

可見，這裏總共重寫了六個函數，這些函數都在什麼情況下才會觸發呢，下面講一下：

OnDown(MotionEvent e)：用戶按下屏幕就會觸發；
onShowPress(MotionEvent e)：如果是按下的時間超過瞬間，而且在按下的時候沒有鬆開或者是拖動的，那麼onShowPress就會執行，具體這個瞬間是多久，我也不清楚呃……
onLongPress(MotionEvent e)：長按觸摸屏，超過一定時長，就會觸發這個事件
  觸發順序：
  onDown->onShowPress->onLongPress
onSingleTapUp(MotionEvent e)：從名子也可以看出,一次單獨的輕擊擡起操作,也就是輕擊一下屏幕，立刻擡起來，纔會有這個觸發，當然,如果除了Down以外還有其它操作,那就不再算是Single操作了,所以也就不會觸發這個事件
觸發順序：
點擊一下非常快的（不滑動）Touchup：
onDown->onSingleTapUp->onSingleTapConfirmed
點擊一下稍微慢點的（不滑動）Touchup：
onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY) ：滑屏，用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發
   參數解釋：
e1：第1個ACTION_DOWN MotionEvent
e2：最後一個ACTION_MOVE MotionEvent
velocityX：X軸上的移動速度，像素/秒
velocityY：Y軸上的移動速度，像素/秒
onScroll(MotionEvent e1, MotionEvent e2,float distanceX, float distanceY)：在屏幕上拖動事件。無論是用手拖動view，或者是以拋的動作滾動，都會多次觸發,這個方法   在ACTION_MOVE動作發生時就會觸發
滑屏：手指觸動屏幕後，稍微滑動後立即鬆開
onDown-----》onScroll----》onScroll----》onScroll----》………----->onFling
拖動
onDown------》onScroll----》onScroll------》onFiling

可見，無論是滑屏，還是拖動，影響的只是中間OnScroll觸發的數量多少而已，最終都會觸發onFling事件！

2、實例

要使用GestureDetector，有三步要走：

1、創建OnGestureListener監聽函數：
可以使用構造實例：

[java]view plain copy
 
GestureDetector.OnGestureListener listener = new GestureDetector.OnGestureListener(){  
          
    };  

也可以構造類：

[java]view plain copy
 
private class gestureListener implements GestureDetector.OnGestureListener{  
  
}  

2、創建GestureDetector實例mGestureDetector：

構造函數有下面三個，根據需要選擇：

[java]view plain copy
 
GestureDetector gestureDetector=new GestureDetector(GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.SimpleOnGestureListener listener);  

3、onTouch(View v, MotionEvent event)中攔截：

[java]view plain copy
 
public boolean onTouch(View v, MotionEvent event) {  
    return mGestureDetector.onTouchEvent(event);     
}  

4、控件綁定

[java]view plain copy
 
TextView tv = (TextView)findViewById(R.id.tv);  
tv.setOnTouchListener(this);  

現在進入實例階段：

首先，在主佈局頁面添加一個textView，並將其放大到整屏，方便在其上的手勢識別，代碼爲：

[java]view plain copy
 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    xmlns:tools="http://schemas.android.com/tools"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    tools:context="com.example.gesturedetectorinterface.MainActivity" >  
  
    <TextView  
        android:id="@+id/tv"  
        android:layout_width="fill_parent"  
        android:layout_height="fill_parent"  
        android:layout_margin="50dip"  
        android:background="#ff00ff"  
        android:text="@string/hello_world" />  
  
</RelativeLayout>  

然後在JAVA代碼中，依據上面的三步走原則，寫出代碼，並在所有的手勢下添加上Toast提示並寫上Log

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener{  
  
    private GestureDetector mGestureDetector;     
      
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
      mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener  
          
      TextView tv = (TextView)findViewById(R.id.tv);  
      tv.setOnTouchListener(this);  
      tv.setFocusable(true);     
      tv.setClickable(true);     
      tv.setLongClickable(true);   
    }  
      
      
    /*  
     * 在onTouch()方法中，我們調用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給GestureDetector  
     * 來分析是否有合適的callback函數來處理用戶的手勢  
     */    
    public boolean onTouch(View v, MotionEvent event) {  
        return mGestureDetector.onTouchEvent(event);     
    }  
      
    private class gestureListener implements GestureDetector.OnGestureListener{  
  
        // 用戶輕觸觸摸屏，由1個MotionEvent ACTION_DOWN觸發     
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");     
            Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT).show();     
            return false;  
        }  
  
        /*   
         * 用戶輕觸觸摸屏，尚未鬆開或拖動，由一個1個MotionEvent ACTION_DOWN觸發   
         * 注意和onDown()的區別，強調的是沒有鬆開或者拖動的狀態   
         *  
         * 而onDown也是由一個MotionEventACTION_DOWN觸發的，但是他沒有任何限制， 
         * 也就是說當用戶點擊的時候，首先MotionEventACTION_DOWN，onDown就會執行， 
         * 如果在按下的瞬間沒有鬆開或者是拖動的時候onShowPress就會執行，如果是按下的時間超過瞬間 
         * （這塊我也不太清楚瞬間的時間差是多少，一般情況下都會執行onShowPress），拖動了，就不執行onShowPress。 
         */  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");     
            Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT).show();     
        }  
  
        // 用戶（輕觸觸摸屏後）鬆開，由一個1個MotionEvent ACTION_UP觸發     
        ///輕擊一下屏幕，立刻擡起來，纔會有這個觸發  
        //從名子也可以看出,一次單獨的輕擊擡起操作,當然,如果除了Down以外還有其它操作,那就不再算是Single操作了,所以這個事件 就不再響應  
        public boolean onSingleTapUp(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapUp");     
            Toast.makeText(MainActivity.this, "onSingleTapUp", Toast.LENGTH_SHORT).show();     
            return true;     
        }  
  
        // 用戶按下觸摸屏，並拖動，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發     
        public boolean onScroll(MotionEvent e1, MotionEvent e2,  
                float distanceX, float distanceY) {  
            Log.i("MyGesture22", "onScroll:"+(e2.getX()-e1.getX()) +"   "+distanceX);     
            Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG).show();     
              
            return true;     
        }  
  
        // 用戶長按觸摸屏，由多個MotionEvent ACTION_DOWN觸發     
        public void onLongPress(MotionEvent e) {  
             Log.i("MyGesture", "onLongPress");     
             Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG).show();     
        }  
  
        // 用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發     
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");     
            Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG).show();     
            return true;  
        }  
    };  
      
  
}  

源碼在博客底部給出。

三、GestureDetector.OnDoubleTapListener---接口

1、構建

有兩種方式設置雙擊監聽：

方法一：新建一個類同時派生自OnGestureListener和OnDoubleTapListener：

[java]view plain copy
 
private class gestureListener implements GestureDetector.OnGestureListener,GestureDetector.OnDoubleTapListener{  
    }  

方法二：使用GestureDetector::setOnDoubleTapListener();函數設置監聽：

[java]view plain copy
 
//構建GestureDetector實例     
mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener  
private class gestureListener implements GestureDetector.OnGestureListener{  
      
}  
  
//設置雙擊監聽器  
mGestureDetector.setOnDoubleTapListener(new doubleTapListener());  
private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
      
}  

注意：大家可以看到無論在方法一還是在方法二中，都需要派生自GestureDetector.OnGestureListener，前面我們說過GestureDetector 的構造函數，如下：

[java]view plain copy
 
GestureDetector gestureDetector=new GestureDetector(GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.SimpleOnGestureListener listener);  

可以看到，在構造函數中，除了後面要講的SimpleOnGestureListener 以外的其它兩個構造函數都必須是OnGestureListener的實例。所以要想使用OnDoubleTapListener的幾個函數，就必須先實現OnGestureListener。

2、函數講解：

首先看一下OnDoubleTapListener接口必須重寫的三個函數：

[java]view plain copy
 
private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
  
    public boolean onSingleTapConfirmed(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onDoubleTap(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onDoubleTapEvent(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
}  

onSingleTapConfirmed(MotionEvent e)：單擊事件。用來判定該次點擊是SingleTap而不是DoubleTap，如果連續點擊兩次就是DoubleTap手勢，如果只點擊一次，系統等待一段時間後沒有收到第二次點擊則判定該次點擊爲SingleTap而不是DoubleTap，然後觸發SingleTapConfirmed事件。觸發順序是：OnDown->OnsingleTapUp->OnsingleTapConfirmed
關於onSingleTapConfirmed和onSingleTapUp的一點區別： OnGestureListener有這樣的一個方法onSingleTapUp，和onSingleTapConfirmed容易混淆。二者的區別是：onSingleTapUp，只要手擡起就會執行，而對於onSingleTapConfirmed來說，如果雙擊的話，則onSingleTapConfirmed不會執行。

onDoubleTap(MotionEvent e)：雙擊事件

onDoubleTapEvent(MotionEvent e)：雙擊間隔中發生的動作。指觸發onDoubleTap以後，在雙擊之間發生的其它動作，包含down、up和move事件；下圖是雙擊一下的Log輸出：

兩點總結：

1、從上圖可以看出，在第二下點擊時，先觸發OnDoubleTap，然後再觸發OnDown（第二次點擊）

2、其次在觸發OnDoubleTap以後，就開始觸發onDoubleTapEvent了，onDoubleTapEvent後面的數字代表了當前的事件，0指ACTION_DOWN，1指ACTION_UP，2 指ACTION_MOVE
在上一個例子的基礎上，我們再添加一個雙擊監聽類，實現如下：

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener{  
  
    private GestureDetector mGestureDetector;     
      
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
  
      mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener  
      mGestureDetector.setOnDoubleTapListener(new doubleTapListener());  
          
      TextView tv = (TextView)findViewById(R.id.tv);  
      tv.setOnTouchListener(this);  
      tv.setFocusable(true);     
      tv.setClickable(true);     
      tv.setLongClickable(true);   
    }  
      
      
    /*  
     * 在onTouch()方法中，我們調用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給GestureDetector  
     * 來分析是否有合適的callback函數來處理用戶的手勢  
     */    
    public boolean onTouch(View v, MotionEvent event) {  
        return mGestureDetector.onTouchEvent(event);     
    }  
      
    //OnGestureListener監聽  
    private class gestureListener implements GestureDetector.OnGestureListener{  
  
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");     
            Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT).show();     
            return false;  
        }  
  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");     
            Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT).show();     
        }  
  
        public boolean onSingleTapUp(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapUp");     
            Toast.makeText(MainActivity.this, "onSingleTapUp", Toast.LENGTH_SHORT).show();     
            return true;     
        }  
  
        public boolean onScroll(MotionEvent e1, MotionEvent e2,  
                float distanceX, float distanceY) {  
            Log.i("MyGesture22", "onScroll:"+(e2.getX()-e1.getX()) +"   "+distanceX);     
            Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG).show();     
              
            return true;     
        }  
  
        public void onLongPress(MotionEvent e) {  
             Log.i("MyGesture", "onLongPress");     
             Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG).show();     
        }  
  
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");     
            Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG).show();     
            return true;  
        }  
    };  
      
    //OnDoubleTapListener監聽  
    private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
  
        public boolean onSingleTapConfirmed(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapConfirmed");     
            Toast.makeText(MainActivity.this, "onSingleTapConfirmed", Toast.LENGTH_LONG).show();    
            return true;  
        }  
  
        public boolean onDoubleTap(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTap");     
            Toast.makeText(MainActivity.this, "onDoubleTap", Toast.LENGTH_LONG).show();    
            return true;  
        }  
  
        public boolean onDoubleTapEvent(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTapEvent");     
            Toast.makeText(MainActivity.this, "onDoubleTapEvent", Toast.LENGTH_LONG).show();    
            return true;  
        }  
    };  
}  

雙擊一下，部分截圖如下：

雙擊所對應的觸發事件順序：

輕輕單擊一下，對應的事件觸發順序爲：

源碼在博客底部給出。

四、GestureDetector.SimpleOnGestureListener---類

它與前兩個不同的是：
1、這是一個類，在它基礎上新建類的話，要用extends派生而不是用implements繼承！
2、OnGestureListener和OnDoubleTapListener接口裏的函數都是強制必須重寫的，即使用不到也要重寫出來一個空函數但在SimpleOnGestureListener類的實例或派生類中不必如此，可以根據情況，用到哪個函數就重寫哪個函數，因爲SimpleOnGestureListener類本身已經實現了這兩個接口的所有函數，只是裏面全是空的而已。

下面利用SimpleOnGestureListener類來重新實現上面的幾個效果，代碼如下：

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener {  
  
    private GestureDetector mGestureDetector;     
      
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        mGestureDetector = new GestureDetector(new simpleGestureListener());  
          
        TextView tv = (TextView)findViewById(R.id.tv);  
        tv.setOnTouchListener(this);  
        tv.setFocusable(true);     
        tv.setClickable(true);     
        tv.setLongClickable(true);   
    }  
      
    public boolean onTouch(View v, MotionEvent event) {  
        // TODO Auto-generated method stub  
        return mGestureDetector.onTouchEvent(event);     
    }  
  
    private class simpleGestureListener extends  
            GestureDetector.SimpleOnGestureListener {  
          
        /*****OnGestureListener的函數*****/  
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");  
            Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT)  
                    .show();  
            return false;  
        }  
  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");  
            Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT)  
                    .show();  
        }  
  
        public boolean onSingleTapUp(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapUp");  
            Toast.makeText(MainActivity.this, "onSingleTapUp",  
                    Toast.LENGTH_SHORT).show();  
            return true;  
        }  
  
        public boolean onScroll(MotionEvent e1, MotionEvent e2,  
                float distanceX, float distanceY) {  
            Log.i("MyGesture", "onScroll:" + (e2.getX() - e1.getX()) + "   "  
                    + distanceX);  
            Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG)  
                    .show();  
  
            return true;  
        }  
  
        public void onLongPress(MotionEvent e) {  
            Log.i("MyGesture", "onLongPress");  
            Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG)  
                    .show();  
        }  
  
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");  
            Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG)  
                    .show();  
            return true;  
        }  
          
        /*****OnDoubleTapListener的函數*****/  
        public boolean onSingleTapConfirmed(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapConfirmed");  
            Toast.makeText(MainActivity.this, "onSingleTapConfirmed",  
                    Toast.LENGTH_LONG).show();  
            return true;  
        }  
  
        public boolean onDoubleTap(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTap");  
            Toast.makeText(MainActivity.this, "onDoubleTap", Toast.LENGTH_LONG)  
                    .show();  
            return true;  
        }  
  
        public boolean onDoubleTapEvent(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTapEvent");  
            Toast.makeText(MainActivity.this, "onDoubleTapEvent",  
                    Toast.LENGTH_LONG).show();  
            return true;  
        }  
  
    }  
}  

到此，有關GestureDetector的所有基礎知識都講解完了，下面給出一個小應用——識別用戶是向左滑還是向右滑！

源碼在博客底部給出。

五、OnFling應用——識別向左滑還是向右滑

這部分就有點意思了，可以說是上面知識的一個小應用，我們利用OnFling函數來識別當前用戶是在向左滑還是向右滑，從而打出日誌。先看下OnFling的參數：

[java]view plain copy
 
boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY)  
參數解釋：     
e1：第1個ACTION_DOWN MotionEvent     
e2：最後一個ACTION_MOVE MotionEvent     
velocityX：X軸上的移動速度，像素/秒     
velocityY：Y軸上的移動速度，像素/秒     

首先，先說一下實現的功能：當用戶向左滑動距離超過100px，且滑動速度超過100 px/s時,即判斷爲向左滑動;向右同理.代碼如下:

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener {  
  
    private GestureDetector mGestureDetector;     
      
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        mGestureDetector = new GestureDetector(new simpleGestureListener());  
          
        TextView tv = (TextView)findViewById(R.id.tv);  
        tv.setOnTouchListener(this);  
        tv.setFocusable(true);     
        tv.setClickable(true);     
        tv.setLongClickable(true);   
    }  
      
    public boolean onTouch(View v, MotionEvent event) {  
        // TODO Auto-generated method stub  
        return mGestureDetector.onTouchEvent(event);     
    }  
  
    private class simpleGestureListener extends  
            GestureDetector.SimpleOnGestureListener {  
          
        /*****OnGestureListener的函數*****/  
  
        final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;    
          
        // 觸發條件 ：     
        // X軸的座標位移大於FLING_MIN_DISTANCE，且移動速度大於FLING_MIN_VELOCITY個像素/秒     
         
        // 參數解釋：     
        // e1：第1個ACTION_DOWN MotionEvent     
        // e2：最後一個ACTION_MOVE MotionEvent     
        // velocityX：X軸上的移動速度，像素/秒     
        // velocityY：Y軸上的移動速度，像素/秒     
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
              
              
            if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE    
                    && Math.abs(velocityX) > FLING_MIN_VELOCITY) {    
                // Fling left     
                Log.i("MyGesture", "Fling left");    
                Toast.makeText(MainActivity.this, "Fling Left", Toast.LENGTH_SHORT).show();    
            } else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE    
                    && Math.abs(velocityX) > FLING_MIN_VELOCITY) {    
                // Fling right     
                Log.i("MyGesture", "Fling right");    
                Toast.makeText(MainActivity.this, "Fling Right", Toast.LENGTH_SHORT).show();    
            }    
            return true;  
        }  
  
    }  
}  

這段代碼難度不大,就不再細講,看下效果:

源碼在博客底部給出。

源碼地址：http://download.csdn.net/detail/harvic880925/7978943

本文轉載自：http://blog.csdn.net/harvic880925/article/details/39520901 謝謝！！

一、概述

GestureDetector這個類對外提供了兩個接口和一個外部類
接口：OnGestureListener，OnDoubleTapListener
內部類:SimpleOnGestureListener

下面我們先看OnGestureListener接口；

二、GestureDetector.OnGestureListener---接口

1、基本講解

如果我們寫一個類並implements OnGestureListener，會提示有幾個必須重寫的函數，加上之後是這個樣子的：

[java]view plain copy
 
private class gesturelistener implements GestureDetector.OnGestureListener{  
  
    public boolean onDown(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public void onShowPress(MotionEvent e) {  
        // TODO Auto-generated method stub  
          
    }  
  
    public boolean onSingleTapUp(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onScroll(MotionEvent e1, MotionEvent e2,  
            float distanceX, float distanceY) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public void onLongPress(MotionEvent e) {  
        // TODO Auto-generated method stub  
          
    }  
  
    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
            float velocityY) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
      
}  

可見，這裏總共重寫了六個函數，這些函數都在什麼情況下才會觸發呢，下面講一下：

可見，無論是滑屏，還是拖動，影響的只是中間OnScroll觸發的數量多少而已，最終都會觸發onFling事件！

2、實例

要使用GestureDetector，有三步要走：

1、創建OnGestureListener監聽函數：
可以使用構造實例：

[java]view plain copy
 
GestureDetector.OnGestureListener listener = new GestureDetector.OnGestureListener(){  
          
    };  

也可以構造類：

[java]view plain copy
 
private class gestureListener implements GestureDetector.OnGestureListener{  
  
}  

2、創建GestureDetector實例mGestureDetector：

構造函數有下面三個，根據需要選擇：

[java]view plain copy
 
GestureDetector gestureDetector=new GestureDetector(GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.SimpleOnGestureListener listener);  

3、onTouch(View v, MotionEvent event)中攔截：

[java]view plain copy
 
public boolean onTouch(View v, MotionEvent event) {  
    return mGestureDetector.onTouchEvent(event);     
}  

4、控件綁定

[java]view plain copy
 
TextView tv = (TextView)findViewById(R.id.tv);  
tv.setOnTouchListener(this);  

現在進入實例階段：

首先，在主佈局頁面添加一個textView，並將其放大到整屏，方便在其上的手勢識別，代碼爲：

[java]view plain copy
 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    xmlns:tools="http://schemas.android.com/tools"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    tools:context="com.example.gesturedetectorinterface.MainActivity" >  
  
    <TextView  
        android:id="@+id/tv"  
        android:layout_width="fill_parent"  
        android:layout_height="fill_parent"  
        android:layout_margin="50dip"  
        android:background="#ff00ff"  
        android:text="@string/hello_world" />  
  
</RelativeLayout>  

然後在JAVA代碼中，依據上面的三步走原則，寫出代碼，並在所有的手勢下添加上Toast提示並寫上Log

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener{  
  
    private GestureDetector mGestureDetector;     
      
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
      mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener  
          
      TextView tv = (TextView)findViewById(R.id.tv);  
      tv.setOnTouchListener(this);  
      tv.setFocusable(true);     
      tv.setClickable(true);     
      tv.setLongClickable(true);   
    }  
      
      
    /*  
     * 在onTouch()方法中，我們調用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給GestureDetector  
     * 來分析是否有合適的callback函數來處理用戶的手勢  
     */    
    public boolean onTouch(View v, MotionEvent event) {  
        return mGestureDetector.onTouchEvent(event);     
    }  
      
    private class gestureListener implements GestureDetector.OnGestureListener{  
  
        // 用戶輕觸觸摸屏，由1個MotionEvent ACTION_DOWN觸發     
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");     
            Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT).show();     
            return false;  
        }  
  
        /*   
         * 用戶輕觸觸摸屏，尚未鬆開或拖動，由一個1個MotionEvent ACTION_DOWN觸發   
         * 注意和onDown()的區別，強調的是沒有鬆開或者拖動的狀態   
         *  
         * 而onDown也是由一個MotionEventACTION_DOWN觸發的，但是他沒有任何限制， 
         * 也就是說當用戶點擊的時候，首先MotionEventACTION_DOWN，onDown就會執行， 
         * 如果在按下的瞬間沒有鬆開或者是拖動的時候onShowPress就會執行，如果是按下的時間超過瞬間 
         * （這塊我也不太清楚瞬間的時間差是多少，一般情況下都會執行onShowPress），拖動了，就不執行onShowPress。 
         */  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");     
            Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT).show();     
        }  
  
        // 用戶（輕觸觸摸屏後）鬆開，由一個1個MotionEvent ACTION_UP觸發     
        ///輕擊一下屏幕，立刻擡起來，纔會有這個觸發  
        //從名子也可以看出,一次單獨的輕擊擡起操作,當然,如果除了Down以外還有其它操作,那就不再算是Single操作了,所以這個事件 就不再響應  
        public boolean onSingleTapUp(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapUp");     
            Toast.makeText(MainActivity.this, "onSingleTapUp", Toast.LENGTH_SHORT).show();     
            return true;     
        }  
  
        // 用戶按下觸摸屏，並拖動，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發     
        public boolean onScroll(MotionEvent e1, MotionEvent e2,  
                float distanceX, float distanceY) {  
            Log.i("MyGesture22", "onScroll:"+(e2.getX()-e1.getX()) +"   "+distanceX);     
            Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG).show();     
              
            return true;     
        }  
  
        // 用戶長按觸摸屏，由多個MotionEvent ACTION_DOWN觸發     
        public void onLongPress(MotionEvent e) {  
             Log.i("MyGesture", "onLongPress");     
             Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG).show();     
        }  
  
        // 用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發     
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");     
            Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG).show();     
            return true;  
        }  
    };  
      
  
}  

源碼在博客底部給出。

三、GestureDetector.OnDoubleTapListener---接口

1、構建

有兩種方式設置雙擊監聽：

方法一：新建一個類同時派生自OnGestureListener和OnDoubleTapListener：

[java]view plain copy
 
private class gestureListener implements GestureDetector.OnGestureListener,GestureDetector.OnDoubleTapListener{  
    }  

方法二：使用GestureDetector::setOnDoubleTapListener();函數設置監聽：

[java]view plain copy
 
//構建GestureDetector實例     
mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener  
private class gestureListener implements GestureDetector.OnGestureListener{  
      
}  
  
//設置雙擊監聽器  
mGestureDetector.setOnDoubleTapListener(new doubleTapListener());  
private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
      
}  

注意：大家可以看到無論在方法一還是在方法二中，都需要派生自GestureDetector.OnGestureListener，前面我們說過GestureDetector 的構造函數，如下：

[java]view plain copy
 
GestureDetector gestureDetector=new GestureDetector(GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.OnGestureListener listener);  
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.SimpleOnGestureListener listener);  

2、函數講解：

首先看一下OnDoubleTapListener接口必須重寫的三個函數：

[java]view plain copy
 
private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
  
    public boolean onSingleTapConfirmed(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onDoubleTap(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onDoubleTapEvent(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
}  

onDoubleTap(MotionEvent e)：雙擊事件

兩點總結：

1、從上圖可以看出，在第二下點擊時，先觸發OnDoubleTap，然後再觸發OnDown（第二次點擊）

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener{  
  
    private GestureDetector mGestureDetector;     
      
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
  
      mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener  
      mGestureDetector.setOnDoubleTapListener(new doubleTapListener());  
          
      TextView tv = (TextView)findViewById(R.id.tv);  
      tv.setOnTouchListener(this);  
      tv.setFocusable(true);     
      tv.setClickable(true);     
      tv.setLongClickable(true);   
    }  
      
      
    /*  
     * 在onTouch()方法中，我們調用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給GestureDetector  
     * 來分析是否有合適的callback函數來處理用戶的手勢  
     */    
    public boolean onTouch(View v, MotionEvent event) {  
        return mGestureDetector.onTouchEvent(event);     
    }  
      
    //OnGestureListener監聽  
    private class gestureListener implements GestureDetector.OnGestureListener{  
  
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");     
            Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT).show();     
            return false;  
        }  
  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");     
            Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT).show();     
        }  
  
        public boolean onSingleTapUp(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapUp");     
            Toast.makeText(MainActivity.this, "onSingleTapUp", Toast.LENGTH_SHORT).show();     
            return true;     
        }  
  
        public boolean onScroll(MotionEvent e1, MotionEvent e2,  
                float distanceX, float distanceY) {  
            Log.i("MyGesture22", "onScroll:"+(e2.getX()-e1.getX()) +"   "+distanceX);     
            Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG).show();     
              
            return true;     
        }  
  
        public void onLongPress(MotionEvent e) {  
             Log.i("MyGesture", "onLongPress");     
             Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG).show();     
        }  
  
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");     
            Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG).show();     
            return true;  
        }  
    };  
      
    //OnDoubleTapListener監聽  
    private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
  
        public boolean onSingleTapConfirmed(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapConfirmed");     
            Toast.makeText(MainActivity.this, "onSingleTapConfirmed", Toast.LENGTH_LONG).show();    
            return true;  
        }  
  
        public boolean onDoubleTap(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTap");     
            Toast.makeText(MainActivity.this, "onDoubleTap", Toast.LENGTH_LONG).show();    
            return true;  
        }  
  
        public boolean onDoubleTapEvent(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTapEvent");     
            Toast.makeText(MainActivity.this, "onDoubleTapEvent", Toast.LENGTH_LONG).show();    
            return true;  
        }  
    };  
}  

雙擊一下，部分截圖如下：

雙擊所對應的觸發事件順序：

輕輕單擊一下，對應的事件觸發順序爲：

源碼在博客底部給出。

四、GestureDetector.SimpleOnGestureListener---類

下面利用SimpleOnGestureListener類來重新實現上面的幾個效果，代碼如下：

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener {  
  
    private GestureDetector mGestureDetector;     
      
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        mGestureDetector = new GestureDetector(new simpleGestureListener());  
          
        TextView tv = (TextView)findViewById(R.id.tv);  
        tv.setOnTouchListener(this);  
        tv.setFocusable(true);     
        tv.setClickable(true);     
        tv.setLongClickable(true);   
    }  
      
    public boolean onTouch(View v, MotionEvent event) {  
        // TODO Auto-generated method stub  
        return mGestureDetector.onTouchEvent(event);     
    }  
  
    private class simpleGestureListener extends  
            GestureDetector.SimpleOnGestureListener {  
          
        /*****OnGestureListener的函數*****/  
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");  
            Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT)  
                    .show();  
            return false;  
        }  
  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");  
            Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT)  
                    .show();  
        }  
  
        public boolean onSingleTapUp(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapUp");  
            Toast.makeText(MainActivity.this, "onSingleTapUp",  
                    Toast.LENGTH_SHORT).show();  
            return true;  
        }  
  
        public boolean onScroll(MotionEvent e1, MotionEvent e2,  
                float distanceX, float distanceY) {  
            Log.i("MyGesture", "onScroll:" + (e2.getX() - e1.getX()) + "   "  
                    + distanceX);  
            Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG)  
                    .show();  
  
            return true;  
        }  
  
        public void onLongPress(MotionEvent e) {  
            Log.i("MyGesture", "onLongPress");  
            Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG)  
                    .show();  
        }  
  
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");  
            Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG)  
                    .show();  
            return true;  
        }  
          
        /*****OnDoubleTapListener的函數*****/  
        public boolean onSingleTapConfirmed(MotionEvent e) {  
            Log.i("MyGesture", "onSingleTapConfirmed");  
            Toast.makeText(MainActivity.this, "onSingleTapConfirmed",  
                    Toast.LENGTH_LONG).show();  
            return true;  
        }  
  
        public boolean onDoubleTap(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTap");  
            Toast.makeText(MainActivity.this, "onDoubleTap", Toast.LENGTH_LONG)  
                    .show();  
            return true;  
        }  
  
        public boolean onDoubleTapEvent(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTapEvent");  
            Toast.makeText(MainActivity.this, "onDoubleTapEvent",  
                    Toast.LENGTH_LONG).show();  
            return true;  
        }  
  
    }  
}  

到此，有關GestureDetector的所有基礎知識都講解完了，下面給出一個小應用——識別用戶是向左滑還是向右滑！

源碼在博客底部給出。

五、OnFling應用——識別向左滑還是向右滑

[java]view plain copy
 
boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY)  
參數解釋：     
e1：第1個ACTION_DOWN MotionEvent     
e2：最後一個ACTION_MOVE MotionEvent     
velocityX：X軸上的移動速度，像素/秒     
velocityY：Y軸上的移動速度，像素/秒     

首先，先說一下實現的功能：當用戶向左滑動距離超過100px，且滑動速度超過100 px/s時,即判斷爲向左滑動;向右同理.代碼如下:

[java]view plain copy
 
public class MainActivity extends Activity implements OnTouchListener {  
  
    private GestureDetector mGestureDetector;     
      
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
          
        mGestureDetector = new GestureDetector(new simpleGestureListener());  
          
        TextView tv = (TextView)findViewById(R.id.tv);  
        tv.setOnTouchListener(this);  
        tv.setFocusable(true);     
        tv.setClickable(true);     
        tv.setLongClickable(true);   
    }  
      
    public boolean onTouch(View v, MotionEvent event) {  
        // TODO Auto-generated method stub  
        return mGestureDetector.onTouchEvent(event);     
    }  
  
    private class simpleGestureListener extends  
            GestureDetector.SimpleOnGestureListener {  
          
        /*****OnGestureListener的函數*****/  
  
        final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;    
          
        // 觸發條件 ：     
        // X軸的座標位移大於FLING_MIN_DISTANCE，且移動速度大於FLING_MIN_VELOCITY個像素/秒     
         
        // 參數解釋：     
        // e1：第1個ACTION_DOWN MotionEvent     
        // e2：最後一個ACTION_MOVE MotionEvent     
        // velocityX：X軸上的移動速度，像素/秒     
        // velocityY：Y軸上的移動速度，像素/秒     
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
              
              
            if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE    
                    && Math.abs(velocityX) > FLING_MIN_VELOCITY) {    
                // Fling left     
                Log.i("MyGesture", "Fling left");    
                Toast.makeText(MainActivity.this, "Fling Left", Toast.LENGTH_SHORT).show();    
            } else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE    
                    && Math.abs(velocityX) > FLING_MIN_VELOCITY) {    
                // Fling right     
                Log.i("MyGesture", "Fling right");    
                Toast.makeText(MainActivity.this, "Fling Right", Toast.LENGTH_SHORT).show();    
            }    
            return true;  
        }  
  
    }  
}  

這段代碼難度不大,就不再細講,看下效果:

源碼在博客底部給出。

源碼地址：http://download.csdn.net/detail/harvic880925/7978943

請大家尊重原創者版權，轉載請標明出處：http://blog.csdn.net/harvic880925/article/details/39520901 謝謝！！

飛魚_

發佈了32 篇原創文章 · 獲贊 45 · 訪問量 13萬+

私信關注

Android手勢識別GestureDetector詳解

一、概述

二、GestureDetector.OnGestureListener---接口

1、基本講解

2、實例

三、GestureDetector.OnDoubleTapListener---接口

1、構建

2、函數講解：

四、GestureDetector.SimpleOnGestureListener---類

五、OnFling應用——識別向左滑還是向右滑

一、概述

二、GestureDetector.OnGestureListener---接口

1、基本講解

2、實例

三、GestureDetector.OnDoubleTapListener---接口

1、構建

2、函數講解：

四、GestureDetector.SimpleOnGestureListener---類

五、OnFling應用——識別向左滑還是向右滑

前端使用 Konva 實現可視化設計器（13）- 折線 - 最優路徑應用【思路篇】

AndroidStudio 引用第三方庫

TV端 RecyclerView長按導致item焦點亂飛或丟失

知識點記錄

Android手勢識別GestureDetector詳解

史上最詳細Fragment講解

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結