編寫 Android 觸摸屏手勢識別程序

不少時候，利用觸摸屏的Fling、Scroll等Gesture（手勢）操做來操做會使得應用程序的用戶體驗大大提高，好比用Scroll手勢在 瀏覽器中滾屏，用Fling在閱讀器中翻頁等。在Android系統中，手勢的識別是經過 GestureDetector.OnGestureListener接口來實現的，不過William翻遍了Android的官方文檔也沒有找到一個相 關的例子，API Demo中的TouchPaint也僅僅是提到了onTouch事件的處理，沒有涉及到手勢。

咱們先來明確一些概念，首先，Android的事件處理機制是基於Listener（監聽器）來實現的，比咱們今天所說的觸摸屏相關的事件，就是通 過onTouchListener。其次，全部View的子類均可以經過setOnTouchListener()、 setOnKeyListener()等方法來添加對某一類事件的監聽器。第三，Listener通常會以Interface（接口）的方式來提供，其中 包含一個或多個abstract（抽象）方法，咱們須要實現這些方法來完成onTouch()、onKey()等等的操做。這樣，當咱們給某個view設 置了事件Listener，並實現了其中的抽象方法之後，程序即可以在特定的事件被dispatch到該view的時候，經過callbakc函數給予適 當的響應。

看一個簡單的例子，就用最簡單的TextView來講明（事實上和ADT中生成的skeleton沒有什麼區別）。

