多点触摸手势就是多个指针（手指）同时触摸屏幕。本课介绍如何检测涉及多个指针的手势。
跟踪多个指针(Track Multiple Pointers)
当多个指针同时触摸屏幕时，系统会生成以下触摸事件：
- ACTION_DOWN 触摸屏幕的第一个指针。启动手势，指针索引始终为0。
- ACTION_POINTER_DOWN 第一个指针之外的其它进入屏幕的指针。其指针索引由getActionIndex()返回。
- ACTION_MOVE press手势期间指针发生了更改。
- ACTION_POINTER_UP 非主指针离开屏幕。
- ACTION_UP 最后一个指针离开屏幕。
您通过每个指针的索引和ID跟踪MotionEvent中的各个指针：
- 索引(Index)：MotionEvent将有关每个指针的信息存储在数组中。指针的索引是其在此数组内的位置。用于与指针交互的大多数MotionEvent方法都将指针索引作为参数，而不是指针ID。
- ID：每个指针还具有一个ID映射，在触摸事件中保持持续，以允许跨整个手势跟踪单个指针。
单个指针在运动事件中出现的顺序是未定义的。因此，指针的索引可以从一个事件改变到下一个事件，但是只要指针保持活动，指针的指针ID就保持不变。使用getPointerId()方法来获取指针的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的动作(Get a MotionEvent's Action)
您应该始终使用getActionMasked()来获取MotionEvent的动作。
与旧的getAction()方法不同，它被设计成支持多个指针。
它返回正在执行的动作，而不包括指针索引位。
然后，您可以使用getActionIndex()返回与该操作相关联的指针的索引。
这在下面的代码片段中说明。
注意：此示例使用MotionEventCompat类。 该类在支持库中。
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 "";
}
