Android 手势识别处理转换

最近项目中对已有的自定义的图表控件进行优化. 考虑之前的手势处理都是在控件内的onTouchEvent中处理的. 通过监听每一次的MotionEvent事件, 然后进行判断不同的时机去决定操作事件的触发.

其实, Android系统早已提供了针对Touch事件识别的处理, 那就是GestureDetector和ScaleGestureDetector.在它们的onTouchEvent中已经完美识别了我们需要的不同的操作, 并通过Listener回调给使用者.

OnGestureListener, OnDoubleTapListener, OnContextClickListener
回调接口�参见GestureDetector.java:

OnScaleGestureListener
缩放操作的回调接口参见ScaleGestureDetector.java:

从以上接口中, 我们可以非常方便的找到系统所支持的所有手势操作处理点. 并准确的把握处理时机. 以便完成我们的处理逻辑.

可是, 它仍有一些弊端:

  1. 语义不够明确, 有时我们仅需要告诉使用者什么时候真的 单击, 长按, 缩放了...
  2. 自定义控件时使用不具灵活,
    长按时间不能自定义, 长按时间参见系统设置:Settings.Secure.LONG_PRESS_TIMEOUT 默认为500毫秒
    500
    对缩放操作自定义处理.
  3. 与父布局的Scroll事件冲突. 本例中当View的父控件是可滚动时,
    View的移动操作会与父控件的Scroll事件发生冲突.

当然, 这都因需求而定, 目前我的项目主要是针对股票K线及技术指标图表的操作, 主要有单击, 双击, 长按, 移动, 长按后的移动,

为此我有如下封装:

    /**
     * Created by �kangqiao on 16/9/22.
     * e-mail: [email protected]
     */
    public interface GestureOperateListener {

        /**
         * 只要有 ACTION_UP 或 ACTION_CANCEL
         */
        void onUpOrCancel();

        /**
         * 缩放
         * if true zoom in, else zoom out
         *
         * @param detector
         */
        void onZoom(ScaleGestureDetector detector);

        /**
         * 滑动, 注意: 之前没有进行长按.
         *
         * @param downEvent
         * @param event
         * @param distanceX
         * @param distanceY
         */
        void onMove(MotionEvent downEvent, MotionEvent event, float distanceX, float distanceY);

        /**
         * 长按后滑动, 回调多次
         *
         * @param event
         */
        void onMoveAfterLongPress(MotionEvent event);

        /**
         * 长按 仅回调一次
         *
         * @param event
         */
        void onLongPress(MotionEvent event);

        /**
         * 快速点击. 第一次 touch up时, 后续又没有任何操作(滑动, 不处理长按中, 缩放)时回调
         *
         * @param event
         */
        void onClick(MotionEvent event);

        /**
         * 双击. 第二次 touch up时, 回调
         *
         * @param event
         */
        void onDoubleClick(MotionEvent event);

        /**
         * 快速滑动后的最后一个动作
         *
         * @param downEvent 起点
         * @param event     终点
         * @param velocityX 水平方向移动的速度,像素/秒
         * @param velocityY 垂直方向移动的速度,像素/秒
         */
        void onFling(MotionEvent downEvent, MotionEvent event, float velocityX, float velocityY);

        /**
         * 重绘UI
         */
        void postInvalidate();
    }

对于TouchEvent事件中那些复杂的操作判断仍然交由系统提供的GestureDetector和ScaleGestureDetector来侦测, 需要作的仅仅是在其回调中转换为需要的操作.

依然遵循Detector的使用规则, 我做了如下的封装:

