GestureDetector
在 android 开发过程中,经常需要对一些手势,如:单击、双击、长按、滑动、缩放等,进行监测。
这时也就引出了手势监测的概念,所谓的手势监测,也就是GestureDetector 。
构造方法:
已过时的有2个,不推荐使用。
GestureDetector(GestureDetector.onGestureListener listener);
GestureDetector(GestureDetector.onGestureListener listener,Handler handler);
推荐使用:
GestureDeterctor(Context context,GestureDetector.onGestureListener listener);
GestureDeterctor(Context context,GestureDetector.onGestureListener listener,Handler handler);
GestureDeterctor(Context context,GestureDetector.onGestureListener listener,Handler handler,boolean unused);
参数handler主要用来执行延时操作时使用,参数unused暂时没有使用。
从构成函数可以看出,当我们需要创建一个GestureDetector对象时,必须给它传一个GestureDetector.onGestureListener对象,查看API之后,发现它是个接口(interface),创建GestureDetector.onGestureListener的对象时,必须实现一下几个方法:
1、onDown(MotionEvent e);
当用户按下时的回调。
2、onFling(MotionEvent e1,MontionEvent e2,float velocityX,float velocityY);
滑屏,用户按下触摸屏、快速移动后松开,由1个MotionEvent ACTION_DOWN, 多个 ACTION_MOVE, 1个ACTION_UP触发
参数解释:
e1:第1个ACTION_DOWN MotionEvent
e2:最后一个ACTION_MOVE MotionEvent
velocityX:X轴上的移动速度,像素/秒
velocityY:Y轴上的移动速度,像素/秒
3、onLongPress(MotionEvent e);
长按触摸屏,超过一定时长,就会触发这个事件
触发顺序:
onDown->onShowPress->onLongPress
4、onScroll(MotionEvent e1,MotionEvent e2,float distanceX,float distanceY);
在屏幕上拖动事件。无论是用手拖动view,或者是以抛的动作滚动,都会多次触发,这个方法 在ACTION_MOVE动作发生时就会触发
滑屏:手指触动屏幕后,稍微滑动后立即松开
onDown-----》onScroll----》onScroll----》onScroll----》………----->onFling
拖动
onDown------》onScroll----》onScroll------》onFiling
5、onShowPress(MotionEvent e);
如果是按下的时间超过瞬间,而且在按下的时候没有松开或者是拖动的,那么onShowPress就 会执行。
6、onSingleTapUp(MotionEvent e);
从名子也可以看出,一次单独的轻击抬起操作,也就是轻击一下屏幕,立刻抬起来,才会有这个 触发,当然,如果除了Down以外还有其它操作,那就不再算是Single操作了,所以也就不会触发这 个事件
触发顺序:
点击一下非常快的(不滑动)Touchup:
onDown->onSingleTapUp->onSingleTapConfirmed
点击一下稍微慢点的(不滑动)Touchup:
onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
有了这个监听之后,我们还可以给GestureDetector设置双击监听,使用的方法是:
mGestureDetector.setOnDoubleTapListener(GestureDetector.OnDoubleTapListener onDoubleListener);
参数是双击监听的对象,GestureDetector.OnDoubleTapListener它也是一个接口(interface),创建它的对象时,也必须实现以下几个方法。
1、onDoubleTap(MotionEvent e);
当用户双击时回调。
2、onDoubleTapEvent(MotionEvent e);
双击间隔中发生的动作。指触发onDoubleTap以后,在双击之间发生的其它动作,包含 down、up和move事件
3、onSingleTapConfirmed(MotionEvent e);
单击事件。用来判定该次点击是SingleTap而不是DoubleTap,如果连续点击两次就是 DoubleTap手势,如果只点击一次,系统等待一段时间后没有收到第二次点击则判定该次点击 为SingleTap而不是DoubleTap,然后触发SingleTapConfirmed事件。
触发顺序是:OnDown->OnsingleTapUp->OnsingleTapConfirmed
上面的两个监听,回调函数都是必须实现,有时候我们不需要监听所有的事件,只对自己感兴趣的事件进行监听,GestureDetector有个内部类帮我们实现此功能GestureDetector.SimpleOnGestureListener,该类实现了GestureDetector.onGestureListener、GestureDetector.onDoubleTapListener、GestureDetector.onContextClickListener这三个接口,并实现了它们的方法,只不过是空实现,在我们需要这三个接口的时候,我们可以创建GestureDetector.SimpleOnGestureListener对象,然后需要监听哪个事件,我们就重写它的哪个方法,下面我把它的所有方法都实现了,其实和上边两个接口实现的方法是一样。
GestureDetector.SimpleOnGestureListener mGestureDetector = new SimpleOnGestureListener(){
@Override
public boolean onSingleTapUp(MotionEvent e) {
return super.onSingleTapUp(e);
}
@Override
public void onLongPress(MotionEvent e) {
super.onLongPress(e);
}
@Override
public boolean onScroll(MotionEvent e1, MotionEvent e2,
float distanceX, float distanceY) {
return super.onScroll(e1, e2, distanceX, distanceY);
}
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2,
float velocityX, float velocityY) {
return super.onFling(e1, e2, velocityX, velocityY);
}
@Override
public void onShowPress(MotionEvent e) {
super.onShowPress(e);
}
@Override
public boolean onDown(MotionEvent e) {
return super.onDown(e);
}
@Override
public boolean onDoubleTap(MotionEvent e) {
return super.onDoubleTap(e);
}
@Override
public boolean onDoubleTapEvent(MotionEvent e) {
return super.onDoubleTapEvent(e);
}
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
return super.onSingleTapConfirmed(e);
}
};
OnGestureListener使用过程
第一步:
首先创建一个OnGestureListener手势操作接口的实现类,并重写这些方法,如果一些手势不需要处理,则无需进行重写。
private class SimpleOnGesture extends GestureDetector.SimpleOnGestureListener {
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
Logger.i("onSingleTapConfirmed");
return false;
}
@Override
public boolean onDoubleTap(MotionEvent e) {
Logger.i("onDoubleTap");
return false;
}
}
第二步:
初始化控件,然后初始化GestureDetector,并在GestureDetector构建时,将OnGestureListener接口的实现类添加进去。最后,执行控件的onTouchListener事件的注册,并在重写的onTouch方法中,通过GestureDetector对touch事件进行onTouchEvent派发,使MotionEvent被GestureDetector所消费,代码如下所示:
mGestureDetector = new GestureDetector(this, new SimpleOnGesture());
mBinding.videoV.setOnTouchListener((v, event) -> {
mGestureDetector.onTouchEvent(event);
return true;
});