編寫(xiě)Android觸摸屏手勢(shì)識(shí)別程序
我們先來(lái)明確一些概念，首先，Android的事件處理機(jī)制是基于Listener(監(jiān)聽(tīng)器)來(lái)實(shí)現(xiàn)的，比我們今天所說(shuō)的觸摸屏相關(guān)的事件，就是通 過(guò)onTouchListener。其次，所有View的子類(lèi)都可以通過(guò)setOnTouchListener()、 setOnKeyListener()等方法來(lái)添加對(duì)某一類(lèi)事件的監(jiān)聽(tīng)器。第三，Listener一般會(huì)以Interface(接口)的方式來(lái)提供，其中 包含一個(gè)或多個(gè)abstract(抽象)方法，我們需要實(shí)現(xiàn)這些方法來(lái)完成onTouch()、onKey()等等的操作。這樣，當(dāng)我們給某個(gè)view設(shè) 置了事件Listener，并實(shí)現(xiàn)了其中的抽象方法以后，程序便可以在特定的事件被dispatch到該view的時(shí)候，通過(guò)callbakc函數(shù)給予適 當(dāng)?shù)捻憫?yīng)。
看一個(gè)簡(jiǎn)單的例子，就用最簡(jiǎn)單的TextView來(lái)說(shuō)明(事實(shí)上和ADT中生成的skeleton沒(méi)有什么區(qū)別)。
- 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的實(shí)例tv設(shè)定了一個(gè)onTouchListener，因?yàn)镚estureTest類(lèi)實(shí)現(xiàn)了OnTouchListener 接口，所以簡(jiǎn)單的給一個(gè)this作為參數(shù)即可。onTouch方法則是實(shí)現(xiàn)了OnTouchListener中的抽象方法，我們只要在這里添加邏輯代碼即 可在用戶(hù)觸摸屏幕時(shí)做出響應(yīng)，就像我們這里所做的——打出一個(gè)提示信息。
這里，我們可以通過(guò)MotionEvent的getAction()方法來(lái)獲取Touch事件的類(lèi)型，包括 ACTION_DOWN, ACTION_MOVE, ACTION_UP, 和ACTION_CANCEL。ACTION_DOWN是指按下觸摸屏，ACTION_MOVE是指按下觸摸屏后移動(dòng)受力點(diǎn)，ACTION_UP則是指松 開(kāi)觸摸屏，ACTION_CANCEL不會(huì)由用戶(hù)直接觸發(fā)(所以不在今天的討論范圍，請(qǐng)參考 ViewGroup.onInterceptTouchEvent(MotionEvent))。借助對(duì)于用戶(hù)不同操作的判斷，結(jié)合getRawX()、 getRawY()、getX()和getY()等方法來(lái)獲取坐標(biāo)后，我們可以實(shí)現(xiàn)諸如拖動(dòng)某一個(gè)按鈕，拖動(dòng)滾動(dòng)條等功能。待機(jī)可以看看 MotionEvent類(lèi)的文檔，另外也可以看考TouchPaint例子。
回到今天所要說(shuō)的重點(diǎn)，當(dāng)我們捕捉到Touch操作的時(shí)候，如何識(shí)別出用戶(hù)的Gesture?這里我們需要GestureDetector.OnGestureListener接口的幫助，于是我們的GestureTest類(lèi)就變成了這個(gè)樣子。
- public class GestureTest extends Activity implements OnTouchListener,
- OnGestureListener {
- ...
- }
隨后，在onTouch()方法中，我們調(diào)用GestureDetector的onTouchEvent()方法，將捕捉到的MotionEvent交給 GestureDetector 來(lái)分析是否有合適的callback函數(shù)來(lái)處理用戶(hù)的手勢(shì)。
- @Override
- public boolean onTouch(View v, MotionEvent event) {
- // OnGestureListener will analyzes the given motion event
- return mGestureDetector.onTouchEvent(event);
- }
接下來(lái)，我們實(shí)現(xiàn)了以下6個(gè)抽象方法，其中最有用的當(dāng)然是onFling()、onScroll()和onLongPress()了。我已經(jīng)把每一個(gè)方法代表的手勢(shì)的意思寫(xiě)在了注釋里，大家看一下就明白了。
- // 用戶(hù)輕觸觸摸屏，由1個(gè)MotionEvent ACTION_DOWN觸發(fā)
- @Override
- public boolean onDown(MotionEvent e) {
- // TODO Auto-generated method stub
- Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show();
- return false;
- }
- // 用戶(hù)輕觸觸摸屏，尚未松開(kāi)或拖動(dòng)，由一個(gè)1個(gè)MotionEvent ACTION_DOWN觸發(fā)，注意和onDown()的區(qū)別，強(qiáng)調(diào)的是沒(méi)有松開(kāi)或者拖動(dòng)的狀態(tài)
- @Override
- public void onShowPress(MotionEvent e) {
- // TODO Auto-generated method stub
- }
- // 用戶(hù)（輕觸觸摸屏后）松開(kāi)，由一個(gè)1個(gè)MotionEvent ACTION_UP觸發(fā)
- @Override
- public boolean onSingleTapUp(MotionEvent e) {
- // TODO Auto-generated method stub
- return false;
- }
- // 用戶(hù)按下觸摸屏、快速移動(dòng)后松開(kāi)，由1個(gè)MotionEvent ACTION_DOWN, 多個(gè)ACTION_MOVE, 1個(gè)ACTION_UP觸發(fā)
- @Override
- public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
- float velocityY) {
- // TODO Auto-generated method stub
- return false;
- }
- // 用戶(hù)長(zhǎng)按觸摸屏，由多個(gè)MotionEvent ACTION_DOWN觸發(fā)
- @Override
- public void onLongPress(MotionEvent e) {
- // TODO Auto-generated method stub
- }
- // 用戶(hù)按下觸摸屏，并拖動(dòng)，由1個(gè)MotionEvent ACTION_DOWN, 多個(gè)ACTION_MOVE觸發(fā)
- @Override
- public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,
- float distanceY) {
- // TODO Auto-generated method stub
- return false;
- }
我們來(lái)試著做一個(gè)onFling()事件的處理吧，onFling()方法中每一個(gè)參數(shù)的意義我寫(xiě)在注釋中了，需要注意的是Fling事件的處理代 碼中，除了第一個(gè)觸發(fā)Fling的ACTION_DOWN和最后一個(gè)ACTION_MOVE中包含的坐標(biāo)等信息外，我們還可以根據(jù)用戶(hù)在X軸或者Y軸上的 移動(dòng)速度作為條件。比如下面的代碼中我們就在用戶(hù)移動(dòng)超過(guò)100個(gè)像素，且X軸上每秒的移動(dòng)速度大于200像素時(shí)才進(jìn)行處理。
- @Override
- public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
- float velocityY) {
- // 參數(shù)解釋?zhuān)?nbsp;
- // e1：第1個(gè)ACTION_DOWN MotionEvent
- // e2：最后一個(gè)ACTION_MOVE MotionEvent
- // velocityX：X軸上的移動(dòng)速度，像素/秒
- // velocityY：Y軸上的移動(dòng)速度，像素/秒
- // 觸發(fā)條件 ：
- // X軸的坐標(biāo)位移大于FLING_MIN_DISTANCE，且移動(dòng)速度大于FLING_MIN_VELOCITY個(gè)像素/秒
- 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;
- }
問(wèn)題是，這個(gè)時(shí)候如果我們嘗試去運(yùn)行程序，你會(huì)發(fā)現(xiàn)我們根本得不到想要的結(jié)果，跟蹤代碼的執(zhí)行的會(huì)發(fā)現(xiàn)onFling()事件一直就沒(méi)有被捕捉到。這正是一開(kāi)始困擾我的問(wèn)題，這到底是為什么呢?
我在討論組的Gesture detection這個(gè)帖子里找到了答案，即我們需要在onCreate中tv.setOnTouchListener(this);之后添加如下一句代碼。
- tv.setLongClickable(true);
只有這樣，view才能夠處理不同于Tap(輕觸)的hold(即ACTION_MOVE，或者多個(gè)ACTION_DOWN)，我們同樣可以通過(guò)layout定義中的android:longClickable來(lái)做到這一點(diǎn)。
這次遇到的這個(gè)問(wèn)題和上次MapView中setOnKeyListener遇到的問(wèn)題挺類(lèi)似，其實(shí)都是對(duì)SDK的了解不夠全面，遇到了一次記住了就好。不過(guò)話說(shuō)回來(lái)，Google在文檔方面確實(shí)需要加強(qiáng)了，起碼可以在OnGestureListener中說(shuō)明需要滿足那些條件才可以保證手勢(shì)被正確識(shí)別。