public class KLineChartView extends LinearLayout {
    ......
    private GestureOperateListener supportGestureOperate = new GestureDetectHandler.SimpleGestureOperateListener() {
    private void init(Context context, AttributeSet attrs) {
        initAttrs(attrs);
        mGestureDetectHandler = new GestureDetectHandler(this, supportGestureOperate);
        //设置长按效果后延时取消的时间.
        mGestureDetectHandler.setDelayedCancelTimeoutAfterLongPress(2000);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        return mGestureDetectHandler.onTouchEvent(event);
    }
    ......
}

GestureDetectHandler是针对TouchEvent事件的综合处理类.
在构造时接收被侦测的View, 并给出相应的事件回调.
并覆写View的onTouchEvent方法, 将事件传递给处理者.

public class GestureDetectHandler extends GestureDetector.SimpleOnGestureListener implements ScaleGestureDetector.OnScaleGestureListener, View.OnTouchListener {
   public GestureDetectHandler(View detectedView, GestureOperateListener operator) {
       assert detectedView != null : Log.e(TAG, "detectedView is null in constructor!");
       assert operator != null : Log.e(TAG, "GestureOperateListener is null in constructor!");

       mDetectedView = detectedView;
       detectedView.setOnTouchListener(this);
       mHandler = new GestureHandler(detectedView.getContext().getMainLooper());
       mGestureOptListener = operator;

       mGestureDetector = new GestureDetector(mDetectedView.getContext(), this);
       mScaleGestureDetector = new ScaleGestureDetector(mDetectedView.getContext(), this);

       setIsCustomLongPressEnabled(true); //默认使用自定义的长按操作
   }

   public boolean onTouch(View v, MotionEvent event) {
       final int action = event.getAction();
       if (action == MotionEvent.ACTION_CANCEL) {
           loge("onTouch", actionToStr(action));
           //当mDetectedView的onTouchEvent事件突然交到父控件处理时, 紧急执行清理操作.
           dispatchCancel();
       }
       return false;
   }
   public boolean onTouchEvent(MotionEvent event) {
       mGestureDetector.onTouchEvent(event);
       mScaleGestureDetector.onTouchEvent(event);
       return true;
   }
}

在解决与父控件滚动事件冲突时, 可以通过阻止父层的View截获touch事件,就是调用getParent().requestDisallowInterceptTouchEvent(true);方法。一旦底层View收到touch的action后调用这个方法那么父层View就不会再调用onInterceptTouchEvent了,也无法截获以后的action。

//在发生滚动和长按时触发, 标示着mDetectedView要完全接收事件. 父控件不在干预.
mDetectedView.getParent().requestDisallowInterceptTouchEvent(true);
//当mDetectedView结束了相应的操作后, 要相应的给重置为false, 标示着允许父控件与子控件交互处理事件.
mDetectedView.getParent().requestDisallowInterceptTouchEvent(false);

GestureDetectHandler对于mDetectedView事件的处理时机的判断已经交由GestureDetector和ScaleGestureDetector来处理, 并在回调OnGestureListener, OnDoubleTapListener和OnScaleGestureListener中转换为
GestureOperateListener接口中定义的相应的操作, 最后回调给使用者.

固GestureDetectHandler主要是针对GestureOperateListener接口的操作做了相应的转换操作. 并主要针对

  1. 长按
    长按时间自定义
    解决与父控件的冲突
    长按效果延长时间的设置.
  2. 长按后的移动
    解决正常移动与自定义长按后移动的冲突.
  3. 单击事件的重新侦测
    长按后不会触发单击操作.
  4. 缩放
    缩放操作的自定义

完整的代码如下: ( 注解中已详尽说明)


/**
 * Created by zhaopan on 16/9/24.
 * e-mail: [email protected]
 * 手势识别转换处理类
 */
public class GestureDetectHandler extends GestureDetector.SimpleOnGestureListener implements ScaleGestureDetector.OnScaleGestureListener, View.OnTouchListener {
    private static final String TAG = "GestureDetectHandler";
    public static final boolean DEBUG = true;

    //最小缩放距离, 单位:像素
    public static final int MIN_SCALE_DISTANCE = 20;
    //最短缩放时间, 单位:毫秒
    public static final int MIN_SCALE_TIME_MILLI = 10;
    //最小移动距离
    public static final int MIN_MOVE_DISTANCE = 5;

