Android的Gesture Detector

我们知道在一般情况下，处理android的TouchEvent，我们只需要利用OnTouchListener，OnKeyListener接口，通过setOnTouchListener()，setOnKeyListener()来注册监听器，然后在OnTouch(), OnKey()方法中实现我们想要的操作，当系统dispatch特定的事件到该View时，该View就会自动调用callback方法。

例如：

public class MyGesture extends Activity implements OnTouchListener {
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        TextView tv = (TextView) findViewById(R.id.tv);
        tv.setOnTouchListener(this);
    }
	public boolean onTouch(View v, MotionEvent event) {
		Toast.makeText(this, "Touch Touch", Toast.LENGTH_SHORT).show();
		return false;
	}
}

我们可以通过MotionEvent的getAction()方法来获取Touch事件的类型，包括 ACTION_DOWN（按下触摸屏）, ACTION_MOVE（按下触摸屏后移动受力点）, ACTION_UP（松开触摸屏）和ACTION_CANCEL（不会由用户直接触发）。借助对于用户不同操作的判断，结合getRawX()、getRawY()、getX()和getY()等方法来获取座标后，我们可以实现诸如拖动某一个按钮，拖动滚动条等功能。

这种方法虽然比较简单，但是对于各种各样的用户动作，显得比较单一，幸好android为我们提供了GestureDetector类以及GestureDetector.OnGestureListener接口，定义一个GestureDetector的实例，然后将OnTouch()方法捕捉到的MotionEvent交给他，他就会帮我们判断用户的Gesture，并自动调用GestureDetector.OnGestureListener里面的方法，我们只需要在各个方法里实现我们的功能就可以了。

示例如下：onDown(MotionEvent arg0)，onShowPress()，onSingleTapUp() , ...都是OnGestureListener里的方法

public class MyGesture extends Activity implements OnTouchListener, OnGestureListener {
    private GestureDetector mGestureDetector;
    public MyGesture() {
    	mGestureDetector = new GestureDetector(this);
    }
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        TextView tv = (TextView) findViewById(R.id.tv);
        tv.setOnTouchListener(this);
        tv.setFocusable(true);
        tv.setClickable(true);
        tv.setLongClickable(true);
        mGestureDetector.setIsLongpressEnabled(true);
    }
    
    /*
     * 在onTouch()方法中，我们调用GestureDetector的onTouchEvent()方法，将捕捉到的MotionEvent交给GestureDetector
     * 来分析是否有合适的callback函数来处理用户的手势
     */ 
	public boolean onTouch(View v, MotionEvent event) {
		return mGestureDetector.onTouchEvent(event);
	}

	// 用户轻触触摸屏，由1个MotionEvent ACTION_DOWN触发
	public boolean onDown(MotionEvent arg0) {
		Log.i("MyGesture", "onDown");
		Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show();
		return true;
	}
	
	/*
	 * 用户轻触触摸屏，尚未松开或拖动，由一个1个MotionEvent ACTION_DOWN触发
	 * 注意和onDown()的区别，强调的是没有松开或者拖动的状态
	 */
	public void onShowPress(MotionEvent e) {
		Log.i("MyGesture", "onShowPress");
		Toast.makeText(this, "onShowPress", Toast.LENGTH_SHORT).show();
	}
	
	// 用户（轻触触摸屏后）松开，由一个1个MotionEvent ACTION_UP触发
	public boolean onSingleTapUp(MotionEvent e) {
		Log.i("MyGesture", "onSingleTapUp");
		Toast.makeText(this, "onSingleTapUp", Toast.LENGTH_SHORT).show();
		return true;
	}
	
	// 用户按下触摸屏、快速移动后松开，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE, 1个ACTION_UP触发
	public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
		Log.i("MyGesture", "onFling");
		Toast.makeText(this, "onFling", Toast.LENGTH_LONG).show();
		return true;
	}
	
	// 用户按下触摸屏，并拖动，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE触发
	public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
		Log.i("MyGesture", "onScroll");
		Toast.makeText(this, "onScroll", Toast.LENGTH_LONG).show();
		return true;
	}
	
	// 用户长按触摸屏，由多个MotionEvent ACTION_DOWN触发
	public void onLongPress(MotionEvent e) {
		Log.i("MyGesture", "onLongPress");
		Toast.makeText(this, "onLongPress", Toast.LENGTH_LONG).show();
	}
}

除了OnGestureListener接口，还有一个SimpleOnGestureListener接口

public class MyGesture extends Activity implements OnTouchListener {
    private GestureDetector mGestureDetector;
    public MyGesture() {
    	mGestureDetector = new GestureDetector(new MySimpleGesture());
    }
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        TextView tv = (TextView) findViewById(R.id.tv);
        tv.setOnTouchListener(this);
        tv.setFocusable(true);
        tv.setClickable(true);
        tv.setLongClickable(true);
    }
    public boolean onTouch(View v, MotionEvent event) {
    	if (event.getAction() == MotionEvent.ACTION_UP) {
    		Log.i("MyGesture", "MotionEvent.ACTION_UP");
    	}
		return mGestureDetector.onTouchEvent(event);
	}
    
    // SimpleOnGestureListener implements GestureDetector.OnDoubleTapListener, GestureDetector.OnGestureListener
    private class MySimpleGesture extends SimpleOnGestureListener {
    	// 双击的第二下Touch down时触发 
		public boolean onDoubleTap(MotionEvent e) {
			Log.i("MyGesture", "onDoubleTap");
			return super.onDoubleTap(e);
		}
		
		// 双击的第二下Touch down和up都会触发，可用e.getAction()区分
		public boolean onDoubleTapEvent(MotionEvent e) {
			Log.i("MyGesture", "onDoubleTapEvent");
			return super.onDoubleTapEvent(e);
		}
		
		// Touch down时触发 
		public boolean onDown(MotionEvent e) {
			Log.i("MyGesture", "onDown");
			return super.onDown(e);
		}
		
		// Touch了滑动一点距离后，up时触发
		public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
			Log.i("MyGesture", "onFling");
			return super.onFling(e1, e2, velocityX, velocityY);
		}
		
		// Touch了不移动一直Touch down时触发
		public void onLongPress(MotionEvent e) {
			Log.i("MyGesture", "onLongPress");
			super.onLongPress(e);
		}
		
		// Touch了滑动时触发
		public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
			Log.i("MyGesture", "onScroll");
			return super.onScroll(e1, e2, distanceX, distanceY);
		}
		
		/*
		 * Touch了还没有滑动时触发
		 * (1)onDown只要Touch Down一定立刻触发
		 * (2)Touch Down后过一会没有滑动先触发onShowPress再触发onLongPress
		 * So: Touch Down后一直不滑动，onDown -> onShowPress -> onLongPress这个顺序触发。
		 */
		public void onShowPress(MotionEvent e) {
			Log.i("MyGesture", "onShowPress");
			super.onShowPress(e);
		}

		/*
		 * 两个函数都是在Touch Down后又没有滑动(onScroll)，又没有长按(onLongPress)，然后Touch Up时触发
		 * 点击一下非常快的(不滑动)Touch Up: onDown->onSingleTapUp->onSingleTapConfirmed
		 * 点击一下稍微慢点的(不滑动)Touch Up: onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed 
		 */ 
		public boolean onSingleTapConfirmed(MotionEvent e) {
			Log.i("MyGesture", "onSingleTapConfirmed");
			return super.onSingleTapConfirmed(e);
		}
		public boolean onSingleTapUp(MotionEvent e) {
			Log.i("MyGesture", "onSingleTapUp");
			return super.onSingleTapUp(e);
		}
    }
}