对于触摸屏,其原生的消息无非按下、抬起、移动这几种,我们只需要简单重载onTouch或者设置触摸侦听器setOnTouchListener即可进行处理。不过,为了提高我们的APP的用户体验,有时候我们需要识别用户的手势,Android给我们提供的手势识别工具GestureDetector就可以帮上大忙了。

 

基础

GestureDetector的工作原理是,当我们接收到用户触摸消息时,将这个消息交给GestureDetector去加工,我们通过设置侦听器获得GestureDetector处理后的手势。

 

GestureDetector提供了两个侦听器接口,OnGestureListener处理单击类消息,OnDoubleTapListener处理双击类消息。

 

OnGestureListener的接口有这几个:

 
  
  1. // 单击,触摸屏按下时立刻触发   
  2.    
  3. abstract boolean onDown(MotionEvent e);   
  4.    
  5. // 抬起,手指离开触摸屏时触发(长按、滚动、滑动时,不会触发这个手势)   
  6.    
  7. abstract boolean onSingleTapUp(MotionEvent e);   
  8.    
  9. // 短按,触摸屏按下后片刻后抬起,会触发这个手势,如果迅速抬起则不会   
  10.    
  11. abstract void onShowPress(MotionEvent e);   
  12.    
  13. // 长按,触摸屏按下后既不抬起也不移动,过一段时间后触发   
  14.    
  15. abstract void onLongPress(MotionEvent e);   
  16.    
  17. // 滚动,触摸屏按下后移动   
  18.    
  19. abstract boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY);   
  20.    
  21. // 滑动,触摸屏按下后快速移动并抬起,会先触发滚动手势,跟着触发一个滑动手势   
  22.    
  23. abstract boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY);   

OnDoubleTapListener的接口有这几个:

 
  
  1. // 双击,手指在触摸屏上迅速点击第二下时触发   
  2.    
  3. abstract boolean onDoubleTap(MotionEvent e);   
  4.    
  5. // 双击的按下跟抬起各触发一次   
  6.    
  7. abstract boolean onDoubleTapEvent(MotionEvent e);   
  8.    
  9. // 单击确认,即很快的按下并抬起,但并不连续点击第二下   
  10.    
  11. abstract boolean onSingleTapConfirmed(MotionEvent e);   

有时候我们并不需要处理上面所有手势,方便起见,Android提供了另外一个类SimpleOnGestureListener实现了如上接口,我们只需要继承SimpleOnGestureListener然后重载感兴趣的手势即可。

应用

STEP 1: 创建手势侦听对象

 
  
  1. import android.content.Context;   
  2.    
  3. import android.view.MotionEvent;   
  4.    
  5. import android.view.GestureDetector.SimpleOnGestureListener;   
  6.    
  7. import android.widget.Toast;   
  8.    
  9.    
  10.    
  11. public class MyGestureListener extends SimpleOnGestureListener {   
  12.      private Context mContext;       
  13.    
  14.     MyGestureListener(Context context) {    
  15.         mContext = context;    
  16.     }      
  17.    
  18.     @Override    
  19.     public boolean onDown(MotionEvent e) {   
  20.         Toast.makeText(mContext, "DOWN " + e.getAction(), Toast.LENGTH_SHORT).show();    
  21.         return false;   
  22.     }   
  23.    
  24.     @Override    
  25.     public void onShowPress(MotionEvent e) {    
  26.         Toast.makeText(mContext, "SHOW " + e.getAction(), Toast.LENGTH_SHORT).show();              
  27.    
  28.     }   
  29.    
  30.     @Override   
  31.     public boolean onSingleTapUp(MotionEvent e) {    
  32.         Toast.makeText(mContext, "SINGLE UP " + e.getAction(), Toast.LENGTH_SHORT).show();    
  33.         return false;    
  34.     }   
  35.    
  36.     @Override    
  37.     public boolean onScroll(MotionEvent e1, MotionEvent e2,    
  38.             float distanceX, float distanceY) {    
  39.         Toast.makeText(mContext, "SCROLL " + e2.getAction(), Toast.LENGTH_SHORT).show();    
  40.         return false;    
  41.     }   
  42.    
  43.     @Override    
  44.     public void onLongPress(MotionEvent e) {   
  45.         Toast.makeText(mContext, "LONG " + e.getAction(), Toast.LENGTH_SHORT).show();    
  46.     }   
  47.    
  48.     @Override    
  49.     public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,   
  50.             float velocityY) {    
  51.         Toast.makeText(mContext, "FLING " + e2.getAction(), Toast.LENGTH_SHORT).show();    
  52.         return false;    
  53.     }   
  54.    
  55.     @Override    
  56.     public boolean onDoubleTap(MotionEvent e) {    
  57.         Toast.makeText(mContext, "DOUBLE " + e.getAction(), Toast.LENGTH_SHORT).show();    
  58.         return false;    
  59.     }   
  60.    
  61.     @Override    
  62.     public boolean onDoubleTapEvent(MotionEvent e) {    
  63.         Toast.makeText(mContext, "DOUBLE EVENT " + e.getAction(), Toast.LENGTH_SHORT).show();    
  64.         return false;    
  65.     }    
  66.    
  67.     @Override    
  68.     public boolean onSingleTapConfirmed(MotionEvent e) {    
  69.         Toast.makeText(mContext, "SINGLE CONF " + e.getAction(), Toast.LENGTH_SHORT).show();    
  70.         return false;    
  71.     }    
  72. }   

