手势监听 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触发。此方法也是手势监听的主要方法，这边做主要讲解。

参数：

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

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

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

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结合使用