GestureDetector手势检测精炼详解
一、前期基础知识储备
当用户触摸屏幕的时候，会产生许多手势，如down、up、scroll、fling等。
我们知道，View类有一个View.OnTouchListenter内部接口，通过重写它的onTouch(View v, MotionEvent event)类函数，可以处理一些touch事件。但是这个函数太过简单，如果需要处理一些复杂的手势，使用这个接口就会很麻烦。
Android SDK给我们提供了GestureDetector（手势检测）类，通过这个类可以识别很多不同的手势。在识别出手势之后，具体的事务就交由程序员自己实现了。
GestureDetector类对外提供了两个接口（OnGestureListener、OnDoubleTapListener）和一个外部类（SimpleOnGestureListener）。这个外部类其实是两个接口中所有函数的集成，它包含了这两个接口里所有必须实现的函数，而且都已经被重写了，但所有函数体都是空的。该类是一个静态类。实际代码中可以在外部继承这个类，重写里面的手势处理函数。
二、上代码，具体实现
2.1. GestureDetector.OnGestureListener接口
（1） 基本讲解
自定义一个类继承自OnGestureListener，重写6个函数，代码如下：
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;
}
}
这里重写了6个函数，这些函数的触发时机是怎样的呢？
①onDown(MotionEvent e):用户按下屏幕就会触发该函数。
②onShowPress(MotionEvent e):如果按下的时间超过瞬间，而且在按下的时候没有松开或者是拖动的，该函数就会触发。
③onLongPress(MotionEvent e):长按触摸屏，超过一定时长，就会触发这个函数。
④onSingleTapUp(MotionEvent e):一次单独的轻击抬起操作，也就是轻击一下屏幕，立刻抬起来，才会触发这个函数。当然，如果除了down以外还有其他操作，就不再算是单独操作了，也就不会触发这个函数了。
⑤onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY):滑屏，用户按下触摸屏、快速移动后松开，由一个MotionEvent ACTION_DOWN、多个ACTION_MOVE、一个ACTION_UP触发。
- e1：第1个ACTION_DOWN MotionEvent
- e2：最后一个ACTION_MOVE MotionEvent
- velocityX：X轴上的移动速度，像素/秒
- velocityY：Y轴上的移动速度，像素/秒
⑥onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY):在屏幕上拖动事件。无论是用手拖动View，还是以抛的动作滚动，都会多次触发这个函数，在ACTION_MOVE动作发生时就会触发该函数。
滑屏，即用手指触动屏幕后，稍微滑动后立即松开，触发顺序为：
onDown —> onScroll—> onScroll—>onScroll —>...... —>onFling
拖动，触发顺序为：
onDown —> onScroll—> onScroll —>onFling
可见，无论是滑屏还是拖动，影响的知识中间onScroll被触发的数量而已，最终都会触发onFling事件。
（2）代码创建示例
要使用GestureDetector，要分四步走。
① 创建onGestureListener()监听函数。
可以直接构造实例：
GestureDetector.OnGestureListener listener = new GestureDetector.OnGestureListener(){
};
也可以构造类：
private class gestureListener implements GestureDetector.OnGestureListener{
}
② 创建GestureDetector实例mGestureDetector。
GestureDetector gestureDetector=new GestureDetector(GestureDetector.OnGestureListener listener);
GestureDetector gestureDetector=new GestureDetector(Context context,GestureDetector.OnGestureListener listener);
GestureDetector gestureDetector=new GestureDetector(Context context,
GestureDetector.SimpleOnGestureListener listener);
③ 在onTouch(View v, MotionEvent event)中进行拦截。
public boolean onTouch(View v, MotionEvent event) {
return mGestureDetector.onTouchEvent(event);
}
④ 绑定控件
TextView tv = (TextView)findViewById(R.id.tv);
tv.setOnTouchListener(this);
（3）具体实例说明用法
下面举例来说明具体用法。首先在主布局中添加一个TextView, 并将其放大到整个屏幕，方便在其上的手势检测。代码如下：
其次，在Activity代码中，依据上面四步走原则，写出代码，并在所有手势下添加日志。代码如下：
// Activity 层面实现OnTouchListener接口 onTouch()方法内进行事件拦截
public class MainActivity extends Activity implements OnTouchListener{
private GestureDetector mGestureDetector;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mGestureDetector = new GestureDetector(new gestureListener()); //使用派生自OnGestureListener
TextView tv = (TextView)findViewById(R.id.tv);
tv.setOnTouchListener(this);
tv.setFocusable(true);
tv.setClickable(true);
tv.setLongClickable(true);
}
/*
* 在onTouch()方法中，我们调用GestureDetector的onTouchEvent()方法，将捕捉到的MotionEvent交给GestureDetector
* 来分析是否有合适的callback函数来处理用户的手势
*/
public boolean onTouch(View v, MotionEvent event) {
return mGestureDetector.onTouchEvent(event);
}
private class gestureListener implements GestureDetector.OnGestureListener{
// 用户轻触触摸屏，由1个MotionEvent ACTION_DOWN触发
public boolean onDown(MotionEvent e) {
Log.i("MyGesture", "onDown");
Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT).show();
return false;
}
/*
* 用户轻触触摸屏，尚未松开或拖动，由一个1个MotionEvent ACTION_DOWN触发
* 注意和onDown()的区别，强调的是没有松开或者拖动的状态
*
* 而onDown也是由一个MotionEventACTION_DOWN触发的，但是他没有任何限制，
* 也就是说当用户点击的时候，首先MotionEventACTION_DOWN，onDown就会执行，
* 如果在按下的瞬间没有松开或者是拖动的时候onShowPress就会执行，如果是按下的时间超过瞬间
* （这块我也不太清楚瞬间的时间差是多少，一般情况下都会执行onShowPress），拖动了，就不执行onShowPress。
*/
public void onShowPress(MotionEvent e) {
Log.i("MyGesture", "onShowPress");
Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT).show();
}
// 用户（轻触触摸屏后）松开，由一个1个MotionEvent ACTION_UP触发
///轻击一下屏幕，立刻抬起来，才会有这个触发
//从名子也可以看出,一次单独的轻击抬起操作,当然,如果除了Down以外还有其它操作,那就不再算是Single操作了,所以这个事件 就不再响应
public boolean onSingleTapUp(MotionEvent e) {
Log.i("MyGesture", "onSingleTapUp");
Toast.makeText(MainActivity.this, "onSingleTapUp", Toast.LENGTH_SHORT).show();
return true;
}
// 用户按下触摸屏，并拖动，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE触发
public boolean onScroll(MotionEvent e1, MotionEvent e2,
float distanceX, float distanceY) {
Log.i("MyGesture22", "onScroll:"+(e2.getX()-e1.getX()) +" "+distanceX);
Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG).show();
return true;
}
// 用户长按触摸屏，由多个MotionEvent ACTION_DOWN触发
public void onLongPress(MotionEvent e) {
Log.i("MyGesture", "onLongPress");
Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG).show();
}
// 用户按下触摸屏、快速移动后松开，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE, 1个ACTION_UP触发
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
float velocityY) {
Log.i("MyGesture", "onFling");
Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG).show();
return true;
}
};
}
2.2 GestureDetector.SimpleOnGestureListener类
SimpleOnGestureListener类与OnGestureListener接口的不同之处在于：
1）这是一个类，不是接口，需在它的基础上新建子类；
2）OnGestureListener接口内的函数都是被强制重写的，即使用不到也要重写一个空函数，略显麻烦；而在SimpleOnGestureListener类的实例不必如此，可以根据实际情况，用到哪个函数就重写哪个函数，因为其本身就已经实现了GestureDetector类中的两个接口中所有的函数，只是是空实现而已。
举例实现，代码如下：
public class MainActivity extends Activity implements OnTouchListener {
private GestureDetector mGestureDetector;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 使用的是第三种构造方法
mGestureDetector = new GestureDetector(new simpleGestureListener());
TextView tv = (TextView)findViewById(R.id.tv);
tv.setOnTouchListener(this);
tv.setFocusable(true);
tv.setClickable(true);
tv.setLongClickable(true);
}
public boolean onTouch(View v, MotionEvent event) {
// TODO Auto-generated method stub
return mGestureDetector.onTouchEvent(event);
}
// 新建子类 继承自GestureDetector.SimpleOnGestureListener
private class simpleGestureListener extends
GestureDetector.SimpleOnGestureListener {
/*****OnGestureListener的函数*****/
public boolean onDown(MotionEvent e) {
Log.i("MyGesture", "onDown");
Toast.makeText(MainActivity.this, "onDown", Toast.LENGTH_SHORT)
.show();
return false;
}
public void onShowPress(MotionEvent e) {
Log.i("MyGesture", "onShowPress");
Toast.makeText(MainActivity.this, "onShowPress", Toast.LENGTH_SHORT)
.show();
}
public boolean onSingleTapUp(MotionEvent e) {
Log.i("MyGesture", "onSingleTapUp");
Toast.makeText(MainActivity.this, "onSingleTapUp",
Toast.LENGTH_SHORT).show();
return true;
}
// distanceX distanceY 水平距离 竖直距离
public boolean onScroll(MotionEvent e1, MotionEvent e2,
float distanceX, float distanceY) {
Log.i("MyGesture", "onScroll:" + (e2.getX() - e1.getX()) + " "
+ distanceX);
Toast.makeText(MainActivity.this, "onScroll", Toast.LENGTH_LONG)
.show();
return true;
}
public void onLongPress(MotionEvent e) {
Log.i("MyGesture", "onLongPress");
Toast.makeText(MainActivity.this, "onLongPress", Toast.LENGTH_LONG)
.show();
}
// velocityX velocityY 水平速度 竖直速度
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
float velocityY) {
Log.i("MyGesture", "onFling");
Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG)
.show();
return true;
}
/*****OnDoubleTapListener的函数*****/
public boolean onSingleTapConfirmed(MotionEvent e) {
Log.i("MyGesture", "onSingleTapConfirmed");
Toast.makeText(MainActivity.this, "onSingleTapConfirmed",
Toast.LENGTH_LONG).show();
return true;
}
public boolean onDoubleTap(MotionEvent e) {
Log.i("MyGesture", "onDoubleTap");
Toast.makeText(MainActivity.this, "onDoubleTap", Toast.LENGTH_LONG)
.show();
return true;
}
public boolean onDoubleTapEvent(MotionEvent e) {
Log.i("MyGesture", "onDoubleTapEvent");
Toast.makeText(MainActivity.this, "onDoubleTapEvent",
Toast.LENGTH_LONG).show();
return true;
}
}
}
2.3 OnFling()函数应用——识别手指向左滑还是向右滑
这里我们利用OnFling函数来识别当前用户是在向左滑还是向右滑，从而打出日志。先看下OnFling的参数：
boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY)
参数解释：
e1：第1个ACTION_DOWN MotionEvent
e2：最后一个ACTION_MOVE MotionEvent
velocityX：X轴上的移动速度，像素/秒
velocityY：Y轴上的移动速度，像素/秒
实现的功能：当用户向左滑动距离超过100px，且滑动速度超过100 px/s时,即判断为向左滑动;向右同理。核心代码是在onFling()函数中判断当前的滑动方向及滑动速度是不是达到指定值。代码如下:
public class MainActivity extends Activity implements OnTouchListener {
private GestureDetector mGestureDetector;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mGestureDetector = new GestureDetector(new simpleGestureListener());
TextView tv = (TextView)findViewById(R.id.tv);
tv.setOnTouchListener(this);
tv.setFocusable(true);
tv.setClickable(true);
tv.setLongClickable(true);
}
public boolean onTouch(View v, MotionEvent event) {
// TODO Auto-generated method stub
return mGestureDetector.onTouchEvent(event);
}
private class simpleGestureListener extends
GestureDetector.SimpleOnGestureListener {
/*****OnGestureListener的函数*****/
final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;
// 触发条件 ：
// X轴的坐标位移大于FLING_MIN_DISTANCE，且移动速度大于FLING_MIN_VELOCITY个像素/秒
// 参数解释：
// e1：第1个ACTION_DOWN MotionEvent
// e2：最后一个ACTION_MOVE MotionEvent
// velocityX：X轴上的移动速度，像素/秒
// velocityY：Y轴上的移动速度，像素/秒
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
float velocityY) {
if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE
&& Math.abs(velocityX) > FLING_MIN_VELOCITY) {
// Fling left
Log.i("MyGesture", "Fling left");
Toast.makeText(MainActivity.this, "Fling Left", Toast.LENGTH_SHORT).show();
} else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE
&& Math.abs(velocityX) > FLING_MIN_VELOCITY) {
// Fling right
Log.i("MyGesture", "Fling right");
Toast.makeText(MainActivity.this, "Fling Right", Toast.LENGTH_SHORT).show();
}
return true;
}
}
}