GestureDetector 可以使用 MotionEvents 检测各种手势和事件。

这个类只能用于检测触摸事件的 MotionEvent

GestureDetector有三个内部接口，两个内部类

三个核心接口

OnGestureListener

OnDoubleTapListener

OnContextClickListener

他们都是起到监听器的作用

两个内部类：

SimpleOnGestureListener

注意：SimpleOnGestureListener继承了GestureDetector的三个内部接口

GestureHandler

处理GestureDetector类的数据

构造方法

GestureDetector自带了五个构造方法，但是有两个被废弃了

public GestureDetector(Context context, OnGestureListener listener)

public GestureDetector(Context context, OnGestureListener listener, Handler handler)

public GestureDetector(Context context, OnGestureListener listener, Handler handler, boolean unused){this(context, listener, handler);}

因为第三个调用第二个，所以只要关注前面两个就行了

我们发现第二个构造方法中多了一个Handler变量

一般来说，不会使用这个构造方法

但是因为GestureDetector中的数据是给GestureHandler内部类进行处理，这个类会使用Handle，由Handler的知识知道，创建Handler必须有Looper，但是在一些新开的线程中没有创建Looper，所以我们需要传入一个带了Looper的Handler变量，否则，GestureDetector对象会创建失败

SimpleOnGestureListener类的方法：

//下面的6个方法继承自OnGestureListener

public boolean onSingleTapUp( MotionEvent e)

当用户单击时触发

public void onLongPress (MotionEvent e )

当用户手指在长按屏幕时触发

public boolean onScroll (MotionEvent e1 , MotionEvent e2 ,float distanceX , float distanceY)

当用户手指在屏幕上拖动时触发

后面两个变量时在X,Y上移动的距离

public boolean onFling ( MotionEvent e1 ,MotionEvent e2 , float velocityX , float velocityY)

当用户手指拖动后，手指离开屏幕时触发

这个方法常用来使手指离开后页面仍然可以滑动(速度慢慢变小)

后两个变量表示手指在X,Y两个方向上的速度

public void onShowPress (MotionEvent e)

当用户手指按下，但没有移动时触发该方法

public boolean onDown ( MotionEvent e)

当按下时触发该方法，所有手势第一个必定触发该方法

//下面的三个方法继承自OnDoubleTapListener

public boolean onDoubleTap (MotionEvent e)

当用户双击时触发

public boolean onDoubleTapEvent (MotionEvent e)

在双击事件确定发生时会对第二次按下产生的 MotionEvent 信息进行回调。

public boolean onSingleTapConfirmed ( MotionEvent e)

当单击事件确定后进行回调

//下面的这个方法继承自ContextClickListener

onContextClick ( MotionEvent e)

用于检测外部设备上的按钮是否按下的，例如蓝牙触控笔上的按钮，一般情况下，忽略即可。

如果侦听 onContextClick(MotionEvent)，

则必须在 View 的onGenericMotionEvent(MotionEvent)中

调用 GestureDetector OnGenericMotionEvent(MotionEvent)。

手势的常用事件

按下

public boolean onDown (MotionEvent e)

按下是所以手势必定有的动作

所以无论什么手势，第一个调用的方法就是onDown

注意：

GestureDetector的点击对图片，按钮等无用

为了解决这个问题，我们可以

onDown返回true(根据响应中的先回调，后监听)

图片等的xml文件中设置android:Clickable="true"

单击：

public boolean onSingleTapUp( MotionEvent e)

public boolean onSingleTapConfirmed ( MotionEvent e)

这两个方法都可以响应到单击事件，但是他们之间还是有区别的

当我们同时在监听器中覆写这两个方法，并且进行单击事件

我们会发现当进行单击事件的时候，这几个方法响应的顺序是这样的

onDown() -> onSingleTapUp() -> onSingleCofirmed()

首先onDown()必定是第一个执行的，但是会发现onSingleTapUp在onSingleComfirmed之前执行

我查阅了相关文档，发现他们虽然同样响应的是当手指离开屏幕的活动，但是onSingleTapUp是立即执行，而onSingleComfirmed却要在离开后300ms后才执行 ，这样的目的是确认我们进行的是单击事件(为了防止我们在300ms内再次进行单击事件)，所以他们的名字分别是Up和Comfirmed

所以，在设置双击事件时，最好使用onSingleComfirmed()，进行双击时不会回调单击方法

双击

public boolean onDoubleTap (MotionEvent e)

public boolean onDoubleTapEvent (MotionEvent e)

这两个方法都可以响应双击事件，为了验证他们的区别，我们同样在一个响应器中覆写这两个方法，并且进行双击事件(我们这里单击事件使用onSingleComfirmed)

我们使用Log.e()把方法响应的顺序弄出来，发现他们规律很神奇

onDown() -> onDoubleTap() -> onDoubleTapEvent() -> onDown()-> onDoubleTapEvent() ->onDoubleTapEvent()(不定数目个)

然后我在onDoubleTapEvent()中吧MotionEvent e 输出,

然后方法响应的顺序变成：

onDown() -> onDoubleTap() -> onDoubleTapEvent() -> onDown()-> onDoubleTapEvent() Down -> onDoubleTapEvent()Move(不定数目个) ->onDoubleTapEvent() Up

我们对以上信息进行分析：

DoubleTap在DoubleTapEvent前面执行，但是根据DoubleTapEvent的第一个MotionEvent是Down，所以判断双击的响应条件是在第一次单击后的300ms内按下手指

我们又尝试在双击后手指不离开屏幕，可见随时间的延长，Move也变得更多，

由此判断，onDoubleTapEvent是实时回调的，并且是用来检测MotionEvent

长按

public void onShowPress (MotionEvent e)

public void onLongPress (MotionEvent e)

这次我们在响应器中覆写所有方法，进行长按操作

发现方法响应的顺序为：

onDown -> onShowPress -> onLongPress

也就是说，在长按时，onShowPress在onLongPress前面执行

滑动/拖动

public void onScroll (MotionEvent e)

public void onFling (MotionEvent e)

同样，我们覆写所有方法，进行滑动操作,

发现方法的响应顺序为

onDown -> onScroll -> 不定量个onScroll ->onScroll -> onFiling

由此可见，在滑动/拖动过程中，不断调用onScroll，最后调用onFiling

当然，Android自带的手势不能完全满足我们的需求，于是Android提供了自建手势的方法，这些内容将在下一篇博客中陈述