    //X轴的坐标位移大于FLING_MIN_DISTANCE
    public static final int FLING_MIN_DISTANCE = 100;
    //移动速度大于FLING_MIN_VELOCITY个像素/秒
    public static final int FLING_MIN_VELOCITY = 150;

    public static final long CUSTOM_LONG_PRESS_TIMEOUT = 300;
    public static final long CUSTOM_SCALE_BEGIN_TIMEOUT = 0;
    public static final long CUSTOM_DELAYED_CANCEL_TIMEOUT_AFTER_LONG_PRESS = 100;

    private static final int LONG_PRESS = 1;
    private static final int SCALE_BEGIN = 2;
    private static final int DELAYED_CANCEL = 3;

    private long mLongPressTimeout = CUSTOM_LONG_PRESS_TIMEOUT;
    private long mScaleBeginTimeout = CUSTOM_SCALE_BEGIN_TIMEOUT;
    private long mDelayedCancelTimeoutAfterLongPress = CUSTOM_DELAYED_CANCEL_TIMEOUT_AFTER_LONG_PRESS;
    private boolean mInLongPressProgress = false;
    private boolean mInScaleProgress = false;
    private boolean mInDoubleTapProgress = false;
    private boolean mIsCanceled = true;
    private boolean mIsCustomLongPressEnabled = true;

    private float lastSpan;
    private MotionEvent showPressEvent;
    private View mDetectedView;
    private Handler mHandler;
    private GestureOperateListener mGestureOptListener;
    private GestureDetector mGestureDetector;//单击和双击事件手势识别
    private ScaleGestureDetector mScaleGestureDetector;//缩放事件手势识别

    public GestureDetectHandler(View detectedView, GestureOperateListener operator) {
        assert detectedView != null : Log.e(TAG, "detectedView is null in constructor!");
        assert operator != null : Log.e(TAG, "GestureOperateListener is null in constructor!");

        mDetectedView = detectedView;
        detectedView.setOnTouchListener(this);
        mHandler = new GestureHandler(detectedView.getContext().getMainLooper());
        mGestureOptListener = operator;

        mGestureDetector = new GestureDetector(mDetectedView.getContext(), this);
        mScaleGestureDetector = new ScaleGestureDetector(mDetectedView.getContext(), this);

        setIsCustomLongPressEnabled(true); //默认使用自定义的长按操作
    }

    private class GestureHandler extends Handler {
        GestureHandler() {
            super();
        }

        GestureHandler(Looper looper) {
            super(looper);
        }

        @Override
        public void handleMessage(Message msg) {
            switch (msg.what) {
                case LONG_PRESS:
                    dispatchLongPress();
                    break;
                case SCALE_BEGIN:
                    dispatchScaleBegin();
                    break;
                case DELAYED_CANCEL:
                    dispatchCancel();
                    break;
                default:
                    throw new RuntimeException("Unknown message " + msg); //never
            }
        }
    }

    /**
     * OnTouchListener 仅仅作为补充操作,
     * 防止长按后滑动和长按滑动后onFling, 这两个操作后续没有明确的结束回调, 即Up或Cancel时GestureDetector并不回调操作.
     * 不建议使用, 如是mDetectedView有去设置OnTouchListener则会覆盖此实现. 即会导致此中功能失效.
     *
     * @param v
     * @param event
     * @return
     */
    @Override
    @Deprecated
    public boolean onTouch(View v, MotionEvent event) {
        final int action = event.getAction();
        if (action == MotionEvent.ACTION_CANCEL) {
            loge("onTouch", actionToStr(action));
            //当mDetectedView的onTouchEvent事件突然交到父控件处理时, 紧急执行清理操作.
            dispatchCancel();
        }
        //改由GestureDetector的每一步单独处理, 减少重复的绘制操作.
        //mGestureOptListener.postInvalidate();
        return false;
    }

