手势监听 GestureDetector.SimpleOnGestureListener

前言

当用户触摸屏幕的时候，会产生许多手势，例如down,up,scroll，filing等等，我们知道View类有个View.OnTouchListener内部接口，通过重写他的onTouch(View v, MotionEvent event)方法，我们可以处理一些touch事件，但是这个方法太过简单，如果需要处理一些复杂的手势，用这个接口就会很麻烦（因为我们要自己根据用户触摸的轨迹去判断是什么手势）

Android sdk给我们提供了GestureDetector（Gesture：手势Detector：识别）类，通过这个类我们可以识别很多的手势，主要是通过他的onTouchEvent(event)方法完成了不同手势的识别。虽然他能识别手势，但是不同的手势要怎么处理，应该是提供给程序员实现的，因此这个类对外提供了两个接口：OnGestureListener，OnDoubleTapListener，还有一个内部类SimpleOnGestureListener，SimpleOnGestureListener类是GestureDetector提供给我们的一个更方便的响应不同手势的类，这个类实现了上述两个接口（但是所有的方法体都是空的），该类是static class，也就是说它实际上是一个外部类。程序员可以在外部继承这个类，重写里面的手势处理方法。

通过GestureDetector的构造方法可以将SimpleOnGestureListener对象传递进去，这样GestureDetector能处理不同的手势了。

首先我们先看一下GestureDetector.SimpleOnGestureListener 共有那些方法（源码部分）：

 /**
     * A convenience class to extend when you only want to listen for a subset
     * of all the gestures. This implements all methods in the
     * {@link OnGestureListener}, {@link OnDoubleTapListener}, and {@link OnContextClickListener}
     * but does nothing and return {@code false} for all applicable methods.
     */
    public static class SimpleOnGestureListener implements OnGestureListener, OnDoubleTapListener,
            OnContextClickListener {

        public boolean onSingleTapUp(MotionEvent e) {
            return false;
        }

        public void onLongPress(MotionEvent e) {
        }

        public boolean onScroll(MotionEvent e1, MotionEvent e2,
                float distanceX, float distanceY) {
            return false;
        }

        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
                float velocityY) {
            return false;
        }

        public void onShowPress(MotionEvent e) {
        }

        public boolean onDown(MotionEvent e) {
            return false;
        }

        public boolean onDoubleTap(MotionEvent e) {
            return false;
        }

        public boolean onDoubleTapEvent(MotionEvent e) {
            return false;
        }

        public boolean onSingleTapConfirmed(MotionEvent e) {
            return false;
        }

        public boolean onContextClick(MotionEvent e) {
            return false;
        }
    }

以上是GestureDetector的一个内部类的形式存在。调用的时候可以通过GestureDetector类来调用。

第一个方法：

public boolean onSingleTapUp(MotionEvent e) 

用户（轻触触摸屏后）松开，由一个1个MotionEvent ACTION_UP触发

第二个方法：

public void onLongPress(MotionEvent e)

用户长按触摸屏，由多个MotionEvent ACTION_DOWN触发

第三个方法：

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

用户按下触摸屏，并拖动，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE触发。此方法也是手势监听的主要方法，这边做主要讲解。

参数：

1. e1.getX()，e1.getY()代表我们开始滑动的坐标。

2. e2.getX()，e2.getY()代表我们开始滑动的坐标。

3. distanceX表示在x轴方向上的距离，不是e1和e2的距离（也不是在x轴方向上的分量）

4. distanceY表示在y轴方向上滑动的距离，不是e1和e2的距离（也不是在y轴方向上的分量）

其实看到上面详解之后，对我刚看到的我们来说还是有点懵逼。那么我们记者往下看：

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

        float oldX = e1.getX() - e2.getX();
        float oldY = e1.getY() - e2.getY();
        moveLength += distanceY;

        Log.i(TAG, "onScroll event 1,x:" + e1.getX() + " y:" + e1.getY());
        Log.i(TAG, "onScroll event 2,x:" + e2.getX() + " y:" + e2.getY());
        Log.i(TAG, "onScroll event x:" + oldX);
        Log.i(TAG, "onScroll event y:" + oldY);
        Log.i(TAG, "distanceX：" + distanceX);
        Log.i(TAG, "distanceY：" + distanceY);

        Log.i(TAG, "moveLength:" + moveLength);
        return super.onScroll(e1, e2, distanceX, distanceY);
    }

log：

MyOnGestureListener: onScroll event 1,x:395.0 y:1439.0
MyOnGestureListener: onScroll event 2,x:795.0 y:13.0
MyOnGestureListener: onScroll event x:-400.0
MyOnGestureListener: onScroll event y:1426.0
MyOnGestureListener: distanceX：-38.729553
MyOnGestureListener: distanceY：16.58365

通过滑动屏幕我们应该可以发现，在我们手指不离开屏幕进行滑动的情况下，e1和e2分别记录了我们手指开始滑动和结束滑动的位置。
1. 上滑distanceY>0
2. 下滑distanceY<0
3. 左滑distanceX>0
4. 右滑distanceX<0

在我们在屏幕上连续滑动的时候，onScroll()却不是连续调用的，而是离散调用的。因为如果是连续调用的话，理论上onScroll应该被调用无数次，但是通过打印日志发现实际情况并不是这样的，所以onScroll()被离散调用，这就导致了在一次完整的滑动过程中会有好几段distanceX和distanceY，而每次distanceX和distanceY的和就是真实的互动距离。

以上主要是对主要的方法详解，不够全面，如果想更详细的了解方法的用法，可以查阅相关资料。

以下是几个方法的说明：

 // 双击的第二下Touch down时触发  
        public boolean onDoubleTap(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTap");  
            return super.onDoubleTap(e);  
        }  

        // 双击的第二下Touch down和up都会触发，可用e.getAction()区分  
        public boolean onDoubleTapEvent(MotionEvent e) {  
            Log.i("MyGesture", "onDoubleTapEvent");  
            return super.onDoubleTapEvent(e);  
        }  

        // Touch down时触发  
        public boolean onDown(MotionEvent e) {  
            Log.i("MyGesture", "onDown");  
            return super.onDown(e);  
        }  

        // Touch了滑动一点距离后，up时触发  
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
                float velocityY) {  
            Log.i("MyGesture", "onFling");  
            return super.onFling(e1, e2, velocityX, velocityY);  
        }  

        /* 
         * Touch了还没有滑动时触发 (1)onDown只要Touch Down一定立刻触发 (2)Touch 
         * Down后过一会没有滑动先触发onShowPress再触发onLongPress So: Touch Down后一直不滑动，onDown 
         * -> onShowPress -> onLongPress这个顺序触发。 
         */  
        public void onShowPress(MotionEvent e) {  
            Log.i("MyGesture", "onShowPress");  
            super.onShowPress(e);  
        }  

更多资源源码下载：
不一样的RecyclerView优雅实现复杂列表布局
android自定义视频播放器
MediaPlayer和SurfaceView的结合使用
FloatingActionButton的使用
多层Fragment与ViewPager结合使用