编写 Android 触摸屏手势识别程序

不少时候，利用触摸屏的Fling、Scroll等Gesture（手势）操做来操做会使得应用程序的用户体验大大提高，好比用Scroll手势在 浏览器中滚屏，用Fling在阅读器中翻页等。在Android系统中，手势的识别是经过 GestureDetector.OnGestureListener接口来实现的，不过William翻遍了Android的官方文档也没有找到一个相 关的例子，API Demo中的TouchPaint也仅仅是提到了onTouch事件的处理，没有涉及到手势。

咱们先来明确一些概念，首先，Android的事件处理机制是基于Listener（监听器）来实现的，比咱们今天所说的触摸屏相关的事件，就是通 过onTouchListener。其次，全部View的子类均可以经过setOnTouchListener()、 setOnKeyListener()等方法来添加对某一类事件的监听器。第三，Listener通常会以Interface（接口）的方式来提供，其中 包含一个或多个abstract（抽象）方法，咱们须要实现这些方法来完成onTouch()、onKey()等等的操做。这样，当咱们给某个view设 置了事件Listener，并实现了其中的抽象方法之后，程序即可以在特定的事件被dispatch到该view的时候，经过callbakc函数给予适 当的响应。

看一个简单的例子，就用最简单的TextView来讲明（事实上和ADT中生成的skeleton没有什么区别）。

01. publicclassGestureTestextendsActivityimplementsOnTouchListener{

02.

03.    @Override

04.    protectedvoidonCreate(Bundle savedInstanceState) {

05.        super.onCreate(savedInstanceState);

06.        setContentView(R.layout.main);

07.

08.        // init TextView

09.        TextView tv = (TextView) findViewById(R.id.page);

10.        // set OnTouchListener on TextView

11.        tv.setOnTouchListener(this);

12.        // show some text

13.        tv.setText(R.string.text);

14.    }

15.

16.    @Override

17.    publicbooleanonTouch(View v, MotionEvent event) {

18.        Toast.makeText(this,"onTouch", Toast.LENGTH_SHORT).show();

19.        returnfalse;

20.    }

咱们给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类就变成了这个样子。

1. publicclassGestureTestextendsActivityimplementsOnTouchListener,

2.        OnGestureListener {

3. ...

4. }

随后，在onTouch()方法中，咱们调用GestureDetector的onTouchEvent()方法，将捕捉到的MotionEvent交给  GestureDetector 来分析是否有合适的callback函数来处理用户的手势。

1. @Override

2.    publicbooleanonTouch(View v, MotionEvent event) {

3.        // OnGestureListener will analyzes the given motion event

4.        returnmGestureDetector.onTouchEvent(event);

5.    }

接下来，咱们实现了如下6个抽象方法，其中最有用的固然是onFling()、onScroll()和onLongPress()了。我已经把每个方法表明的手势的意思写在了注释里，你们看一下就明白了。

01. // 用户轻触触摸屏，由1个MotionEvent ACTION_DOWN触发

02.    @Override

03.    publicbooleanonDown(MotionEvent e) {

04.        // TODO Auto-generated method stub

05.        Toast.makeText(this,"onDown", Toast.LENGTH_SHORT).show();

06.        returnfalse;

07.    }

08.

09.    // 用户轻触触摸屏，还没有松开或拖动，由一个1个MotionEvent ACTION_DOWN触发

10.    // 注意和onDown()的区别，强调的是没有松开或者拖动的状态

11.    @Override

12.    publicvoidonShowPress(MotionEvent e) {

13.        // TODO Auto-generated method stub

14.    }

15.

16.    // 用户（轻触触摸屏后）松开，由一个1个MotionEvent ACTION_UP触发

17.    @Override

18.    publicbooleanonSingleTapUp(MotionEvent e) {

19.        // TODO Auto-generated method stub

20.        returnfalse;

21.    }

22.

23.    // 用户按下触摸屏、快速移动后松开，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE, 1个ACTION_UP触发

24.    @Override

25.    publicbooleanonFling(MotionEvent e1, MotionEvent e2,floatvelocityX,

26.            floatvelocityY) {

27.        // TODO Auto-generated method stub

28.        returnfalse;

29.    }

30.

31.    // 用户长按触摸屏，由多个MotionEvent ACTION_DOWN触发

32.    @Override

33.    publicvoidonLongPress(MotionEvent e) {

34.        // TODO Auto-generated method stub

35.

36.    }

37.

38.    // 用户按下触摸屏，并拖动，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE触发

39.    @Override

40.    publicbooleanonScroll(MotionEvent e1, MotionEvent e2,floatdistanceX,

41.            floatdistanceY) {

42.        // TODO Auto-generated method stub

43.        returnfalse;

44.    }

咱们来试着作一个onFling()事件的处理吧，onFling()方法中每个参数的意义我写在注释中了，须要注意的是Fling事件的处理代 码中，除了第一个触发Fling的ACTION_DOWN和最后一个ACTION_MOVE中包含的坐标等信息外，咱们还能够根据用户在X轴或者Y轴上的 移动速度做为条件。好比下面的代码中咱们就在用户移动超过100个像素，且X轴上每秒的移动速度大于200像素时才进行处理。

01. @Override

02. publicbooleanonFling(MotionEvent e1, MotionEvent e2,floatvelocityX,

03.        floatvelocityY) {

04.    // 参数解释：

05.    // e1：第1个ACTION_DOWN MotionEvent

06.    // e2：最后一个ACTION_MOVE MotionEvent

07.    // velocityX：X轴上的移动速度，像素/秒

08.    // velocityY：Y轴上的移动速度，像素/秒

09.

10.    // 触发条件 ：

11.    // X轴的坐标位移大于FLING_MIN_DISTANCE，且移动速度大于FLING_MIN_VELOCITY个像素/秒

12.

13.    if(e1.getX() - e2.getX() > FLING_MIN_DISTANCE

14.            && Math.abs(velocityX) > FLING_MIN_VELOCITY) {

15.        // Fling left

16.        Toast.makeText(this,"Fling Left", Toast.LENGTH_SHORT).show();

17.    }elseif(e2.getX() - e1.getX() > FLING_MIN_DISTANCE

18.            && Math.abs(velocityX) > FLING_MIN_VELOCITY) {

19.        // Fling right

20.        Toast.makeText(this,"Fling Right", Toast.LENGTH_SHORT).show();

21.    }

22.

23.    returnfalse;

24. }

问题是，这个时候若是咱们尝试去运行程序，你会发现咱们根本得不到想要的结果，跟踪代码的执行的会发现onFling()事件一直就没有被捕捉到。这正是一开始困扰个人问题，这究竟是为何呢？
我在讨论组的Gesture detection这个帖子里找到了答案，即咱们须要在onCreate中tv.setOnTouchListener(this);以后添加以下一句代码。

1. tv.setLongClickable(true);

只有这样，view才可以处理不一样于Tap（轻触）的hold（即ACTION_MOVE，或者多个ACTION_DOWN），咱们一样能够经过layout定义中的android:longClickable来作到这一点。

此次遇到的这个问题和上次MapView中setOnKeyListener遇到的问题挺相似，其实都是对SDK的了解不够全面，遇到了一次记住了就好。不过话说回来，Google在文档方面确实须要增强了，起码能够在OnGestureListener中说明须要知足那些条件才能够保证手势被正确识别。