    /**
     * 接收系统的onTouchEvent事件, 并返回true表示处理, 不再传递
     *
     * @param event
     * @return
     */
    public boolean onTouchEvent(MotionEvent event) {
        mGestureDetector.onTouchEvent(event);
        mScaleGestureDetector.onTouchEvent(event);
        //return super.onTouchEvent(event);//不管返回值是什么,都能接收down事件,都能触发onDown、onShowPress、onLongPress
        return true;//但只有返回true才能继续接收move,up等事件,也才能响应ScaleGestureDetector事件及GestureDetector中与move,up相关的事件
    }

    private void dispatchLongPress() {
        mDetectedView.getParent().requestDisallowInterceptTouchEvent(true);
        mInLongPressProgress = true;
        onLongPress(showPressEvent);
    }

    private void dispatchScaleBegin() {
        mDetectedView.getParent().requestDisallowInterceptTouchEvent(true);
        mInScaleProgress = true;
        if(mInLongPressProgress) {
            mInLongPressProgress = false;
            mHandler.removeMessages(LONG_PRESS);
            mGestureOptListener.onUpOrCancel();
            mGestureOptListener.postInvalidate();
        }
    }

    //ACTION_CANCEL and ACTION_UP
    private void dispatchCancel() {
        loge("dispatchCancel", "dispatchCancel");
        if (!mIsCanceled) {
            mIsCanceled = true;
            mDetectedView.getParent().requestDisallowInterceptTouchEvent(false);
            mHandler.removeMessages(DELAYED_CANCEL);
            mHandler.removeMessages(LONG_PRESS);
            mHandler.removeMessages(SCALE_BEGIN);
            mInDoubleTapProgress = false;
            mInLongPressProgress = false;
            mInScaleProgress = false;
            mGestureOptListener.onUpOrCancel();
        }
        mGestureOptListener.postInvalidate();
    }

    /**
     * 设置是否使用自己的长按处理.
     *
     * @param isCustomLongPressEnabled
     */
    public void setIsCustomLongPressEnabled(boolean isCustomLongPressEnabled) {
        if (isCustomLongPressEnabled) {
            //如果自定义自己的长按处理, 先禁用系统的长按触发.
            mGestureDetector.setIsLongpressEnabled(false);
        } else {
            //如果不自定义自己的长按处理, 默认启用系统的长按
            mGestureDetector.setIsLongpressEnabled(true);
        }
        //mGestureDetector.setIsLongpressEnabled(!isCustomLongPressEnabled);
        mIsCustomLongPressEnabled = isCustomLongPressEnabled;
    }

    /**
     * 设置是否使用系统的长按处理.
     *
     * @param isSystemLongPressEnabled
     */
    public void setIsLongpressEnabled(boolean isSystemLongPressEnabled) {
        mGestureDetector.setIsLongpressEnabled(isSystemLongPressEnabled);
        mIsCustomLongPressEnabled = false;
    }

    public void setScaleBeginTimeout(long scaleBeginTimeout) {
        if (scaleBeginTimeout >= 0) this.mScaleBeginTimeout = scaleBeginTimeout;
    }

    public void setLongPressTimeout(long longPressTimeout) {
        if (longPressTimeout >= 0) this.mLongPressTimeout = longPressTimeout;
    }

    /**
     * 设置长按后的处理操作 需要延时多长时间执行清理操作. 默认大于等于100毫秒. 且会自动开启自定义的长按操作处理.
     *
     * @param cancelTimeout
     */
    public void setDelayedCancelTimeoutAfterLongPress(long cancelTimeout) {
        if (cancelTimeout >= CUSTOM_DELAYED_CANCEL_TIMEOUT_AFTER_LONG_PRESS) {
            setIsCustomLongPressEnabled(true);
            this.mDelayedCancelTimeoutAfterLongPress = cancelTimeout;
        }
    }

    private void sendDelayedCancelMessage() {
        mHandler.removeMessages(DELAYED_CANCEL);
        mHandler.sendEmptyMessageDelayed(DELAYED_CANCEL, mDelayedCancelTimeoutAfterLongPress);
    }

    public GestureDetector getGestureDetector() {
        return mGestureDetector;
    }

    public ScaleGestureDetector getScaleGestureDetector() {
        return mScaleGestureDetector;
    }

