看完這篇還不會 GestureDetector 手勢檢測，我跪搓衣板！

本文轉載自查看原文 2019-06-25 11:47 1863 android/ 手勢/ 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);
        }
        
    };

本篇博客，是我對我學習過程的總結，所以其中難免有疏漏，希望大家能在評論區中指出，萬分感謝。

同時，如果大家有任何疑問，也可以在評論區中留言、討論，這個搓衣板跪不跪，你們說了算！🙏

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 看完這篇還不會自定義 View ，我跪搓衣板看完這篇再不會 View 的動畫框架，我跪搓衣板用戶手勢檢測-GestureDetector使用詳解用戶手勢檢測-GestureDetector使用詳解 android 判斷左右滑動，上下滑動的GestureDetector簡單手勢檢測手勢觸摸【縮放】GestureDetector MotionEvent 案例 Android手勢監聽類GestureDetector的使用 Flutter學習筆記（33）--GestureDetector手勢識別 android使用GestureDetector實現手勢下滑關閉頁面的效果。 Hololens開發筆記之Gesture手勢識別（手勢檢測反饋）