Androin学习笔记五十七： Android 触摸手势基础官方文档概览

一时失言乱红尘 2022-08-22 12:21 178阅读 0赞

出处：[http://www.cnblogs.com/mengdd/p/3335508.html][http_www.cnblogs.com_mengdd_p_3335508.html]

## 触摸手势检测基础 ##

手势检测一般包含两个阶段：

1.获取touch事件数据

2.解析这些数据，看它们是否满足你的应用所支持的某种手势。

相关API:

`　　MotionEvent`

兼容版的：

`　　MotionEventCompat`

（Note that **MotionEventCompat** is not a replacement for the MotionEvent class. Rather, it provides static utility methods to which you pass your MotionEvent object in order to receive the desired action associated with that event.）

## 一般的Activity或View中的touch事件处理 ##

Activity或View类的`onTouchEvent()`回调函数会接收到touch事件。

为了截获touch事件，你需要覆写Activity或View的onTouchEvent方法。

View中还可以使用**[setOnTouchListener()][setOnTouchListener]**方法添加点击事件的 `View.OnTouchListener`监听对象。这样就可以不继承View而处理点击事件。

但是如果需要处理双击、长按、fling（快滑）等手势，你需要利用 `GestureDetector`类。

## onTouchEvent方法的返回值 ##

onTouchEvent方法的返回值，**如果返回true，意味着你已经处理过了touch事件；如果返回false，将会继续通过view stack传递事件，直到事件被处理。**

这里**需要注意**`ACTION_DOWN` 事件，如果返回false，则该listener将不会被告知后面的一系列`ACTION_MOVE`和 `ACTION_UP` 事件。

## 检测手势 ##

Android提供了`GestureDetector`类来检测一般的手势。

**基本使用：**

**1.**生成`GestureDetector` 对象（或**[GestureDetectorCompat][]**对象），构造时的参数传入监听器对象。

监听器对象实现`GestureDetector.OnGestureListener`接口。

如果你仅仅是想利用其中的一些手势而不是全部，那么你可以选择继承**[GestureDetector.SimpleOnGestureListener][]**类，这是一个适配器模式，即这个类实现了`GestureDetector.OnGestureListener`接口，为其中所有的方法提供了空实现（返回值都是false），当继承**[GestureDetector.SimpleOnGestureListener][]**类时，子类只需要覆写感兴趣的方法，其他方法是空实现。

**2.**为了让 `GestureDetector`对象接收到事件，需要覆写View或Activity中的 `onTouchEvent()`方法，将事件传递给detector对象。

一个例子：

![ExpandedBlockStart.gif][]

![复制代码][copycode.gif]

package com.example.hellogesturedetector;
    
    import android.os.Bundle;
    import android.app.Activity;
    import android.util.Log;
    import android.view.GestureDetector;
    import android.view.GestureDetector.OnDoubleTapListener;
    import android.view.GestureDetector.OnGestureListener;
    import android.view.Menu;
    import android.view.MotionEvent;
    import android.view.ViewGroup;
    import android.widget.TextView;
    
    public class HelloGestureDetectorActivity extends Activity {
    
        private static final String LOG_TAG = "HelloGesture";
        private GestureDetector mGestureDetector = null;
    
        private TextView mGestureTextView = null;
        private TextView mDoubleTapTextView = null;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_hello_gesture_detector);
    
            mGestureTextView = (TextView) findViewById(R.id.gesture);
            mDoubleTapTextView = (TextView) findViewById(R.id.doubleTap);
    
            // 构造GestureDetector对象，传入监听器对象
            mGestureDetector = new GestureDetector(this, mOnGestureListener);
    
            // 传入双击监听器对象
            mGestureDetector.setOnDoubleTapListener(mDoubleTapListener);
    
        }
    
        @Override
        public boolean onTouchEvent(MotionEvent event) {
            // 在onTouchEvent方法中将事件传递给手势检测对象，否则手势监听对象中的回调函数是不会被调用的
            mGestureDetector.onTouchEvent(event);
            return super.onTouchEvent(event);
        }
    
        private OnGestureListener mOnGestureListener = new OnGestureListener() {
    
            @Override
            public boolean onSingleTapUp(MotionEvent e) {
                Log.i(LOG_TAG, "onSingleTapUp: " + e.toString());
                mGestureTextView.setText("onSingleTapUp: ");
                return false;
    
            }
    
            @Override
            public void onShowPress(MotionEvent e) {
                Log.i(LOG_TAG, "onShowPress: " + e.toString());
                mGestureTextView.setText("onShowPress: ");
            }
    
            @Override
            public boolean onScroll(MotionEvent e1, MotionEvent e2,
                    float distanceX, float distanceY) {
                Log.i(LOG_TAG, "onScroll: " + e1.toString() + ", " + e2.toString());
                mGestureTextView.setText("onScroll ");
                return false;
            }
    
            @Override
            public void onLongPress(MotionEvent e) {
                Log.i(LOG_TAG, "onLongPress: " + e.toString());
                mGestureTextView.setText("onLongPress: ");
            }
    
            @Override
            public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
                    float velocityY) {
                Log.i(LOG_TAG, "onFling: " + e1.toString() + ", " + e2.toString());
                mGestureTextView.setText("onFling ");
                return false;
            }
    
            @Override
            public boolean onDown(MotionEvent e) {
    
                Log.i(LOG_TAG, "onDown: " + e.toString());
                mGestureTextView.setText("onDown: ");
    
                return false;
    
            }
        };
    
        private OnDoubleTapListener mDoubleTapListener = new OnDoubleTapListener() {
    
            @Override
            public boolean onSingleTapConfirmed(MotionEvent e) {
                Log.i("LOG_TAG", "onSingleTapConfirmed: " + e.toString());
                mDoubleTapTextView.setText("onSingleTapConfirmed: ");
                return false;
            }
    
            @Override
            public boolean onDoubleTapEvent(MotionEvent e) {
                Log.i("LOG_TAG", "onDoubleTapEvent: " + e.toString());
                mDoubleTapTextView.setText("onDoubleTapEvent: ");
                return false;
            }
    
            @Override
            public boolean onDoubleTap(MotionEvent e) {
                Log.i("LOG_TAG", "onDoubleTap: " + e.toString());
                mDoubleTapTextView.setText("onDoubleTap: ");
                return false;
            }
        };
    }