    /**
     * 注意:
     * 1. onSingleTapConfirmed(单击)和onSingleTapUp都是在down后既没有滑动onScroll,又没有长按onLongPress时, up 时触发的
     * 2. 非常快的点击一下:onDown->onSingleTapUp->onSingleTapConfirmed
     * 3. 稍微慢点的点击一下:onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed(最后一个不一定会触发)
     */
    ////////OnGestureListener/////////////////////////////

    /**
     * Touch down时触发
     * 按下(onDown): 刚刚手指接触到触摸屏的那一刹那,就是触的那一下
     *
     * @param e
     * @return
     */
    @Override
    public boolean onDown(MotionEvent e) {
        loge("view-手势", "onDown event.getAction=" + actionToStr(e.getAction()) + ", event.getX()=" + e.getX() + ", event.getY()=" + e.getY());
        mInLongPressProgress = false;
        mIsCanceled = false;
        return super.onDown(e);
    }

    /**
     * onScroll一点距离后,【抛掷时】触发(若是轻轻的、慢慢的停止活动,而非抛掷,则很可能不触发)
     * 参数为手指接触屏幕、离开屏幕一瞬间的动作事件,及手指水平、垂直方向移动的速度,像素/秒
     * 抛掷(onFling): 手指在触摸屏上迅速移动,并松开的动作,onDown -> onScroll ... -> onFling
     * 长按后滚动(onScroll): 手指在触摸屏上滑动,onDown -> onShowPress -> onLongPress -> onScroll ... [onFling]
     *
     * @param downEvent
     * @param event
     * @param velocityX
     * @param velocityY
     * @return
     */
    @Override
    public boolean onFling(MotionEvent downEvent, MotionEvent event, float velocityX, float velocityY) {
        loge("view-手势", "onFling newAction=" + actionToStr(event.getAction()) + ", downEvent.getRawX()=" + downEvent.getRawX() + ", event.getRawX()=" + event.getRawX() + ", velocityX=" + velocityX + ", velocityY=" + velocityY);
        mGestureOptListener.onFling(downEvent, event, velocityX, velocityY);
        mGestureOptListener.postInvalidate();
        if (mIsCustomLongPressEnabled && mInLongPressProgress) {
            sendDelayedCancelMessage(); //长按后滑动, 最后onFling了一下, 执行延时清理操作.
        } else {
            dispatchCancel(); //正常的onFling, 直接执行清理操作.
        }
        /*if ((event.getRawX() - downEvent.getRawX()) > FLING_MIN_DISTANCE *//*&& Math.abs(velocityX) > FLING_MIN_VELOCITY*//*) {
            loge("view-手势", "onFling-从左往右滑");
            return true;
        } else if (downEvent.getRawX() - event.getRawX() > FLING_MIN_DISTANCE *//*&& Math.abs(velocityX) > FLING_MIN_VELOCITY*//*) {
            loge("view-手势", "onFling-从右往左滑");
            return true;
        }*/
        return super.onFling(downEvent, event, velocityX, velocityY);
    }

