Gesture：手势
Detector：侦查,识别
GestureDetector：手势识别
这个类主要是用来处理手指在屏幕上的一些动作的，比如scroll,fling，down,press等。通过查看这个类的文档，发现，它内部定义了三个接口，分别是OnGestureListener，OnDoubleTapListener，OnContextClickListener以及一个静态内部类，SimpleOnGestureListener，这个静态内部类实现了，前面提到的三个接口。
这个静态内部类的好处是：
1.当我们不想重写某个接口的那么多方法时，就可以使用这个静态内部类，由于这个静态内部类已经对三个接口做了空实现，所以我们不必再对这三个接口的方法都做实现，只需要重写我们关心的的方法即可。
2.如果要监听多个手势动作，比如我们既要监听单击，又要监听双击屏幕的手势，则需要给
gestureDetector对象设置多个监听对象。这时为了简化这些步骤，可以直接使用给gestureDetector对象设置一个SimpleOnGestureListener监听对象即可。
为了能够更好的使用GestureDetector，我们就需要仔细了解这三个接口响应手势的回调方法，首先来看OnGestureListener接口中的各个方法。
public interface OnGestureListener {
//每次触摸屏幕，这个方法都会触发
boolean onDown(MotionEvent e);
//如果按下的时间超过180 ms，并且按下后，没有松开或者滑动，这个方法就会执行
//看文档上的注释是，用户已经执行了down 这个motionevent,并且用户还未执行移动或者抬起手指，
//这个事件通常是用于给用户一个视觉反馈，让用户知道他们的这个动作已经识别了。
void onShowPress(MotionEvent e);
//一次单独的轻敲，这个方法就会执行
//触发顺序：
//点击一下非常快的（不滑动）Touchup：
//onDown->onSingleTapUp->onSingleTapConfirmed
//点击一下稍微慢点的（不滑动）Touchup：
//onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
boolean onSingleTapUp(MotionEvent e);
//手指在屏幕上移动，或者手指在屏幕上掠过(按下后，快速的滑动后松开)，都会触发这个方法
//触发顺序:
//手指在屏幕缓慢移动 onDown -> onShowPress(可能会有) -> 多个 onScroll
//手机在屏幕快速掠过 onDown -> 多个 onScroll -> onFling
// 参数解释：
// e1：第1个ACTION_DOWN MotionEvent
// e2：最后一个ACTION_MOVE MotionEvent
// velocityX：X轴上的移动速度，像素/秒
// velocityY：Y轴上的移动速度，像素/秒
boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY);
//手指在屏幕上长按，就会触发这个方法
// 触发顺序：onDown->onShowPress->onLongPress
void onLongPress(MotionEvent e);
//用户手指在屏幕掠过(按下后，快速的滑动后松开)
boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY);
}
public interface OnDoubleTapListener {
//当手指在屏幕上单击时，这个方法会执行
//触发顺序：onDown -> onShowPress(可能有) -> onSingleTapUp -> onSingleTapConfirmed
//onSingleTapUp方法和onSingleConfirmed方法的区别是：不管是双击还是单击，手机离开屏幕的第一次，
//都会触发onSingleUp方法，如果手指单击屏幕，则会触发onSingleConfirmed方法，用于确定这次的手势就是单击
//如果手指双击屏幕，则不会触发onSinlgeConfirmed方法
boolean onSingleTapConfirmed(MotionEvent e);
//当手指双击屏幕时，会执行这个方法
//触发顺序是：onDown -> onSingleTapUp ->onDoubleUp
boolean onDoubleTap(MotionEvent e);
//当手指双击屏幕时，如果在onDoubleUp方法触发后发生了down,move,up等事件，则会执行这个方法
//触发顺序：onDown -> onSingleUp -> onDoubleUp ->onDoubleTapEvent ->onDown -> 多个onDoubleTapEvent
boolean onDoubleTapEvent(MotionEvent e);
}
//这个接口是用于监听一些外部设备的手势
public interface OnContextClickListener {
boolean onContextClick(MotionEvent e);
}
了解完GestureDetector类的三个内部接口和一个静态内部类后，下面来看看，GestureDetector的构造方法
public GestureDetector(Context context, OnGestureListener listener) {
this(context, listener, null);
}
public GestureDetector(Context context, OnGestureListener listener, Handler handler) {
if (handler != null) {
mHandler = new GestureHandler(handler);
} else {
mHandler = new GestureHandler();
}
mListener = listener;
if (listener instanceof OnDoubleTapListener) {
setOnDoubleTapListener((OnDoubleTapListener) listener);
}
if (listener instanceof OnContextClickListener) {
setContextClickListener((OnContextClickListener) listener);
}
init(context);
}
//这个构造函数有些莫名其妙的，虽然要传入unused参数，但是传入的参数，并未使用，不知道是不是google的bug
public GestureDetector(Context context, OnGestureListener listener, Handler handler,
boolean unused) {
this(context, listener, handler);
}
从上面这三个构造函数来看，最终都是调用了三个参数的构造函数。下面来看看三个参数的构造函数的具体实现：
public GestureDetector(Context context, OnGestureListener listener, Handler handler) {
if (handler != null) {
mHandler = new GestureHandler(handler);
} else {
mHandler = new GestureHandler();
}
mListener = listener;
if (listener instanceof OnDoubleTapListener) {
setOnDoubleTapListener((OnDoubleTapListener) listener);
}
if (listener instanceof OnContextClickListener) {
setContextClickListener((OnContextClickListener) listener);
}
init(context);
}
从构造方法中，可以看出，构造方法内部，如果传递了handler,则将这个handler作为GestureHandler这个类的构造方法的参数创建一个handler对象，如果未传入handler对象，则使用GestureHandler创建一个hanler对象。将传入的OnGestureListener赋值给mLister，并调用init(context)方法进行一些相关的初始化操作。从GestureDetector的内部类GestureHandler的源码就可以看到，这两种创建handler的方式的唯一区别是，使用的Looper不同。下面看看GestureHandler这个类，它是GestureDetector的内部类，继承了Hander，其实就是一个Handler。
private class GestureHandler extends Handler {
GestureHandler() {
super();
}
GestureHandler(Handler handler) {
super(handler.getLooper());
}
@Override
public void handleMessage(Message msg) {
switch (msg.what) {
case SHOW_PRESS:
mListener.onShowPress(mCurrentDownEvent);
break;
case LONG_PRESS:
dispatchLongPress();
break;
case TAP:
// If the user's finger is still down, do not count it as a tap
if (mDoubleTapListener != null) {
if (!mStillDown) {
mDoubleTapListener.onSingleTapConfirmed(mCurrentDownEvent);
} else {
mDeferConfirmSingleTap = true;
}
}
break;
default:
throw new RuntimeException("Unknown message " + msg); //never
}
}
}
如果我们是在主线程中直接使用两个参数的方式创建GestureDetector对象，则GestureDetector内部的handler使用的就是主线程的handler。如果在子线程中，创建GestureDetector对象，如果是使用两个参数的构造方法创建，则会报错
Java.lang.RuntimeException: Can’t create handler inside thread that has not called Looper.prepare()
所以，在子线程使用GestureDetector时，要特别注意。主要注意在子线程使用handler。如果要在子线程使用创建GestureDetector对象，则可以有如下三种方式：
方式一：这种方式使用时，要注意onShowPress,onLongPress,onSingleTapConfirmed这三 个方法是在handleMessage方法中进行回调的，如果handler创建的线程是在子线程，则这三个方法在子线程回调的，所以，这三个方法中，不能处理ui的操作。具体代码如下：
new Thread(new Runnable() {
@Override
public void run() {
Looper.prepare();
gestureDetector = new GestureDetector(GestureDetectorActivity2.this,gestureListener);
gestureDetector.setOnDoubleTapListener(onDoubleTapListener);
Looper.loop();
}
}).start();
方式二：(用主线程的looper来创建handler,然后用GestureDetector的三个参数的构造函数来创建GestureDetector对象)
new Thread(new Runnable() {
@Override
public void run() {
Handler handler = new Handler(Looper.getMainLooper());
gestureDetector = new GestureDetector(GestureDetectorActivity2.this,gestureListener,handler);
gestureDetector.setOnDoubleTapListener(onDoubleTapListener);
}
}).start();
方式三：直接在主线程创建handler对象，在用这个handler去创建GestureDetector对象。
final Handler handler = new Handler();
new Thread(new Runnable() {
@Override
public void run() {
gestureDetector = new GestureDetector(GestureDetectorActivity2.this,gestureListener,handler);
gestureDetector.setOnDoubleTapListener(onDoubleTapListener);
}
}).start();
下面是直接在主线程中创建GestureDetector,有如下两种方式：
方式一：
GestureDetector gestureDetector = new GestureDetector(GestureDetectorActivity2.this,gestureListener);
gestureDetector.setOnDoubleTapListener(onDoubleTapListener);
方式二：(SimpleOnGestureListener里面的方法，按需实现，如果用不到，可以不去实现)
GestureDetector gestureDetector = new GestureDetector(new GestureDetector.SimpleOnGestureListener(){
@Override
public boolean onDown(MotionEvent e) {
return super.onDown(e);
}
@Override
public void onShowPress(MotionEvent e) {
super.onShowPress(e);
}
@Override
public boolean onSingleTapUp(MotionEvent e) {
return super.onSingleTapUp(e);
}
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
return super.onSingleTapConfirmed(e);
}
@Override
public boolean onDoubleTap(MotionEvent e) {
return super.onDoubleTap(e);
}
@Override
public boolean onDoubleTapEvent(MotionEvent e) {
return super.onDoubleTapEvent(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);
}
});
GestureDetector的原理就是：通过拦截onTouchEvent中的各个MotionEvent,在将自己定义的一套规则，比如什么是单击，什么是双击，来将各个MotionEvent做更加细致的划分，通过自己内部的handler，发送这些自己定义的规则的(比如单击事件)消息，然后在handlerMessage
方法中，调用GestureListener接口中相应的回调方法，来实现onShowPress,onLongPress,onSingleTapConfirmed操作的监听。在GestureDetector的onTouchEvent方法中，进行onDown，onSingleTapUp，onDoubleTap，onDoubleTapEvent，onScroll，onFling这些方法的回调。
使用步骤是：
1.创建GestureDetector.SimpleOnGestureListener simpleLinener = new GestureDetector.SimpleOnGestureListener(){//实现自己关心的对调方法}对象
2.创建GestureDetector对象
GestureDetector gestureDetector = new GestureDetector(simpleLinener);
3.在要监听的view的onTouchListener中处理MotionEvent的动作
tv.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
gestureDetector.onTouchEvent(event);
return false;
}
});
参考：
安卓自定义View进阶-手势检测(GestureDetector)
https://www.gcssloop.com/customview/gestruedector
用户手势检测-GestureDetector使用详解
https://blog.csdn.net/harvic880925/article/details/39520901
921
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