![复制代码][copycode.gif]

根据官网上说：

关于**[onDown()][onDown]**方法的返回值，最好是返回true，因为所有的手势都是从**[onDown()][onDown]**信息开始的。

如果像`GestureDetector.SimpleOnGestureListener`默认实现一样返回false，系统就会认为你想要忽略之后的其他手势，然后`GestureDetector.OnGestureListener`的其他方法就不会被调用。

但是实际程序验证的时候，发现返回true还是false好像没有什么影响。(??)

## 跟踪运动 速度 ##

有很多不同的方法来记录手势中的运动，比如pointer的起始位置和终止位置；pointer运动的方向；手势的历史（通过`getHistorySize()`方法得到）；还有pointer的运动速度。

Android提供了`VelocityTracker`类和**[VelocityTrackerCompat][]**类，来记录touch事件的速度。

代码例子：

![ExpandedBlockStart.gif][]

![复制代码][copycode.gif]

public class MainActivity extends Activity {
        private static final String DEBUG_TAG = "Velocity";
            ...
        private VelocityTracker mVelocityTracker = null;
        @Override
        public boolean onTouchEvent(MotionEvent event) {
            int index = event.getActionIndex();
            int action = event.getActionMasked();
            int pointerId = event.getPointerId(index);
    
            switch(action) {
                case MotionEvent.ACTION_DOWN:
                    if(mVelocityTracker == null) {
                        // Retrieve a new VelocityTracker object to watch the velocity of a motion.
                        mVelocityTracker = VelocityTracker.obtain();
                    }
                    else {
                        // Reset the velocity tracker back to its initial state.
                        mVelocityTracker.clear();
                    }
                    // Add a user's movement to the tracker.
                    mVelocityTracker.addMovement(event);
                    break;
                case MotionEvent.ACTION_MOVE:
                    mVelocityTracker.addMovement(event);
                    // When you want to determine the velocity, call 
                    // computeCurrentVelocity(). Then call getXVelocity() 
                    // and getYVelocity() to retrieve the velocity for each pointer ID. 
                    mVelocityTracker.computeCurrentVelocity(1000);
                    // Log velocity of pixels per second
                    // Best practice to use VelocityTrackerCompat where possible.
                    Log.d("", "X velocity: " + 
                            VelocityTrackerCompat.getXVelocity(mVelocityTracker, 
                            pointerId));
                    Log.d("", "Y velocity: " + 
                            VelocityTrackerCompat.getYVelocity(mVelocityTracker,
                            pointerId));
                    break;
                case MotionEvent.ACTION_UP:
                case MotionEvent.ACTION_CANCEL:
                    // Return a VelocityTracker object back to be re-used by others.
                    mVelocityTracker.recycle();
                    break;
            }
            return true;
        }
    }

