android 處理多點觸控手勢

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

多點觸控手勢是指在同一時間有多點（手指）觸碰螢幕。本節課程講述，如何檢測涉及多點的觸控手勢。

追蹤多點

當多個手指同時觸控螢幕時，系統會產生如下的觸控事件：

• ACTION_DOWN - 針對觸控螢幕的第一個點。此事件是手勢的開端。第一觸控點的資料在MotionEvent中的索引總是0。
• ACTION_POINTER_DOWN - 針對第一點後，出現在螢幕上額外的點。這個點的資料在MotionEvent中的索引，可以通過getActionIndex()獲得。
• ACTION_MOVE - 在按下手勢期間發生變化。
• ACTION_POINTER_UP - 當非主要點（non-primary pointer）離開螢幕時，傳送此事件。
• ACTION_UP - 當最後一點離開螢幕時傳送此事件。

我們可以通過各個點的索引以及id，單獨地追蹤MotionEvent中的每個點。

• Index：MotionEvent把各個點的資訊都儲存在一個陣列中。點的索引值就是它在陣列中的位置。大多數用來與點互動的MotionEvent函式都是以索引值而不是點的ID作為引數的。
• ID：每個點也都有一個ID對映，該ID對映在整個手勢期間一直存在，以便我們單獨地追蹤每個點。

每個獨立的點在移動事件中出現的次序是不固定的。因此，從一個事件到另一個事件，點的索引值是可以改變的，但點的ID在它的生命週期內是保證不會改變的。使用getPointerId()可以獲得一個點的ID，在手勢隨後的移動事件中，就可以用該ID來追蹤這個點。對於隨後一系列的事件，可以使用findPointerIndex()函式，來獲得對應給定ID的點在移動事件中的索引值。如下：

private int mActivePointerId;

public boolean onTouchEvent(MotionEvent event) {
    ....
    // Get the pointer ID
    mActivePointerId = event.getPointerId(0);

    // ... Many touch events later...

    // Use the pointer ID to find the index of the active pointer
    // and fetch its position
    int pointerIndex = event.findPointerIndex(mActivePointerId);
    // Get the pointer's current position
    float x = event.getX(pointerIndex);
    float y = event.getY(pointerIndex);
}

獲取MotionEvent的動作

我們應該總是使用getActionMasked()函式（或者用MotionEventCompat.getActionMasked()這個相容版本更好）來獲取MotionEvent的動作(action)。與舊的getAction()函式不同的是，getActionMasked()是設計用來處理多點觸控的。它會返回執行過的動作的掩碼值，不包括點的索引位。然後，我們可以使用getActionIndex()來獲得與該動作關聯的點的索引值。這在接下來的程式碼段中可以看到。

Note: 這個樣例使用的是MotionEventCompat類。該類在Support Library中。我們應該使用MotionEventCompat類，來提供對更多平臺的支援。需要注意的一點是，MotionEventCompat並不是MotionEvent類的替代品。準確來說，它提供了一些靜態工具類函式，我們可以把MotionEvent物件作為引數傳遞給這些函式，來得到與事件相關的動作。

int action = MotionEventCompat.getActionMasked(event);
// Get the index of the pointer associated with the action.
int index = MotionEventCompat.getActionIndex(event);
int xPos = -1;
int yPos = -1;

Log.d(DEBUG_TAG,"The action is " + actionToString(action));

if (event.getPointerCount() > 1) {
    Log.d(DEBUG_TAG,"Multitouch event");
    // The coordinates of the current screen contact, relative to
    // the responding View or Activity.
    xPos = (int)MotionEventCompat.getX(event, index);
    yPos = (int)MotionEventCompat.getY(event, index);

} else {
    // Single touch event
    Log.d(DEBUG_TAG,"Single touch event");
    xPos = (int)MotionEventCompat.getX(event, index);
    yPos = (int)MotionEventCompat.getY(event, index);
}
...

// Given an action int, returns a string description
public static String actionToString(int action) {
    switch (action) {

        case MotionEvent.ACTION_DOWN: return "Down";
        case MotionEvent.ACTION_MOVE: return "Move";
        case MotionEvent.ACTION_POINTER_DOWN: return "Pointer Down";
        case MotionEvent.ACTION_UP: return "Up";
        case MotionEvent.ACTION_POINTER_UP: return "Pointer Up";
        case MotionEvent.ACTION_OUTSIDE: return "Outside";
        case MotionEvent.ACTION_CANCEL: return "Cancel";
    }
    return "";

}

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