image.png

..

GestureDetector

在 android 开发过程中，经常需要对一些手势，如：单击、双击、长按、滑动、缩放等，进行监测。

这时也就引出了手势监测的概念，所谓的手势监测，也就是GestureDetector 。

一般情况下，我们知道View类有个View.OnTouchListener内部接口，通过重写他的onTouch(View v, MotionEvent event)方法，我们可以处理一些touch事件，但是这个方法太过简单，如果需要处理一些复杂的手势，用这个接口就会很麻烦。

image.png

Android sdk给我们提供了GestureDetector（类，通过这个类我们可以识别很多的手势，主要是通过他的onTouchEvent(event)方法完成了不同手势的识别。

双击

比如实现双击，正常的逻辑是：

1. 首先重写 onTouchEvent 方法
2. 当第一次点击后，咱们先判断是否为需要监听的控件
3. 如果是则 new 一个线程，开始倒计时（如 1s）
4. 如果在这个倒计时的期间，再次调用了点击事件
5. 判断成功、发生双击事件

这样闲的逻辑很麻烦。

GestureDetector这个类对外提供了两个接口和一个外部类
接口：OnGestureListener，OnDoubleTapListener
内部类:SimpleOnGestureListener

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

GestureDetector.OnGestureListener

监听类中有六个函数要重写：

1. OnDown(MotionEvent e)
   用户按下屏幕就会触发；
2. onShowPress(MotionEvent e)
   如果是按下的时间超过瞬间，而且在按下的时候没有松开或者是拖动的，那么onShowPress就会执行。
3. onLongPress(MotionEvent e)
   长按触摸屏，超过一定时长，就会触发这个事件
   触发顺序：
   onDown->onShowPress->onLongPress
4. onSingleTapUp(MotionEvent e)
   从名子也可以看出,一次单独的轻击抬起操作,也就是轻击一下屏幕，立刻抬起来，才会有这个触发，当然,如果除了Down以外还有其它操作,那就不再算是Single操作了,所以也就不会触发这个事件
   触发顺序：
   点击一下非常快的（不滑动）Touchup：
   onDown->onSingleTapUp->onSingleTapConfirmed
   点击一下稍微慢点的（不滑动）Touchup：
   onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
5. onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY)
   滑屏，用户按下触摸屏、快速移动后松开，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE, 1个ACTION_UP触发
   参数解释：
   e1：第1个ACTION_DOWN MotionEvent
   e2：最后一个ACTION_MOVE MotionEvent
   velocityX：X轴上的移动速度，像素/秒
   velocityY：Y轴上的移动速度，像素/秒
6. onScroll(MotionEvent e1, MotionEvent e2,float distanceX, float distanceY)
   在屏幕上拖动事件。无论是用手拖动view，或者是以抛的动作滚动，都会多次触发,这个方法 在ACTION_MOVE动作发生时就会触发
   滑屏：手指触动屏幕后，稍微滑动后立即松开
   onDown-----》onScroll----》onScroll----》onScroll----》………----->onFling
   拖动
   onDown------》onScroll----》onScroll------》onFiling

代码实例：

private class gesturelistener implements GestureDetector.OnGestureListener{  
  
    public boolean onDown(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public void onShowPress(MotionEvent e) {  
        // TODO Auto-generated method stub  
          
    }  
  
    public boolean onSingleTapUp(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onScroll(MotionEvent e1, MotionEvent e2,  
            float distanceX, float distanceY) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public void onLongPress(MotionEvent e) {  
        // TODO Auto-generated method stub  
          
    }  
  
    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
            float velocityY) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
      
}  

GestureDetector.OnDoubleTapListener

双击监听，主要实现三个函数：

1. onSingleTapConfirmed(MotionEvent e)
   单击事件。用来判定该次点击是SingleTap而不是DoubleTap，如果连续点击两次就是DoubleTap手势，如果只点击一次，系统等待一段时间后没有收到第二次点击则判定该次点击为SingleTap而不是DoubleTap，然后触发SingleTapConfirmed事件。
   触发顺序是：OnDown->OnsingleTapUp->OnsingleTapConfirmed
2. onDoubleTap(MotionEvent e)
   双击事件
3. onDoubleTapEvent(MotionEvent e)
   双击间隔中发生的动作。指触发onDoubleTap以后，在双击之间发生的其它动作，包含down、up和move事件.

实例代码：

private class doubleTapListener implements GestureDetector.OnDoubleTapListener{  
  
    public boolean onSingleTapConfirmed(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onDoubleTap(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
  
    public boolean onDoubleTapEvent(MotionEvent e) {  
        // TODO Auto-generated method stub  
        return false;  
    }  
}  

参考

用户手势检测-GestureDetector使用详解