编写：Andrwyw
项目：Android Training中文版
原文：http://developer.android.com/training/gestures/detector.html

检测常用的手势

当用户用一根或多根手指触碰屏幕时，一个“触摸手势”就发生了，并且你的应用可把这样的触摸方式解释成一种特定的手势。手势检测有以下两个相应的阶段：

收集触摸事件的相关数据。
分析这些数据，看它们是否满足任何一种你的app所支持的手势的标准。

支持库中的类

本节课程的示例程序使用的是GestureDetectorCompat类和 MotionEventCompat类。这些类都在 Support Library中。你可以通过使用支持库中的类，来为运行着Android1.6及以上系统的设备提供兼容性功能。需要注意的一点是，MotionEventCompat类不是MotionEvent类的替代品，而是提供了一些静态工具类函数，你可以把MotionEvent对象作为参数传递给这些函数，从而得到与事件相关的动作(action)。

收集数据

当用户用一根或多根手指触碰屏幕时，接收触摸事件的View的onTouchEvent()函数就会被回调。对于一系列连续的触摸事件（位置、压力、大小、额外的一根手指等等），onTouchEvent()会被调用若干次，并且最终识别为一种手势。

手势开始于用户刚触摸屏幕时，其后系统会持续地追踪用户手指的位置，用户手指都离开屏幕时手势结束。在整个交互期间，MotionEvent被分发给onTouchEvent()函数，来提供每次交互的详细信息。你的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可以让你更简单地检测常见手势，并且无需自行处理单个的触摸事件。相关内容将会在下面的Detect Gestures中讨论。

捕获单个view对象的触摸事件

除了使用onTouchEvent()来捕获触摸事件，你也可以使用setOnTouchListener()函数给任意View对象关联一个 View.OnTouchListener对象来捕获触摸事件。这样做可以让你不继承已有的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型的函数返回值是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型函数，并且都返回false。因此,你可以仅仅重写你所需要的函数。比如，下面的代码段中创建了一个继承[GestureDetector.SimpleOnGestureListener](http://developer.android.com/reference/android/view/GestureDetector.SimpleOnGestureListener.html)的类，并且只重写了[onFling()](http://developer.android.com/reference/android/view/GestureDetector.OnGestureListener.html#onFling(android.view.MotionEvent,android.view.MotionEvent,float,float))和[onDown()](http://developer.android.com/reference/android/view/GestureDetector.OnGestureListener.html#onDown(android.view.MotionEvent))函数。

无论你是否使用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;
		}
	}
}