android 檢測常用的手勢

編寫:Andrwyw - 原文:http://developer.android.com/training/gestures/detector.html

當使用者把用一根或多根手指放在觸控式螢幕上，並且應用把這樣的觸控方式解釋為特定的手勢時，“觸控手勢”就發生了。相應地，檢測手勢也就有以下兩個階段：

1. 收集觸控事件的相關資料。
2. 分析這些資料，看它們是否符合app所支援的手勢的標準。

Support Library 中的類

本節課程的示例程式使用了GestureDetectorCompat和MotionEventCompat類。這些類都是在 Support Library 中定義的。如果有可能的情況話，我們應該使用 Support Library 中的類，來為執行著Android1.6及以上版本系統的裝置提供相容性功能。需要注意的一點是，MotionEventCompat並不是MotionEvent的替代品，而是提供了一些靜態工具類函式。我們可以把MotionEvent物件作為引數傳遞給這些工具類函式，來獲得與觸控事件相關的動作(action)。

收集資料

當使用者把用一根或多根手指放在觸控式螢幕上時，會觸發 View 上用於接收觸控事件的 onTouchEvent() 回撥函式。對於一系列連續的、最終會被識別為一種手勢的觸控事件（位置、壓力、大小、新增另一根手指等等），onTouchEvent()會被呼叫若干次。

當使用者第一次觸控螢幕時，手勢就開始了。其後系統會持續地追蹤使用者手指的位置，在使用者手指全都離開螢幕時，手勢結束。在整個互動期間，被分發給 onTouchEvent() 函式的 MotionEvent 物件，提供了每次互動的詳細資訊。我們的app可以使用 MotionEvent 提供的這些資料，來判斷某種特定的手勢是否發生了。

為Activity或View捕獲觸控事件

為了捕獲Activity或View中的觸控事件，我們可以重寫onTouchEvent()回撥函式。

接下來的程式碼段使用了getActionMasked()函式，來從 event 引數中抽取出使用者執行的動作。它提供了一些原始的觸控資料，我們可以使用這些資料，來判斷某個特定手勢是否發生了。

public class MainActivity extends Activity {
...
// This example shows an Activity, but you would use the same approach if
// you were subclassing a View.
@Override
public boolean onTouchEvent(MotionEvent event){

        int action = MotionEventCompat.getActionMasked(event);

        switch(action) {
                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);
        }
}

然後，我們可以對這些事件做些自己的處理，以判斷某個手勢是否出現了。這種是針對自定義手勢，我們所需要進行的處理。然而，如果我們的app僅僅需要一些常見的手勢，如雙擊，長按，快速滑動（fling）等，那麼我們可以使用GestureDetector類來完成。 GestureDetector可以讓我們簡單地檢測常見手勢，並且無需自行處理單個觸控事件。相關內容將會在下面的檢測手勢中討論。

捕獲單個view的觸控事件

作為onTouchEvent()的一種替換方式，我們也可以使用 setOnTouchListener() 函式，來把View.OnTouchListener 關聯到任意的View上。這樣可以在不繼承已有的 View 的情況下，也能監聽觸控事件。比如:

View myView = findViewById(R.id.my_view);
myView.setOnTouchListener(new OnTouchListener() {
public boolean onTouch(View v, MotionEvent event) {
        // ... Respond to touch events
        return true;
    }
});

建立listener物件時，注意 ACTION_DOWN 事件返回 false 的情況。如果返回 false，會讓listener物件接收不到後續的ACTION_MOVE、ACTION_UP等系列事件。這是因為ACTION_DOWN事件是所有觸控事件的開端。

如果我們正在寫一個自定義View，我們也可以像上面描述的那樣重寫onTouchEvent()函式。

檢測手勢

Android提供了GestureDetector類來檢測常用的手勢。它所支援的手勢包括onDown()、onLongPress()、onFling() 等。我們可以把GestureDetector和上面描述的onTouchEvent()函式結合在一起使用。

檢測所有支援的手勢

當我們例項化一個GestureDetectorCompat物件時，需要一個實現了GestureDetector.OnGestureListener介面的類作為引數。當某個特定的觸控事件發生時，GestureDetector.OnGestureListener就會通知使用者。為了讓我們的GestureDetector物件能到接收到觸控事件，我們需要重寫 View 或 Activity 的 onTouchEvent() 函式，並且把所有捕獲到的事件傳遞給 detector 例項。

接下來的程式碼段中，on<TouchEvent> 型的函式的返回值是 true，意味著我們已經處理完這個觸控事件了。如果返回 false，則會把事件沿view棧傳遞，直到觸控事件被成功地處理了。

執行下面的程式碼段，來了解當我們與觸控式螢幕互動時，動作（action）是如何觸發的，以及每個觸控事件MotionEvent中的內容。我們也會意識到，一個簡單的互動會產生多少的資料。

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){
        this.mDetector.onTouchEvent(event);
        // Be sure to call the superclass implementation
        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 e1, MotionEvent e2, float distanceX,
            float distanceY) {
        Log.d(DEBUG_TAG, "onScroll: " + e1.toString()+e2.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類，最好都實現 onDown() 函式並且返回 true。這是因為所有的手勢都是由 onDown() 訊息開始的。如果讓 onDown() 函式返回 false，就像GestureDetector.SimpleOnGestureListener類中預設實現的那樣，系統會假定我們想忽略剩餘的手勢，GestureDetector.OnGestureListener中的其他函式也就永遠不會被呼叫。這可能會導致我們的app出現意想不到的問題。僅僅當我們真的想忽略全部手勢時，我們才應該讓 onDown() 函式返回 false。

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){
        this.mDetector.onTouchEvent(event);
        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;
        }
    }

}

轉自：http://hukai.me/android-training-course-in-chinese/input/gestures/detector.html