    /**
     * Touch了滑动时触发,e1代表触摸时的事件,是不变的,e2代表滑动过程中的事件,是时刻变化的
     * distance是当前event2与上次回调时的event2之间的距离,代表上次回调之后到这次回调之前移动的距离
     * 缩放(onScroll) onDown -> onScaleBegin -> (onScroll ... -> onScale) ... -> onScaleEnd
     * 长按后滚动(onScroll): 手指在触摸屏上滑动,onDown -> onShowPress -> onLongPress -> onScroll ... [onFling]
     * 滚动(onScroll): 手指在触摸屏上滑动,onDown -> onScroll ...
     *
     * @param downEvent
     * @param event
     * @param distanceX
     * @param distanceY
     * @return
     */
    @Override
    public boolean onScroll(MotionEvent downEvent, MotionEvent event, float distanceX, float distanceY) {
        if (mInScaleProgress) {
            // TODO: 16/9/27 缩放中的同步滑动
            loge("view-手势", "onScroll 缩放中>>> " + actionToStr(event.getAction()) + ", -X-" + (int) downEvent.getX() + "/" + (int) event.getX() + "/" + (int) distanceX
                    + ", >>> -Y-" + (int) downEvent.getY() + "/" + (int) event.getY() + "/" + (int) distanceY);
        } else if (mInLongPressProgress) { //长按后的滑动.
            loge("view-手势", "onScroll 长按中>>> " + actionToStr(event.getAction()) + ", -X-" + (int) downEvent.getX() + "/" + (int) event.getX() + "/" + (int) distanceX
                    + ", >>> -Y-" + (int) downEvent.getY() + "/" + (int) event.getY() + "/" + (int) distanceY);
            mGestureOptListener.onMoveAfterLongPress(event);
            mGestureOptListener.postInvalidate(); //后续仍有移动, 执行刷新UI操作
            if (mIsCustomLongPressEnabled) {
                sendDelayedCancelMessage(); //长按后的滑动操作, 执行延时清理操作
            } else {
                // TODO: 16/9/27 注: 没有自定义长按操作, 如果没有后续操作是不会有Up或Cancel动作, 即没有执行清理操作的机会了.
            }
        } else { //普通滑动
            loge("view-手势", "onScroll 滑动中>>> " + actionToStr(event.getAction()) + ", -X-" + (int) downEvent.getX() + "/" + (int) event.getX() + "/" + (int) distanceX
                    + ", >>> -Y-" + (int) downEvent.getY() + "/" + (int) event.getY() + "/" + (int) distanceY);
            mGestureOptListener.onMove(downEvent, event, distanceX, distanceY);
            mGestureOptListener.postInvalidate(); //后续仍有移动, 执行刷新UI操作
            // TODO: 16/9/27 注: 普通的滑动操作, 如果没有后续操作是不会有Up或Cancel动作, 即没有执行清理操作的机会了.
        }
        return super.onScroll(downEvent, event, distanceX, distanceY);
    }

    /**
     * ouch了不移动一直Touch down时触发
     * 长按(onLongPress): 手指按在持续一段时间,并且没有松开
     * 1. onDown -> onShowPress -> onLongPress -> onSingleTapUp -> onSingleTapConfirmed
     * 2. onDown -> onShowPress -> onLongPress -> onScroll ...
     * 3. onDown -> onShowPress -> onLongPress -> onScroll ... -> onFling
     *
     * @param event
     */
    @Override
    public void onLongPress(MotionEvent event) {
        loge("view-手势", "onLongPress event.getAction=" + actionToStr(event.getAction()) + ", event.getX()=" + event.getX() + ", event.getY()=" + event.getY());
        mGestureOptListener.onLongPress(event);
        mGestureOptListener.postInvalidate();
        super.onLongPress(event);
    }

    /**
     * Touch了还没有滑动时触发
     * 按住(onShowPress): 手指按在触摸屏上,在按下起效,在长按前失效,
     * onDown -> onShowPress -> onLongPress
     *
     * @param e
     */
    @Override
    public void onShowPress(MotionEvent e) {
        loge("view-手势", "onShowPress event.getAction=" + actionToStr(e.getAction()) + ",  event.getX()=" + e.getX() + ", event.getY()=" + e.getY());
        if (mIsCustomLongPressEnabled && !mInDoubleTapProgress) { //如果自定义长按启用, 并且不是在双击的第二下长按的, 即执行长按操作.
            mHandler.sendEmptyMessageAtTime(LONG_PRESS, e.getDownTime() + mLongPressTimeout);
            showPressEvent = e;
        } else { //没有设置自定义长按操作
            mDetectedView.getParent().requestDisallowInterceptTouchEvent(true); //参考dispatchLongPress();
            mInLongPressProgress = true;
        }
        super.onShowPress(e);
    }

