簡述Android觸摸屏手勢識別
很多時候，利用觸摸屏的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沒有什麼區別）。
public class GestureTest extends Activity implements OnTouchListener{
@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 代碼
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觸發
@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觸發
Java 代碼
@Override
public boolean onSingleTapUp(MotionEvent e) {
// TODO Auto-generated method stub
return false;
}
// 用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發
@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像素時才進行處理。
@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中說明需要滿足那些條件纔可以保證手勢被正 確識別。
很多時候，利用觸摸屏的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沒有什麼區別）。
public class GestureTest extends Activity implements OnTouchListener{
@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 代碼
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觸發
@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觸發
Java 代碼
@Override
public boolean onSingleTapUp(MotionEvent e) {
// TODO Auto-generated method stub
return false;
}
// 用戶按下觸摸屏、快速移動後鬆開，由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發
@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像素時才進行處理。
@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中說明需要滿足那些條件纔可以保證手勢被正 確識別。
