[Android开发]一、自定义View手势监听GestureDetector使用教程

首先我们知道 View 主要自带了 设置单击、长按等监听，一般来说就够用了，但我们有时自定义View 需要更多的功能，那GestureDetector具备了什么功能呢，一起来看下吧～

先直接上干货～

public interface OnGestureListener {
    boolean onDown(MotionEvent e);

    void onShowPress(MotionEvent e);

    boolean onSingleTapUp(MotionEvent e);

    boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY);
    
    void onLongPress(MotionEvent e);
    
    boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY);
}

public interface OnDoubleTapListener {
    boolean onSingleTapConfirmed(MotionEvent e);
    
    boolean onDoubleTap(MotionEvent e);
    
    boolean onDoubleTapEvent(MotionEvent e);
}

GestureDetector主要有这两个监听器，下面来介绍下监听器各个回调的详解～

一、首先先来看下 OnGestureListener 的回调介绍：

 boolean onDown(MotionEvent e);

        onDown 是指第一个手指按下时的回调，对应于 ACTION_DOWN 事件，可以看到有返回值，返回值就是 onTouchEvent 的返回值，所以自定义View 这里一般都要写死返回 true，否则接下来就没有事件返回了。

void onShowPress(MotionEvent e);

        onShowPress 是指改展示按压的效果

boolean onSingleTapUp(MotionEvent e);

        onSingleTapUp 是指单击事件，返回true或false都可以

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

        onScroll 是指手指在View上的移动事件，可以理解为对应的 ACTION_MOVE事件，返回true或false都可以，对应的参数：

        1、参数 e1 是指ACTION_DOWN的那个事件（即按下的那个事件）

        2、参数 e2 是指当前的ACTION_MOVE的事件

        3、参数 distanceX 是指上次回调的 x 坐标减去当前回调的 x 坐标的差

        4、参数 distanceY 是指上次回调的 y 坐标减去当前回调的 y 坐标的差

        特别注意下 distanceX 和 distanceY 都是上次减去这次的，而不是这次减去上次的

void onLongPress(MotionEvent e);

        onLongPress 是指长按事件，可以理解为 setOnLongClickListener 的回调

boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY);

        onFling 是指在屏幕上滑动到最后的加速事件，在这里一般就是处理惯性滑动的情况

二、再来看下 OnDoubleTapListener 的回调介绍

boolean onSingleTapConfirmed(MotionEvent e);

        onSingleTapConfirmed是指单击事件，返回true或false都可以。是的你没看错，和OnGestureListener 的 onSingleTapUp 是一样的。这里解释下如果您需要双击事件回调的话，设置OnDoubleTapListener 后因为有了双击事件的判断，所以单击事件就有了歧义了，因为两次单击就是双击，所以在这个过程中，需要界定一下就是两次单击时间间隔符合设定就判断为双击，否则就是单击事件。因此存在双击事件时用 onSingleTapConfirmed 来判断单击事件

        因此当您设置的监听存在双击事件时，单击事件的判断你应该使用 onSingleTapConfirmed 

boolean onDoubleTap(MotionEvent e);

        onDoubleTap是指双击事件，返回true或false都可以。

boolean onDoubleTapEvent(MotionEvent e);

        onDoubleTapEvent是指双击屏幕后没有抬起手指，继续在屏幕上滑动的事件

三、监听器方法介绍完了，我们再来看下应该怎么使用

class CustomView(context: Context, attrs: AttributeSet?) : View(context, attrs),OnGestureListener,OnDoubleTapListener {
    private val gestureDetector = GestureDetectorCompat(context,this).apply {
        setOnDoubleTapListener(this@CustomView)
    }


    override fun onTouchEvent(event: MotionEvent): Boolean {
        return gestureDetector.onTouchEvent(event)
    }
}

        使用起来也很简单，只是需要把 View 的 onTouchEvent 的方法用 GestureDetector 接管即可

可以看到我使用的是GestureDetectorCompat，我们在使用 GestureDetector 时我们其实可以用 GestureDetectorCompat 来代替 ，GestureDetectorCompat是一个兼容版本，可以做到更好的兼容性

        下一节将介绍 ScaleGestureDetector 的应该如何使用