看完这篇还不会 GestureDetector 手势检测，我跪搓衣板！
引言
在 android 开发过程中，我们经常需要对一些手势，如：单击、双击、长按、滑动、缩放等，进行监测。这时也就引出了手势监测的概念，所谓的手势监测，说白了就是对于 GestureDetector 的用法的使用和注意要点的学习。注：由于缩放手势独有的复杂性，我打算后期将其单独拿出来归纳总结。
像网上其他将手势监听的博客一样，本文将以双击事件为引子，逐步展开探讨 Android 手势监听，你需要知道的点点滴滴，还是那句话：看完这篇还不会 GestureDetector 手势检测，我跪搓衣板！
双击 666
对于一个 Android 新手而言，如果需要你实现一个双击功能，我们一般会怎么想呢？
May Be
- 首先我们重写 onTouchEvent 方法
- 当第一次点击后，咱们先判断是否为需要监听的控件
- 如果是则 new 一个线程，开始倒计时（如 1s）
- 如果在这个倒计时的期间，再次调用了点击事件
- 判断成功、发生双击事件⌚️
But
这实在是太复杂了，你又要控制时间，又要判断控件等等等等。所以，我们因该如何解决呢？手势监听的使用
GestureDetector 使用
我的理解是 GestureDetector 是 Android 中，专门用来进行手势监听的一个对象，在他的监听器中，我们通过传入 MotionEvents 对象，就可以在各种事件的回调方法中各种手势进行监测。举个例子： GestureDetector 的 OnGestureListener 就是一种回调方法，就是说在获得了传入的这个 MotionEvents 对象之后，进行了处理，我们通过重写了其中的各种方法（单击事件、双击事件等等），就可以监听到单击，双击，滑动等事件，然后直接在这些方法内部进行处理。
使用方法
- 首先，创建一个 SimpleOnGestureListener 回调方法对象，并对其中各个方法进行重写
- 根据这个 listener 对象，实例化出 GestureDetector 对象
- 对目标控件重写 setOnTouchListener 方法，并在其中调用 detector 对象的 onTouchEvent 方法即可
简单易懂，一分钟搞定
@Override
protected void onResume() {
button.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
return detector.onTouchEvent(event);
}
});
super.onResume();
}
private void iniGestureListener(){
GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onDoubleTap(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "double click up!");
return super.onDoubleTap(e);
}
detector = new GestureDetector(GestureDetectorActivity.this, listener);
}
运行结果
Looper 注册
如果哪位好奇的老铁，尝试着在线程中创建这个 detector 对象（比如下面这种）。那么运行时就可能出现程序崩溃的情况，这是为什么呢？
new Thread(){
@Override
public void run() {
super.run();
detector = new GestureDetector(GestureDetectorActivity.this, listener);
}
}.start();
其实在 GestureDetector 被实例化时，内部会自动创建一个 Handler 用于处理数据，所以如果你在主线程中创建 GestureDetector，那么这个 GestureDetector 内部创建的 Handler 会自动获得主线程的 Looper。也是因此：如果你在一个没有创建 Looper 的子线程中创建 GestureDetector 则需要传递一个带有 Looper 的 Handler 给它，否则就会因为无法获取到 Looper 导致创建失败。
解决
既然问题出现了，那要怎么解决呢。既然是缺少活动中的 Looper ，那么将活动中的 Looper 传入就是。观察 detector 的构造方法，发现其一共有种方法，其中我们常用的方法有两种，首先是我们在主线程中用的那种，另外一种就是我们现在要用的，在子线程中，能传入 Looper 的 构造方法：
| public GestureDetector(Context context, OnGestureListener listener) |
|---|
| GestureDetector(Context context, GestureDetector.OnGestureListener listener, Handler handler) |
方案一
传入一个保有 Looper 对象的 Hander
new Thread(){
@Override
public void run() {
super.run();
detector = new GestureDetector(GestureDetectorActivity.this, listener, new Handler(Looper.getMainLooper()));
}
}.start();
方案二
跟方法已一样，只是把 Hander 拿出来单独创建罢了
new Thread(){
@Override
public void run() {
super.run();
Handler handler = new Handler(Looper.getMainLooper());
detector = new GestureDetector(GestureDetectorActivity.this, listener, handler);
}
}.start();
方案三
在主线程中创建 Hander ，这样就不用在创建 Hander 时，传入主线程的 Looper
final Handler handler = new Handler();
new Thread(){
@Override
public void run() {
super.run();
detector = new GestureDetector(GestureDetectorActivity.this, listener, handler);
}
}.start();
方案四
和上面几个方法一样，只不过在子线称里提前准备好 Lopper ，这样子线称就和主线程一样了
new Thread(){
@Override
public void run() {
super.run();
Looper.prepare();
detector = new GestureDetector(GestureDetectorActivity.this, listener);
}
}.start();
重点：手势监听
刚刚我们已经通过双击效果，讲过 onDoubleTapEvent 了，那么 GestureDetecotr 还有哪些厉害的回调方法呢？
- OnDoubleTapListener ：也就是双击事件，双击事件除了 onDoubleTapEvent 这个回调方法之外，还有 SingleTapConfirmed 和 DoubleTap 这两个回调方法
- OnGestureListener ：这里集合了众多手势的监听器：主要有：按下(Down)、 扔(Fling)、长按(LongPress)、滚动(Scroll)、触摸反馈(ShowPress) 和 单击抬起(SingleTapUp)
- SimpleOnGestureListener ：上述接口的空实现，用的频率比较多
OnDoubleTapListener
我们先来讲讲 OnDoubleTapListener，大家可能要问：刚刚不是已经讲过双击事件监听了吗，这里又来不是浪费时间？废话不说，让我详细介绍下这类的方法：
单击回调 SingleTapConfirmed
有人就会很好奇，对于单击事件的回调，直接去用 onClickListener 不就好了么，干嘛要用 SingleTapConfirmed 呢？
首先，这两个方法是冲突的，这里就涉及到了事件分发机制，这点我后期会专门给大家总结下，这里就不详解了。
其二，更具 onClickListener 的机制，我们不难发现，如果是用 onClickListener 的话，当我们双击时，我们也会调用单击事件，也就是单击了两次，这明显是不符合我们意图的。那么该如何调用呢？very easy ！
final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "single click!");
return super.onSingleTapConfirmed(e);
}
...
};
DoubleTap 与 onDoubleTapEvent
我打算把这两个方法放在一起将，一则他两都属于双击的范畴，二则他两有着极高相似和细微却重要的区别。
大家可以尝试着在 onTouchEvent 和 DoubleTap 中，对点击的 Down move 和 up 进行打印，你就会发现，对于 DoubleTap 而言，它是在第二次点击按下是，发生的回调，而对于 onDoubleTapEvent 而言，则是在第二次点击后，手指抬起离开了屏幕时，发生的回调。这就是他两最重要的区别。
final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onDoubleTap(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "double click down!");
return super.onDoubleTap(e);
}
@Override
public boolean onDoubleTapEvent(MotionEvent e) {
switch (e.getActionMasked()){
case MotionEvent.ACTION_UP:
MyToast.makeToast(GestureDetectorActivity.this, "double click up!");
break;
}
return super.onDoubleTapEvent(e);
}
};
所以，有了这两个方法，我们就可以更具目的性的满足两种需求。
讲到这里，单击双击事件就告一段落了，下面我们进入 OnGestureListener 的学习
OnGestureListener
这可以说是整个手势监测中，最核心的部分了，前面都是引入，现在才是正题，这里我主要向大家介绍一下手势：
- 按下(Down)
- 一扔(Fling)
- 长按(LongPress)
- 滚动(Scroll)
- 触摸反馈(ShowPress)
- 单击抬起(SingleTapUp)
onDown
onDown 事件很好理解，他在一个 View 被按下时执行。也正是如此，要想能执行 onDown ，首先要保证这个 View 是可以点击的，也就是 onClickable 的值为 true 。
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onDown(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "onDown");
// 后续事件
return super.onDown(e);
}
};
onFling
对于 onFling 我个人感觉这是个最常用的方法，就像它的名字，翻译过来是拖、拽、扔的意思。举个例子 RecyclerView 或者 ListView 我们都有用过，当我们快速上拉后会滚动一定距离停止，我们可爱的 onFling 就是用于检测这种手势的。
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
mSpeedX = velocityX;
mSpeedY = velocityY;
handler.postDelayed(runnable, 30);
return super.onFling(e1, e2, velocityX, velocityY);
}
};
从代码中，我们不难发现：该方法有四个参数
| 参数 | 意义 |
|---|---|
| e1 | 手指按下时的 Event。 |
| e2 | 手指抬起时的 Event。 |
| velocityX | 在 X 轴上的运动速度(像素／秒)。 |
| velocityY | 在 Y 轴上的运动速度(像素／秒)。 |
通过前两个 MotionEvent 参数，我们可以获得点击发生的位置等，通过后两个 float 参数，我们可以获得手指滑动的速度。
具体使用其实还是蛮多的，比如我们可以想象下台球游戏，球杆击球后，就有这样一个初速度递减的效果。
onLongPress
onLongPress 很简单，就是长按事件的回调，比如说长按复制，长按弹窗等等，它不但应用广泛，同时使用也非常简单，这里就不唠叨了
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public void onLongPress(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "onLongPress");
// 后续工作
super.onLongPress(e);
}
};
onScroll
onScroll 方法和 onFling 很像，唯一的区别在于，onFling 的参数是滑动的速度，而 onScroll 的后两个参数则是滑动的距离：
| 参数 | 意义 |
|---|---|
| e1 | 手指按下时的 MotionEvent |
| e2 | 手指抬起时的 MotionEvent |
| distanceX | 在 X 轴上划过的距离 |
| distanceY | 在 Y 轴上划过的距离 |
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
MyToast.makeToast(GestureDetectorActivity.this, "onScroll X = " +
distanceX + " Y = " + distanceY);
return super.onScroll(e1, e2, distanceX, distanceY);
}
};
onShowPress
这个方法我其实觉得作用不是很大，因为它是在 View 被点击（按下）是调用，其作用是给用户一个视觉反馈，让用户知道我这个控件被点击了，这样的效果我们完全可以用 Material design 的 ripple 实现，或者直接 drawable 写个背景也行。
如果说它有什么特别指出的话，它是一种延时回调，延迟时间是 180 ms。也就是说用户手指按下后，如果立即抬起或者事件立即被拦截，时间没有超过 180 ms的话，这条消息会被 remove 掉，也就不会触发这个回调。
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public void onShowPress(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "onShowPress");// >150ms 时调用
super.onShowPress(e);
}
};
onSingleTapUp
对于 onSingleTapUp 网上有很多分析，但我觉得过于复杂了，其实这东西很简单。举个例子你就懂了：
之前我们讲过双击事件，那好 onSingleTapUp 就是在 双击事件的第一次点击时回调。也就是说但你点击了一个控件时（双击第一下），这个回调马上会被调用，然后迅速点第二下（双击事件的第二下），则其不会被调用。
| 类型 | 触发次数 | 摘要 |
|---|---|---|
| onSingleTapUp | 1 | 在双击的第一次抬起时触发 |
| onSingleTapConfirmed | 0 | 双击发生时不会触发。 |
| onClick | 2 | 在双击事件时触发两次。 |
它和 onSingleTapConfirmed 的区别也就很明显了，onSingleTapConfirmed 在发生双击时，会回调两次，而 onSingleTapUp 只会在双击的的第一次回调。
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onSingleTapUp(MotionEvent e) {// 双击第一次抬起触发，第二次不触发
Log.d("onSingleTapUp", "onSingleTapUp");// >150ms 时调用
return super.onSingleTapUp(e);
}
};
SimpleOnGestureListener
SimpleOnGestureListener 中包含了以上所有方法的空实现，之所以在文末再一次提及他，主要是想讲下它的方便之处。
我们以监听 OnDoubleTapListener 为例，如果想要使用 OnDoubleTapListener 接口则需要这样进行设置：
GestureDetector detector = new GestureDetector(this, new GestureDetector
.SimpleOnGestureListener());
detector.setOnDoubleTapListener(new GestureDetector.OnDoubleTapListener() {
@Override public boolean onSingleTapConfirmed(MotionEvent e) {
Toast.makeText(MainActivity.this, "onSingleTapConfirmed", Toast.LENGTH_SHORT).show();
return false;
}
@Override public boolean onDoubleTap(MotionEvent e) {
Toast.makeText(MainActivity.this, "onDoubleTap", Toast.LENGTH_SHORT).show();
return false;
}
@Override public boolean onDoubleTapEvent(MotionEvent e) {
Toast.makeText(MainActivity.this,"onDoubleTapEvent",Toast.LENGTH_SHORT).show();
return false;
}
});
我们不难发现一个问题，既然在 GestureDetector 实例化时，已经实例化了一个 SimpleOnGestureListener 了，那么在舍近求远的去使用 OnGestureListener 的话，会多出几个无用的空实现，显然很浪费，所以在一般情况下，乖乖的使用 SimpleOnGestureListener 就好了。
最后
由于手势监听的方法有点多，大家一时难以记住，所以我打算把所有方法，在 SimpleOnGestureListener 中重写一遍，方便大家进行查阅、记忆：
private final GestureDetector.SimpleOnGestureListener listener = new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "single click!");
return super.onSingleTapConfirmed(e);
}
@Override
public boolean onDoubleTap(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "double click down!");
return super.onDoubleTap(e);
}
@Override
public boolean onDoubleTapEvent(MotionEvent e) {
switch (e.getActionMasked()){
case MotionEvent.ACTION_UP:
MyToast.makeToast(GestureDetectorActivity.this, "double click up!");
break;
}
return super.onDoubleTapEvent(e);
}
@Override
public boolean onDown(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "onDown");
return super.onDown(e);
}
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
mSpeedX = velocityX;
mSpeedY = velocityY;
handler.postDelayed(runnable, 30);
return super.onFling(e1, e2, velocityX, velocityY);
}
@Override
public void onShowPress(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "onShowPress");// >150ms 时调用
super.onShowPress(e);
}
@Override
public boolean onSingleTapUp(MotionEvent e) {// 双击第一次抬起触发，第二次不触发
Log.d("onSingleTapUp", "onSingleTapUp");// >150ms 时调用
return super.onSingleTapUp(e);
}
@Override
public void onLongPress(MotionEvent e) {
MyToast.makeToast(GestureDetectorActivity.this, "onLongPress");
// 后续工作
super.onLongPress(e);
}
@Override
public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
MyToast.makeToast(GestureDetectorActivity.this, "onScroll X = " +
distanceX + " Y = " + distanceY);
return super.onScroll(e1, e2, distanceX, distanceY);
}
};
本篇博客，是我对我学习过程的总结，所以其中难免有疏漏，希望大家能在评论区中指出，万分感谢。
同时，如果大家有任何疑问，也可以在评论区中留言、讨论，这个搓衣板跪不跪，你们说了算！🙏
浙公网安备 33010602011771号