Android之触摸手势检测GestureDetector使用详解

在Android中，当用户触摸屏幕的时候，会产生许多手势，例如down，up，scroll，filing，onSingleTapConfirmed(单击)，onDoubleTap(双击)等等。

一般情况下，我们知道View类有个View.OnTouchListener内部接口，通过重写他的onTouch(View v, MotionEvent event)方法，我们可以处理一些在该控件中触发的touch事件，但是这个方法太过简单，如果需要处理一些复杂的手势，用这个接口就会很麻烦（因为我们要自己根据用户触摸的轨迹去判断是什么手势），所以我们常常需要在这个方法中用手势识别器中的onTouchEvent(event)方法去拦截到触摸事件至手势识别器中处理。

一、Android sdk给我们提供了GestureDetector（Gesture：手势Detector：识别）类，通过这个类我们可以识别很多的手势，主要是通过他自身的onTouchEvent(event)方法完成了不同手势的识别。他虽然能识别各种手势，但是不同的手势要怎么处理，就需要根据我们自己的需要去实现它内部的三个接口：

接口：OnGestureListener手势识别接口，OnDoubleTapListener双击与单击识别接口 

内部类:SimpleOnGestureListener  这个内部类是静态内部类，实现了OnGestureListener, OnDoubleTapListener接口，相当于是这两个接口功能的集合

从GestureDetector手势识别类源码中我们也可以清楚的看到这个类中的各个构造方法和接口：

从源码中可以看出，GestureDetector的构造函数中只能传入OnGestureListener接口对象，也就是说，要使用OnDoubleTapListener接口，可以通过setOnDoubleTapListener()设置监听器来实现，但是必须先构造出GestureDetector对象，要构造GestureDetector对象就必须实现OnGestureListener接口。或者使用SimpleOnGestureListener这个内部类，然后自己重写对应的方法。所以不管什么方法要用OnDoubleTapListener接口，就必须先实现OnGestureListener接口。

这个内部类，其实是两个接口中所有函数的集成，它包含了这两个接口里所有必须要实现的函数而且都已经重写，但所有方法体都是空的；不同点在于：该类是static class，我们如果需要用这个内部类，就可以在外面继承这个类，重写里面的手势处理方法。

下面我们先看OnGestureListener接口；

二、GestureDetector.OnGestureListener---接口

1、基本讲解

如果我们要实现OnGestureListener接口，会提示有几个必须重写的函数，加上之后是这个样子的：