    /**
     * 在touch down后又没有滑动(onScroll),又没有长按(onLongPress),然后Touchup时触发。
     * 抬起(onSingleTapUp):手指离开触摸屏的那一刹那
     *
     * @param e
     * @return
     */
    @Override
    public boolean onSingleTapUp(MotionEvent e) {
        loge("view-手势", "onSingleTapUp event.getAction=" + actionToStr(e.getAction()) + ", event.getX()=" + e.getX() + ", event.getY()=" + e.getY());
        return super.onSingleTapUp(e);
    }

    ////////OnDoubleTapListener/////////////////////////////

    /**
     * 在touch down后又没有滑动(onScroll),又没有长按(onLongPress),然后Touchup时触发。
     * 单击确认,即很快的按下并抬起,但并不连续点击第二下
     *
     * @param event
     * @return
     */
    @Override
    public boolean onSingleTapConfirmed(MotionEvent event) {
        loge("view-手势", "onSingleTapConfirmed event.getAction=" + actionToStr(event.getAction()) + ", event.getX()=" + event.getX() + ", event.getY()=" + event.getY());
        if (mInLongPressProgress) {
            //长按进行中... 如果设置了自定义长按操作, 执行延时清理操作, 否则直接清理.
            if (mIsCustomLongPressEnabled) {
                sendDelayedCancelMessage();
            } else {
                dispatchCancel();
            }
        } else {
            //执行单击操作.
            mGestureOptListener.onClick(event);
            dispatchCancel(); //后续没有操作并已经Up或Cancel了, 所以执行清理操作.
        }

        return super.onSingleTapConfirmed(event);
    }

    /**
     * 双击的【第二下】Touch down时触发(只执行一次)
     *
     * @param e
     * @return
     */
    @Override
    public boolean onDoubleTap(MotionEvent e) {
        loge("view-手势", "onDoubleTap event.getAction=" + actionToStr(e.getAction()) + ", event.getX()=" + e.getX() + ", event.getY()=" + e.getY());
        mInDoubleTapProgress = true;
        return super.onDoubleTap(e);
    }

    /**
     * 双击的【第二下】Touch down和up都会触发(执行次数不确定)。
     *
     * @param event
     * @return
     */
    @Override
    public boolean onDoubleTapEvent(MotionEvent event) {
        loge("view-手势", "onDoubleTapEvent event.getAction=" + actionToStr(event.getAction()) + ", event.getX()=" + event.getX() + ", event.getY()=" + event.getY());
        if (event.getAction() == MotionEvent.ACTION_UP || event.getAction() == MotionEvent.ACTION_CANCEL) {
            mGestureOptListener.onDoubleClick(event);
            dispatchCancel(); //双击操作完成并Up或Cancel, 所以执行清理操作
        }
        return super.onDoubleTapEvent(event);
    }

    ////////OnContextClickListener/////////////////////////////
    @Override
    public boolean onContextClick(MotionEvent e) {
        loge("view-手势", "onContextClick event.getX()=" + e.getX() + ", event.getY()=" + e.getY());
        return super.onContextClick(e);
    }

    ////////OnScaleGestureListener/////////////////////////////
    /**
     * http://www.cnblogs.com/baiqiantao/p/5630506.html
     * public float getCurrentSpan () 返回手势过程中,组成该手势的两个触点的当前距离。
     * public long getEventTime () 返回事件被捕捉时的时间。
     * public float getFocusX () 返回当前手势焦点的 X 坐标。 如果手势正在进行中,焦点位于组成手势的两个触点之间。 如果手势正在结束,焦点为仍留在屏幕上的触点的位置。若 isInProgress() 返回 false,该方法的返回值未定义。
     * public float getFocusY ()  返回当前手势焦点的 Y 坐标。
     * public float getPreviousSpan () 返回手势过程中,组成该手势的两个触点的前一次距离。
     * public float getScaleFactor () 返回从前一个伸缩事件至当前伸缩事件的伸缩比率。该值定义为  getCurrentSpan() / getPreviousSpan()。
     * public long getTimeDelta () 返回前一次接收到的伸缩事件距当前伸缩事件的时间差,以毫秒为单位。
     * public boolean isInProgress () 如果手势处于进行过程中,返回 true。否则返回 false。
     */

