Android GestureDetector的使用

GestureDetector

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

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

构造方法：

已过时的有2个，不推荐使用。

GestureDetector(GestureDetector.onGestureListener listener);

GestureDetector(GestureDetector.onGestureListener listener,Handler handler);

推荐使用：

 GestureDeterctor(Context context,GestureDetector.onGestureListener listener);

 GestureDeterctor(Context context,GestureDetector.onGestureListener listener,Handler handler);

 GestureDeterctor(Context context,GestureDetector.onGestureListener listener,Handler handler,boolean unused);

参数handler主要用来执行延时操作时使用，参数unused暂时没有使用。

从构成函数可以看出，当我们需要创建一个GestureDetector对象时，必须给它传一个GestureDetector.onGestureListener对象，查看API之后，发现它是个接口（interface），创建GestureDetector.onGestureListener的对象时，必须实现一下几个方法：

1、onDown(MotionEvent e);

      当用户按下时的回调。

2、onFling(MotionEvent e1,MontionEvent 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轴上的移动速度，像素/秒

3、onLongPress(MotionEvent e);

      长按触摸屏，超过一定时长，就会触发这个事件
      触发顺序：
      onDown->onShowPress->onLongPress

4、onScroll(MotionEvent e1,MotionEvent e2,float distanceX,float distanceY);

      在屏幕上拖动事件。无论是用手拖动view，或者是以抛的动作滚动，都会多次触发,这个方法          在ACTION_MOVE动作发生时就会触发
      滑屏：手指触动屏幕后，稍微滑动后立即松开
      onDown-----》onScroll----》onScroll----》onScroll----》………----->onFling
      拖动
      onDown------》onScroll----》onScroll------》onFiling

5、onShowPress(MotionEvent e);

      如果是按下的时间超过瞬间，而且在按下的时候没有松开或者是拖动的，那么onShowPress就        会执行。

6、onSingleTapUp(MotionEvent e);

      从名子也可以看出,一次单独的轻击抬起操作,也就是轻击一下屏幕，立刻抬起来，才会有这个        触发，当然,如果除了Down以外还有其它操作,那就不再算是Single操作了,所以也就不会触发这        个事件
      触发顺序：
      点击一下非常快的（不滑动）Touchup：
      onDown->onSingleTapUp->onSingleTapConfirmed
      点击一下稍微慢点的（不滑动）Touchup：
      onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed

有了这个监听之后，我们还可以给GestureDetector设置双击监听，使用的方法是：

mGestureDetector.setOnDoubleTapListener(GestureDetector.OnDoubleTapListener onDoubleListener);

参数是双击监听的对象，GestureDetector.OnDoubleTapListener它也是一个接口（interface），创建它的对象时，也必须实现以下几个方法。

1、onDoubleTap(MotionEvent e);

      当用户双击时回调。

2、onDoubleTapEvent(MotionEvent e);

      双击间隔中发生的动作。指触发onDoubleTap以后，在双击之间发生的其它动作，包含                  down、up和move事件

3、onSingleTapConfirmed(MotionEvent e);

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

      上面的两个监听，回调函数都是必须实现，有时候我们不需要监听所有的事件，只对自己感兴趣的事件进行监听，GestureDetector有个内部类帮我们实现此功能GestureDetector.SimpleOnGestureListener,该类实现了GestureDetector.onGestureListener、GestureDetector.onDoubleTapListener、GestureDetector.onContextClickListener这三个接口，并实现了它们的方法，只不过是空实现，在我们需要这三个接口的时候，我们可以创建GestureDetector.SimpleOnGestureListener对象，然后需要监听哪个事件，我们就重写它的哪个方法，下面我把它的所有方法都实现了，其实和上边两个接口实现的方法是一样。

GestureDetector.SimpleOnGestureListener mGestureDetector = new SimpleOnGestureListener(){ 
  
   @Override
   public boolean onSingleTapUp(MotionEvent e) { 
    return super.onSingleTapUp(e); 
   } 
  
   @Override
   public void onLongPress(MotionEvent e) { 
    super.onLongPress(e); 
   } 
  
   @Override
   public boolean onScroll(MotionEvent e1, MotionEvent e2, 
     float distanceX, float distanceY) { 
    return super.onScroll(e1, e2, distanceX, distanceY); 
   } 
  
   @Override
   public boolean onFling(MotionEvent e1, MotionEvent e2, 
     float velocityX, float velocityY) { 
    return super.onFling(e1, e2, velocityX, velocityY); 
   } 
  
   @Override
   public void onShowPress(MotionEvent e) { 
    super.onShowPress(e); 
   } 
  
   @Override
   public boolean onDown(MotionEvent e) { 
    return super.onDown(e); 
   } 
  
   @Override
   public boolean onDoubleTap(MotionEvent e) { 
    return super.onDoubleTap(e); 
   } 
  
   @Override
   public boolean onDoubleTapEvent(MotionEvent e) { 
    return super.onDoubleTapEvent(e); 
   } 
  
   @Override
   public boolean onSingleTapConfirmed(MotionEvent e) { 
    return super.onSingleTapConfirmed(e); 
   } 
     
  }; 

OnGestureListener使用过程

第一步：

首先创建一个OnGestureListener手势操作接口的实现类，并重写这些方法，如果一些手势不需要处理，则无需进行重写。

private class SimpleOnGesture extends GestureDetector.SimpleOnGestureListener {
        @Override
        public boolean onSingleTapConfirmed(MotionEvent e) {
            Logger.i("onSingleTapConfirmed");
            return false;
        }

        @Override
        public boolean onDoubleTap(MotionEvent e) {
            Logger.i("onDoubleTap");
            return false;
        }
    }

第二步：

初始化控件，然后初始化GestureDetector，并在GestureDetector构建时，将OnGestureListener接口的实现类添加进去。最后，执行控件的onTouchListener事件的注册，并在重写的onTouch方法中，通过GestureDetector对touch事件进行onTouchEvent派发，使MotionEvent被GestureDetector所消费，代码如下所示:

mGestureDetector = new GestureDetector(this, new SimpleOnGesture());
        mBinding.videoV.setOnTouchListener((v, event) -> {
            mGestureDetector.onTouchEvent(event);
            return true;
        });

参考资料：GestureDetector - Android中文版 - API参考文档