01. publicclassGestureTestextendsActivityimplementsOnTouchListener{

02.

03.    @Override

04.    protectedvoidonCreate(Bundle savedInstanceState) {

05.        super.onCreate(savedInstanceState);

06.        setContentView(R.layout.main);

07.

08.        // init TextView

09.        TextView tv = (TextView) findViewById(R.id.page);

10.        // set OnTouchListener on TextView

11.        tv.setOnTouchListener(this);

12.        // show some text

13.        tv.setText(R.string.text);

14.    }

15.

16.    @Override

17.    publicbooleanonTouch(View v, MotionEvent event) {

18.        Toast.makeText(this,"onTouch", Toast.LENGTH_SHORT).show();

19.        returnfalse;

20.    }

咱們給TextView的實例tv設定了一個onTouchListener，由於GestureTest類實現了OnTouchListener 接口，因此簡單的給一個this做爲參數便可。onTouch方法則是實現了OnTouchListener中的抽象方法，咱們只要在這裏添加邏輯代碼即 可在用戶觸摸屏幕時作出響應，就像咱們這裏所作的——打出一個提示信息。

這裏，咱們能夠經過MotionEvent的getAction()方法來獲取Touch事件的類型，包括 ACTION_DOWN, ACTION_MOVE, ACTION_UP, 和ACTION_CANCEL。ACTION_DOWN是指按下觸摸屏，ACTION_MOVE是指按下觸摸屏後移動受力點，ACTION_UP則是指鬆 開觸摸屏，ACTION_CANCEL不會由用戶直接觸發（因此不在今天的討論範圍，請參考ViewGroup.onInterceptTouchEvent(MotionEvent)）。藉助對於用戶不一樣操做的判斷，結合getRawX()、getRawY()、getX()和getY()等方法來獲取座標後，咱們能夠實現諸如拖動某一個按鈕，拖動滾動條等功能。待機能夠看看MotionEvent類的文檔，另外也能夠看考TouchPaint例子。

回到今天所要說的重點，當咱們捕捉到Touch操做的時候，如何識別出用戶的Gesture？這裏咱們須要GestureDetector.OnGestureListener接口的幫助，因而咱們的GestureTest類就變成了這個樣子。

1. publicclassGestureTestextendsActivityimplementsOnTouchListener,

2.        OnGestureListener {

3. ...

4. }

隨後，在onTouch()方法中，咱們調用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給  GestureDetector 來分析是否有合適的callback函數來處理用戶的手勢。

1. @Override

2.    publicbooleanonTouch(View v, MotionEvent event) {

3.        // OnGestureListener will analyzes the given motion event

4.        returnmGestureDetector.onTouchEvent(event);

5.    }

接下來，咱們實現瞭如下6個抽象方法，其中最有用的固然是onFling()、onScroll()和onLongPress()了。我已經把每個方法表明的手勢的意思寫在了註釋裏，你們看一下就明白了。

01. // 用戶輕觸觸摸屏，由1個MotionEvent ACTION_DOWN觸發

02.    @Override

03.    publicbooleanonDown(MotionEvent e) {

04.        // TODO Auto-generated method stub

05.        Toast.makeText(this,"onDown", Toast.LENGTH_SHORT).show();

06.        returnfalse;

07.    }

08.

09.    // 用戶輕觸觸摸屏，還沒有鬆開或拖動，由一個1個MotionEvent ACTION_DOWN觸發

10.    // 注意和onDown()的區別，強調的是沒有鬆開或者拖動的狀態

11.    @Override

12.    publicvoidonShowPress(MotionEvent e) {

13.        // TODO Auto-generated method stub

14.    }

15.

16.    // 用戶（輕觸觸摸屏後）鬆開，由一個1個MotionEvent ACTION_UP觸發

17.    @Override

18.    publicbooleanonSingleTapUp(MotionEvent e) {

19.        // TODO Auto-generated method stub

20.        returnfalse;

21.    }

22.

23.    // 用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發

24.    @Override

25.    publicbooleanonFling(MotionEvent e1, MotionEvent e2,floatvelocityX,

26.            floatvelocityY) {

27.        // TODO Auto-generated method stub

28.        returnfalse;

29.    }

30.

31.    // 用戶長按觸摸屏，由多個MotionEvent ACTION_DOWN觸發

32.    @Override

33.    publicvoidonLongPress(MotionEvent e) {

34.        // TODO Auto-generated method stub

35.

36.    }

37.

38.    // 用戶按下觸摸屏，並拖動，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發

39.    @Override

40.    publicbooleanonScroll(MotionEvent e1, MotionEvent e2,floatdistanceX,

41.            floatdistanceY) {

42.        // TODO Auto-generated method stub

43.        returnfalse;

44.    }

咱們來試着作一個onFling()事件的處理吧，onFling()方法中每個參數的意義我寫在註釋中了，須要注意的是Fling事件的處理代 碼中，除了第一個觸發Fling的ACTION_DOWN和最後一個ACTION_MOVE中包含的座標等信息外，咱們還能夠根據用戶在X軸或者Y軸上的 移動速度做爲條件。好比下面的代碼中咱們就在用戶移動超過100個像素，且X軸上每秒的移動速度大於200像素時才進行處理。

01. @Override

02. publicbooleanonFling(MotionEvent e1, MotionEvent e2,floatvelocityX,

03.        floatvelocityY) {

04.    // 參數解釋：

05.    // e1：第1個ACTION_DOWN MotionEvent

06.    // e2：最後一個ACTION_MOVE MotionEvent

07.    // velocityX：X軸上的移動速度，像素/秒

08.    // velocityY：Y軸上的移動速度，像素/秒

09.

10.    // 觸發條件 ：

11.    // X軸的座標位移大於FLING_MIN_DISTANCE，且移動速度大於FLING_MIN_VELOCITY個像素/秒

12.

13.    if(e1.getX() - e2.getX() > FLING_MIN_DISTANCE

14.            && Math.abs(velocityX) > FLING_MIN_VELOCITY) {

15.        // Fling left

16.        Toast.makeText(this,"Fling Left", Toast.LENGTH_SHORT).show();

17.    }elseif(e2.getX() - e1.getX() > FLING_MIN_DISTANCE

18.            && Math.abs(velocityX) > FLING_MIN_VELOCITY) {

19.        // Fling right

20.        Toast.makeText(this,"Fling Right", Toast.LENGTH_SHORT).show();

21.    }

22.

23.    returnfalse;

24. }

問題是，這個時候若是咱們嘗試去運行程序，你會發現咱們根本得不到想要的結果，跟蹤代碼的執行的會發現onFling()事件一直就沒有被捕捉到。這正是一開始困擾個人問題，這究竟是爲何呢？
我在討論組的Gesture detection這個帖子裏找到了答案，即咱們須要在onCreate中tv.setOnTouchListener(this);以後添加以下一句代碼。

1. tv.setLongClickable(true);

只有這樣，view纔可以處理不一樣於Tap（輕觸）的hold（即ACTION_MOVE，或者多個ACTION_DOWN），咱們一樣能夠經過layout定義中的android:longClickable來作到這一點。

此次遇到的這個問題和上次MapView中setOnKeyListener遇到的問題挺相似，其實都是對SDK的瞭解不夠全面，遇到了一次記住了就好。不過話說回來，Google在文檔方面確實須要增強了，起碼能夠在OnGestureListener中說明須要知足那些條件才能夠保證手勢被正確識別。