detector = new GestureDetector(this, new OnGestureListener() {
 
	@Override
	public boolean onSingleTapUp(MotionEvent e) {
		// TODO Auto-generated method stub
		return false;
	}
 
	@Override
	public void onShowPress(MotionEvent e) {
		// TODO Auto-generated method stub
 
	}
 
	@Override
	public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,
			float distanceY) {
		// TODO Auto-generated method stub
		return false;
	}
 
	@Override
	public void onLongPress(MotionEvent e) {
		// TODO Auto-generated method stub
 
	}
 
	@Override
	public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
			float velocityY) {
		// TODO Auto-generated method stub
		return false;
	}
 
	@Override
	public boolean onDown(MotionEvent e) {
		// 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  可以得到第一次按下时的X轴和Y轴的坐标，分别为：e1.getX(),e1.getY();

    e2：最后一个ACTION_MOVE MotionEvent     可以得到最后一次抬起时的X轴和Y轴的坐标，分别为：e2.getX(),e2.getY();

    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监听函数：

可以使用构造对象或者构造匿名对象：

<span style="font-size:18px;">new GestureDetector(this, new OnGestureListener() { });</span>

[java] view
plaincopy

1. GestureDetector.OnGestureListener listener = new GestureDetector.OnGestureListener(){
2. };

也可以构造类

[java] view
plaincopy

1. private class gestureListener implements GestureDetector.OnGestureListener{
2. }

2、创建GestureDetector实例mGestureDetector 

3、在onTouch(View v, MotionEvent event)中使用手势识别器中的onTouchEvent()方法拦截：

[java] view
plaincopy

1. public boolean onTouch(View v, MotionEvent event) {
2. return mGestureDetector.onTouchEvent(event);
3. }

4、控件绑定

[java] view
plaincopy

1. TextView tv = (TextView)findViewById(R.id.tv);
2. tv.setOnTouchListener(this);

三、GestureDetector.OnDoubleTapListener---接口

1、构建

有两种方式设置双击监听：

方法一：使用静态的内部类SimpleOnGestureListener

detector = new GestureDetector(this, new SimpleOnGestureListener(){
			@Override
			public boolean onFling(MotionEvent e1, MotionEvent e2,
					float velocityX, float velocityY) {//滑动
				// TODO Auto-generated method stub
				return super.onFling(e1, e2, velocityX, velocityY);
			}
 
			@Override
			public boolean onDoubleTap(MotionEvent e) {//双击
				// TODO Auto-generated method stub
				return super.onDoubleTap(e);
			}
 
			@Override
			public boolean onSingleTapConfirmed(MotionEvent e) {//单击
				// TODO Auto-generated method stub
				return super.onSingleTapConfirmed(e);
			}
			//自己重写需要用到的方法，这里我只重写了三个
		});

方法二：使用GestureDetector::setOnDoubleTapListener();函数设置监听：

// 设置双击监听器
detector.setOnDoubleTapListener(new OnDoubleTapListener() {
 
});

注意：大家可以看到无论在方法一还是在方法二中，都需要派生自GestureDetector.OnGestureListener，前面我们说过GestureDetector 的构造函数只能传入这一个接口。

可以看到，在构造函数中，除了后面要讲的SimpleOnGestureListener 以外的其它两个构造函数都必须是OnGestureListener的实例。所以要想使用OnDoubleTapListener的几个函数，就必须先实现OnGestureListener。

2、函数讲解：

首先看一下OnDoubleTapListener接口必须重写的三个函数：

// 设置双击监听器
		detector.setOnDoubleTapListener(new OnDoubleTapListener() {
 
			@Override
			public boolean onSingleTapConfirmed(MotionEvent e) {
				Toast.makeText(getApplicationContext(), "单击", 0).show();
				return true;//【注】返回ture，意思为该触摸事件被该回调函数消耗掉了，不会再返回给在我们拦截的方法中
			}
 
			@Override
			public boolean onDoubleTapEvent(MotionEvent e) {
				// TODO Auto-generated method stub
				return false;
			}
 
			@Override
			public boolean onDoubleTap(MotionEvent e) {
				Toast.makeText(getApplicationContext(), "双击", 0).show();
				return true;//【注】返回ture，意思为该触摸事件被该回调函数消耗掉了，不会再返回给在我们拦截的方法中
			}
		});

onSingleTapConfirmed(MotionEvent e)：单击事件。用来判定该次点击是SingleTap而不是DoubleTap，如果连续点击两次就是DoubleTap手势，如果只点击一次，系统等待一段时间后没有收到第二次点击则判定该次点击为SingleTap而不是DoubleTap，然后触发SingleTapConfirmed事件。触发顺序是：OnDown->OnsingleTapUp->OnsingleTapConfirmed

关于onSingleTapConfirmed和onSingleTapUp的一点区别： OnGestureListener有这样的一个方法onSingleTapUp，和onSingleTapConfirmed容易混淆。二者的区别是：onSingleTapUp，只要手抬起就会执行，而对于onSingleTapConfirmed来说，如果双击的话，则onSingleTapConfirmed不会执行。

onSingleTapConfirmed(MotionEvent e)：单击事件

onDoubleTap(MotionEvent e)：双击事件

onDoubleTapEvent(MotionEvent e)：指触发onDoubleTap以后，在双击之间发生的其它动作

下面我就把一个用来判断用户滑动的方法demo代码贴上来吧：

xml文件：

<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"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity" >
    <TextView
        android:id="@+id/textview1"
        android:layout_width="match_parent"
        android:layout_height="300dp"
        android:background="#a0a0ee" />
</RelativeLayout>

代码：

public class MainActivity extends Activity implements OnTouchListener {
	private GestureDetector detector;
 
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		TextView mTextView = (TextView) findViewById(R.id.textview1);
		mTextView.setOnTouchListener(this);// 如果单独为控件设置了触摸监听器，那么触摸操作只对该控件的区域里面有效，并用手势识别器中的onTouchEvent(event)方法去拦截到触摸事件至手势识别器中处理
		// [注]如果想触摸操作对全屏任意地方都有效，那么就不必单独为该控件设置触摸监听器，直接重写Activity中的onTouchEvent（）方法，并用手势识别器中的onTouchEvent(event)方法去拦截到触摸事件至手势识别器中处理就可以了
 
		// 设置手势监听器
		detector = new GestureDetector(this, new OnGestureListener() {
 
			@Override
			public boolean onSingleTapUp(MotionEvent e) {
 
				return false;
			}
 
			@Override
			public void onShowPress(MotionEvent e) {
				// TODO Auto-generated method stub
 
			}
 
			@Override
			public boolean onScroll(MotionEvent e1, MotionEvent e2,
					float distanceX, float distanceY) {
				// TODO Auto-generated method stub
				return false;
			}
 
			@Override
			public void onLongPress(MotionEvent e) {
				// TODO Auto-generated method stub
 
			}
			 /*
		     * 用户按下触摸屏、快速移动后松开即触发这个事件
		     * e1：第1个ACTION_DOWN MotionEvent
		     * e2：最后一个ACTION_MOVE MotionEvent
		     * velocityX：X轴上的移动速度，像素/秒
		     * velocityY：Y轴上的移动速度，像素/秒
		     * 触发条件 ：
		     * X轴的坐标位移大于FLING_MIN_DISTANCE，且移动速度大于FLING_MIN_VELOCITY个像素/秒
		     */
			@Override
			public boolean onFling(MotionEvent e1, MotionEvent e2,
					float velocityX, float velocityY) {
				final float FLING_MIN_DISTANCE = 100;
				final float FLING_MIN_VELOCITY = 150;
				if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE
						&& Math.abs(velocityX) > FLING_MIN_VELOCITY) {
					//X轴上的移动速度去绝对值进行比较
					//判断x轴坐标如果第一次按下时的坐标减去第二次离开屏幕时的坐标大于我们设置的位移，就说明此时是向左滑动的,坐标的原点位于该控件的左上角
					Toast.makeText(getApplicationContext(), "向左滑动", 0).show();
				}
				if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE
						&& Math.abs(velocityX) > FLING_MIN_VELOCITY) {
					//判断x轴坐标如果第二次离开屏幕时的坐标减去第一次按下时的坐标大于我们设置的位移，就说明此时是向右滑动的,坐标的原点位于该控件的左上角
					Toast.makeText(getApplicationContext(), "向右滑动", 0).show();
				}
				if (e2.getY() - e1.getY() > FLING_MIN_DISTANCE
						&& Math.abs(velocityY) > FLING_MIN_VELOCITY) {
					//判断Y轴坐标如果第二次离开屏幕时的坐标减去第一次按下时的坐标大于我们设置的位移，就说明此时是向下滑动的,坐标的原点位于该控件的左上角
					Toast.makeText(getApplicationContext(), "向下滑动", 0).show();
				}
				if (e1.getY() - e2.getY() > FLING_MIN_DISTANCE
						&& Math.abs(velocityY) > FLING_MIN_VELOCITY) {
					//判断Y轴坐标如果第一次按下屏幕时的坐标减去第二次离开屏幕时的坐标大于我们设置的位移，就说明此时是向上滑动的,坐标的原点位于该控件的左上角
					Toast.makeText(getApplicationContext(), "向上滑动", 0).show();
				}
				return true;//【注】返回ture，意思为该触摸事件被该回调函数消耗掉了，不会再返回给在我们拦截的方法中
			}
 
			@Override
			public boolean onDown(MotionEvent e) {
				// TODO Auto-generated method stub
				return true;//【注】任何时候都必须把这个设置为true，因为无论什么手势都会触发这个方法，只要碰到屏幕就会
			}
		});
		// 设置双击监听器
		detector.setOnDoubleTapListener(new OnDoubleTapListener() {
 
			@Override
			public boolean onSingleTapConfirmed(MotionEvent e) {
				Toast.makeText(getApplicationContext(), "单击", 0).show();
				return true;//【注】返回ture，意思为该触摸事件被该回调函数消耗掉了，不会再返回给在我们拦截的方法中
			}
 
			@Override
			public boolean onDoubleTapEvent(MotionEvent e) {
				// TODO Auto-generated method stub
				return false;
			}
 
			@Override
			public boolean onDoubleTap(MotionEvent e) {
				Toast.makeText(getApplicationContext(), "双击", 0).show();
				return true;//【注】返回ture，意思为该触摸事件被该回调函数消耗掉了，不会再返回给在我们拦截的方法中
			}
		});
	}
 
//	@Override
//	public boolean onTouchEvent(MotionEvent event) {// 从Activity中重写而来的方法，该回调函数在用户触摸整个屏幕任意地方时都会调用，并拦截触摸事件给手势识别器处理
//		// TODO Auto-generated method stub
//		return detector.onTouchEvent(event);
//	}
 
	@Override
	public boolean onTouch(View v, MotionEvent event) {// 控件设置mTextView.onTouchListener(this)触摸监听器时,重写的的方法,触摸事件只对该控件区域内有效，并用手势识别器中的onTouchEvent(event)方法去拦截到触摸事件至手势识别器中处理
		// TODO Auto-generated method stub
		return detector.onTouchEvent(event);
	}
 
}

再贴下效果图：

转载请注明出处-------