不少時候,利用觸摸屏的Fling、Scroll等Gesture(手勢)操做來操做會使得應用程序的用戶體驗大大提高,好比用Scroll手勢在 瀏覽器中滾屏,用Fling在閱讀器中翻頁等。在Android系統中,手勢的識別是經過 GestureDetector.OnGestureListener接口來實現的,不過William翻遍了Android的官方文檔也沒有找到一個相 關的例子,API Demo中的TouchPaint也僅僅是提到了onTouch事件的處理,沒有涉及到手勢。Android Developer討論組裏也有很多人有和我相似的問題,結合他們提到的方法和我所作的實驗,我將給你們簡單講述一下Android中手勢識別的實現。
咱們先來明確一些概念,首先,Android的事件處理機制是基於Listener(監聽器)來實現的,比咱們今天所說的觸摸屏相關的事件,就是通 過onTouchListener。其次,全部View的子類均可以經過setOnTouchListener()、 setOnKeyListener()等方法來添加對某一類事件的監聽器。第三,Listener通常會以Interface(接口)的方式來提供,其中 包含一個或多個abstract(抽象)方法,咱們須要實現這些方法來完成onTouch()、onKey()等等的操做。這樣,當咱們給某個view設 置了事件Listener,並實現了其中的抽象方法之後,程序即可以在特定的事件被dispatch到該view的時候,經過callbakc函數給予適 當的響應。
看一個簡單的例子,就用最簡單的TextView來講明(事實上和ADT中生成的skeleton沒有什麼區別)。
Java代碼
java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // init TextView TextView tv = (TextView) findViewById(R.id.page); // set OnTouchListener on TextView tv.setOnTouchListener(this); // show some text tv.setText(R.string.text); } @Override public boolean onTouch(View v, MotionEvent event) { Toast.makeText(this, "onTouch", Toast.LENGTH_SHORT).show(); return false; }
咱們給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類就變成了這個樣子。
Java代碼
android
public class GestureTest extends Activity implements OnTouchListener, OnGestureListener { .... }
隨後,在onTouch()方法中,咱們調用GestureDetector的onTouchEvent()方法,將捕捉到的MotionEvent交給 GestureDetector 來分析是否有合適的callback函數來處理用戶的手勢。
Java代碼
瀏覽器
@Override public boolean onTouch(View v, MotionEvent event) { // OnGestureListener will analyzes the given motion event return mGestureDetector.onTouchEvent(event); }
接下來,咱們實現瞭如下6個抽象方法,其中最有用的固然是onFling()、onScroll()和onLongPress()了。我已經把每個方法表明的手勢的意思寫在了註釋裏,你們看一下就明白了。
// 用戶輕觸觸摸屏,由1個MotionEvent ACTION_DOWN觸發Java代碼
ide
@Override public boolean onDown(MotionEvent e) { // TODO Auto-generated method stub Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show(); return false; } // 用戶輕觸觸摸屏,還沒有鬆開或拖動,由一個1個MotionEvent ACTION_DOWN觸發 // 注意和onDown()的區別,強調的是沒有鬆開或者拖動的狀態 @Override public void onShowPress(MotionEvent e) { // TODO Auto-generated method stub }
用戶(輕觸觸摸屏後)鬆開,由一個1個MotionEvent ACTION_UP觸發
函數
@Override public boolean onSingleTapUp(MotionEvent e) { // TODO Auto-generated method stub return false; }
用戶按下觸摸屏、快速移動後鬆開,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發
this
@Override public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) { // TODO Auto-generated method stub return false; } // 用戶長按觸摸屏,由多個MotionEvent ACTION_DOWN觸發 @Override public void onLongPress(MotionEvent e) { // TODO Auto-generated method stub } // 用戶按下觸摸屏,並拖動,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發 @Override public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) { // TODO Auto-generated method stub return false; }
咱們來試着作一個onFling()事件的處理吧,onFling()方法中每個參數的意義我寫在註釋中了,須要注意的是Fling事件的處理代 碼中,除了第一個觸發Fling的ACTION_DOWN和最後一個ACTION_MOVE中包含的座標等信息外,咱們還能夠根據用戶在X軸或者Y軸上的 移動速度做爲條件。好比下面的代碼中咱們就在用戶移動超過100個像素,且X軸上每秒的移動速度大於200像素時才進行處理。
spa
@Override public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) { // 參數解釋: // e1:第1個ACTION_DOWN MotionEvent // e2:最後一個ACTION_MOVE MotionEvent // velocityX:X軸上的移動速度,像素/秒 // velocityY:Y軸上的移動速度,像素/秒 // 觸發條件 : // X軸的座標位移大於FLING_MIN_DISTANCE,且移動速度大於FLING_MIN_VELOCITY個像素/秒 if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) { // Fling left Toast.makeText(this, "Fling Left", Toast.LENGTH_SHORT).show(); } else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) { // Fling right Toast.makeText(this, "Fling Right", Toast.LENGTH_SHORT).show(); } return false; }
問題是,這個時候若是咱們嘗試去運行程序,你會發現咱們根本得不到想要的結果,跟蹤代碼的執行的會發現onFling()事件一直就沒有被捕捉到。這正是一開始困擾個人問題,這究竟是爲何呢?
我在討論組的Gesture detection這個帖子裏找到了答案,即咱們須要在onCreate中tv.setOnTouchListener(this);以後添加以下一句代碼。
tv.setLongClickable(true);
只有這樣,view纔可以處理不一樣於Tap(輕觸)的hold(即ACTION_MOVE,或者多個ACTION_DOWN),咱們一樣能夠經過layout定義中的android:longClickable來作到這一點。
此次遇到的這個問題和上次MapView中setOnKeyListener遇到的問題挺相似,其實都是對SDK的瞭解不夠全面,遇到了一次記住了就好。不過話說回來,Google在文檔方面確實須要增強了,起碼能夠在OnGestureListener中說明須要知足那些條件才能夠保證手勢被正確識別。 code