STEP 2: 设置手势识别

 

 

 

我们可以在Activity里设置手势识别:

 
  
  1. import android.app.Activity;   
  2.    
  3. import android.os.Bundle;   
  4.    
  5. import android.view.GestureDetector;   
  6.    
  7. import android.view.MotionEvent;   
  8.     
  9. public class GestureTestActivity extends Activity {   
  10.    
  11.     private GestureDetector mGestureDetector;    
  12.    
  13.     @Override    
  14.     public void onCreate(Bundle savedInstanceState) {   
  15.    
  16.         super.onCreate(savedInstanceState);   
  17.    
  18.         setContentView(R.layout.main);    
  19.    
  20.         mGestureDetector = new GestureDetector(thisnew MyGestureListener(this));    
  21.     }   
  22.    
  23.     @Override    
  24.     public boolean onTouchEvent(MotionEvent event) {    
  25.         return mGestureDetector.onTouchEvent(event);   
  26.     }   
  27. }  

也可以在自定义的View里面设置手势识别:

 
  
  1. import android.content.Context;   
  2.    
  3. import android.util.AttributeSet;   
  4.    
  5. import android.view.GestureDetector;   
  6.    
  7. import android.view.MotionEvent;   
  8.    
  9. import android.view.View;    
  10.    
  11. public class MyView extends View {    
  12.    
  13.     private GestureDetector mGestureDetector;   
  14.    
  15.     public MyView(Context context, AttributeSet attrs) {    
  16.         super(context, attrs);    
  17.    
  18.         mGestureDetector = new GestureDetector(context, new MyGestureListener(context));    
  19.    
  20.         setLongClickable(true);    
  21.    
  22.         this.setOnTouchListener(new OnTouchListener() {    
  23.             public boolean onTouch(View v, MotionEvent event) {    
  24.                 return mGestureDetector.onTouchEvent(event);    
  25.             }    
  26.         });   
  27.     }   
  28. }  

陷阱

 

对于自定义View,使用手势识别有两处陷阱可能会浪费你的不少时间。

 

1:View必须设置longClickable为true,否则手势识别无法正确工作,只会返回Down, Show, Long三种手势

 

2:必须在View的onTouchListener中调用手势识别,而不能像Activity一样重载onTouchEvent,否则同样手势识别无法正确工作

 

 

 

测试结果

下面是各种操作返回的手势序列,数值0表示触摸屏按下,1表示抬起

 

 

单击:down 0, single up 1, single conf 0

短按:down 0, show 0, single up 1

长按:down 0, show 0, long 0

双击:down 0, single up 1, double 0, double event 0, down 0, double event 1

滚动:down 0, (show 0), scrool 2...

滑动:down 0, (show 0), scrool 2..., fling 1