![复制代码][copycode.gif]

## 滚动手势 ##

如果一个标准的布局有可能会超出它的容器的边界，可以把它嵌套在一个**[ScrollView][]**中，这样就会得到一个可以滚动的布局，由framewok处理。

实现一个自定义的scroller应该只在一些特殊情况下需要。

Scroller用来随时间制造滚动动画，使用平台标准的滚动物理参数（摩擦力、速度等）。

Scroller自己本身实际上并不绘制任何东西。

Scroller记录滚动的偏移值，但是它并不会将这些位置应用到你的View，你需要自己动手。

详见：[http://developer.android.com/training/gestures/scroll.html][http_developer.android.com_training_gestures_scroll.html]

## 多点触摸手势 ##

当多个pointer同时触摸屏幕，系统会生成如下事件：

*  `ACTION_DOWN`—For the first pointer that touches the screen. This starts the gesture. The pointer data for this pointer is always at index 0 in the `MotionEvent`.
 *  `ACTION_POINTER_DOWN`—For extra pointers that enter the screen beyond the first. The pointer data for this pointer is at the index returned by `getActionIndex()`.
 *  `ACTION_MOVE`—A change has happened during a press gesture.
 *  `ACTION_POINTER_UP`—Sent when a non-primary pointer goes up.
 *  `ACTION_UP`—Sent when the last pointer leaves the screen.

**你可以依靠每一个pointer的index和ID来追踪每一个pointer：**

**Index**：**[MotionEvent][]**会把每一个pointer的信息放在一个数组里，index即是这个数组索引。大多数你用的**[MotionEvent][]**方法是以这个index作为参数的。

**ID**：每一个pointer还有一个ID映射，在touch事件中保持恒定一致（persistent），这样就可以在整个手势中跟踪一个单独的pointer。

pointer在一个motion event中出现的顺序是未定的，所以pointer的index在不同的事件中是可变的，但是只要pointer保持active，它的ID是保持不变的。

通过`getPointerId()`获得ID，这样就可以在多个motion event中追踪pointer。然后对于连续的motion event，可以使用**[findPointerIndex()][findPointerIndex]**方法来获得指定ID的pointer在当前事件中的index。

比如：

![复制代码][copycode.gif]

private int mActivePointerId;
     
    public boolean onTouchEvent(MotionEvent event) {
        ....
        // Get the pointer ID
        mActivePointerId = event.getPointerId(0);
    
        // ... Many touch events later...
    
        // Use the pointer ID to find the index of the active pointer 
        // and fetch its position
        int pointerIndex = event.findPointerIndex(mActivePointerId);
        // Get the pointer's current position
        float x = event.getX(pointerIndex);
        float y = event.getY(pointerIndex);
    }

![复制代码][copycode.gif]

获取**[MotionEvent][]**的动作应该使用**[getActionMasked()][getActionMasked]**方法（或者是兼容版的**[MotionEventCompat.getActionMasked()][MotionEventCompat.getActionMasked]**）。

与旧版的**[getAction()][getAction]**不同，`getActionMasked()`方法是被设计为可以多个pointer工作的。

它会返回带掩模的动作，不带pointer用于index的那些位。

你可以使用**[getActionIndex()][getActionIndex]**来得到index。

## 拖动和缩放 ##

拖动一个对象：

如果是**Android 3.0**以上，可以使用View的新接口`View.OnDragListener`参见：[Drag and Drop][]。

其他参见：[http://developer.android.com/training/gestures/scale.html][http_developer.android.com_training_gestures_scale.html]

缩放可以使用 `ScaleGestureDetector`。

`　　ScaleGestureDetector`可以和`GestureDetector`一起使用。

##  ##

## ViewGroup中的Touch事件处理 ##

处理`ViewGroup`的touch事件要麻烦一些，因为很可能各种touch事件的目标不是ViewGroup而是它的child。

为了确保每一个child正确地接收到touch events，需要覆写ViewGroup的**[onInterceptTouchEvent()][onInterceptTouchEvent]**方法。

如果**[onInterceptTouchEvent()][onInterceptTouchEvent]**方法返回**true**，说明**[MotionEvent][]**被截获了，它将不会被传递给child，而是传递给parent的 `onTouchEvent()`方法。

如果你在parent的**[onInterceptTouchEvent()][onInterceptTouchEvent]**方法中返回了**true**，先前还在处理touch event的child view将会接收到一个 `ACTION_CANCEL`，之后的事件就会全传递到parent的onTouchEvent中。

如果`onInterceptTouchEvent()` 方法返回**false**，则事件继续顺着view结构向下传递，parent不会截获事件，也不会调用parent的**[onTouchEvent()][onTouchEvent]**方法。

另:

**　　[ViewConfiguration][]**提供一些常量。

**　　[TouchDelegate][]**类可以用来设置View的触摸区域。

用法见：[http://developer.android.com/training/gestures/viewgroup.html][http_developer.android.com_training_gestures_viewgroup.html]

## 参考资料 ##

Training: Using Touch Gestures

[http://developer.android.com/training/gestures/index.html][http_developer.android.com_training_gestures_index.html]

[http_www.cnblogs.com_mengdd_p_3335508.html]: http://www.cnblogs.com/mengdd/p/3335508.html
[setOnTouchListener]: http://developer.android.com/reference/android/view/View.html#setOnTouchListener%28android.view.View.OnTouchListener%29
[GestureDetectorCompat]: http://developer.android.com/reference/android/support/v4/view/GestureDetectorCompat.html
[GestureDetector.SimpleOnGestureListener]: http://developer.android.com/reference/android/view/GestureDetector.SimpleOnGestureListener.html
[ExpandedBlockStart.gif]: /images/20220722/2d9e2f3652174d4b8c4a590ca082d72f.png
[copycode.gif]: /images/20220722/193d9d52a7ff4d0fa3333a2bf4233d10.png
[onDown]: http://developer.android.com/reference/android/view/GestureDetector.OnGestureListener.html#onDown%28android.view.MotionEvent%29
[VelocityTrackerCompat]: http://developer.android.com/reference/android/support/v4/view/VelocityTrackerCompat.html
[ScrollView]: http://developer.android.com/reference/android/widget/ScrollView.html
[http_developer.android.com_training_gestures_scroll.html]: http://developer.android.com/training/gestures/scroll.html
[MotionEvent]: http://developer.android.com/reference/android/view/MotionEvent.html
[findPointerIndex]: http://developer.android.com/reference/android/view/MotionEvent.html#findPointerIndex%28int%29
[getActionMasked]: http://developer.android.com/reference/android/view/MotionEvent.html#getActionMasked%28%29
[MotionEventCompat.getActionMasked]: http://developer.android.com/reference/android/support/v4/view/MotionEventCompat.html#getActionMasked%28android.view.MotionEvent%29
[getAction]: http://developer.android.com/reference/android/view/MotionEvent.html#getAction%28%29
[getActionIndex]: http://developer.android.com/reference/android/support/v4/view/MotionEventCompat.html#getActionIndex%28android.view.MotionEvent%29
[Drag and Drop]: http://developer.android.com/guide/topics/ui/drag-drop.html
[http_developer.android.com_training_gestures_scale.html]: http://developer.android.com/training/gestures/scale.html
[onInterceptTouchEvent]: http://developer.android.com/reference/android/view/ViewGroup.html#onInterceptTouchEvent%28android.view.MotionEvent%29
[onTouchEvent]: http://developer.android.com/reference/android/view/View.html#onTouchEvent%28android.view.MotionEvent%29
[ViewConfiguration]: http://developer.android.com/reference/android/view/ViewConfiguration.html
[TouchDelegate]: http://developer.android.com/reference/android/view/TouchDelegate.html
[http_developer.android.com_training_gestures_viewgroup.html]: http://developer.android.com/training/gestures/viewgroup.html
[http_developer.android.com_training_gestures_index.html]: http://developer.android.com/training/gestures/index.html