    /**
     * 开始缩放
     *
     * @param detector
     * @return
     */
    @Override
    public boolean onScale(ScaleGestureDetector detector) {
        if (mInScaleProgress) { //缩放中...
            float distance = detector.getCurrentSpan() - lastSpan;
            if (Math.abs(distance) > MIN_SCALE_DISTANCE) {
                lastSpan = detector.getCurrentSpan();
                if (detector.getScaleFactor() < 1) { //缩小
                    Log.e("view-缩放", "onScale,缩小" + detector.getScaleFactor() + ", curSpan=" + detector.getCurrentSpan() + ", preSpan=" + detector.getPreviousSpan() + ", curSpan-preSpan=>" + distance + ", timeDelta=" + detector.getTimeDelta());
                } else { //放大
                    Log.e("view-缩放", "onScale,放大" + detector.getScaleFactor() + ", curSpan=" + detector.getCurrentSpan() + ", preSpan=" + detector.getPreviousSpan() + ",  curSpan-preSpan=>" + distance + ", timeDelta=" + detector.getTimeDelta());
                }
                mGestureOptListener.onZoom(detector);
                mGestureOptListener.postInvalidate(); //并没Up或Cancel且后续仍在Zoom, 执行刷新UI操作
            }
        }
        return false;
    }

    /**
     * 缩放开始, 一次缩放仅执行一次
     *
     * @param detector
     * @return
     */
    @Override
    public boolean onScaleBegin(ScaleGestureDetector detector) {
        loge("view-缩放", "onScaleBegin");
        mHandler.sendEmptyMessageAtTime(SCALE_BEGIN, detector.getEventTime() + mScaleBeginTimeout);
        return true;
    }

    /**
     * 缩放结束, 一次缩放仅执行一次
     *
     * @param detector
     */
    @Override
    public void onScaleEnd(ScaleGestureDetector detector) {
        loge("view-缩放", "onScaleEnd");
        dispatchCancel(); //已经停止缩放操作并Up或Cancel, 执行清理操作.
    }

    /**
     * @see ScaleGestureDetector#getCurrentSpanX()
     */
    @TargetApi(Build.VERSION_CODES.HONEYCOMB)
    public static float getCurrentSpanX(ScaleGestureDetector scaleGestureDetector) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
            return scaleGestureDetector.getCurrentSpanX();
        } else {
            return scaleGestureDetector.getCurrentSpan();
        }
    }

    /**
     * @see ScaleGestureDetector#getCurrentSpanY()
     */
    @TargetApi(Build.VERSION_CODES.HONEYCOMB)
    public static float getCurrentSpanY(ScaleGestureDetector scaleGestureDetector) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
            return scaleGestureDetector.getCurrentSpanY();
        } else {
            return scaleGestureDetector.getCurrentSpan();
        }
    }

    private static void loge(String TAG, String msg) {
        if (DEBUG) Log.e("zp>>>" + TAG, msg);
    }

    private static String actionToStr(int action) {
        switch (action) {
            case MotionEvent.ACTION_DOWN:
                return "DOWN_" + action;
            case MotionEvent.ACTION_UP:
                return "UP_" + action;
            case MotionEvent.ACTION_MOVE:
                return "MOVE_" + action;
            case MotionEvent.ACTION_CANCEL:
                return "CANCEL_" + action;
        }
        return "<" + action + ">";
    }

   //省略 GestureOperateListener与SimpleGestureOperateListener的定义.
}

自此, GestureDetectHandler已经完成对于TouchEvent事件的转换, 并符合项目所支持的所有操作.
对于后续操作的处理. 接口定义方法中的参数已经足够给使用者完成处理.

以后如遇到自定义View的事件处理时, 可简单的使用它便能很好的完成事件操作的处理.
且可自定义操作.

欢迎指出缺陷及不足, 一起成长.

你可能感兴趣的:(Android 手势识别处理转换)