Android 触摸手势基础 官方文档概览

触摸手势检测基础

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

　　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()方法添加点击事件的 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对象。

　　一个例子：

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;
        }
    };
}

　　根据官网上说：

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

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

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

跟踪运动 速度

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

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

　　代码例子：

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;
    }
}

滚动手势

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

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

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

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

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

　　详见：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()方法来获得指定ID的pointer在当前事件中的index。

　　比如：

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);
}

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

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

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

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

拖动和缩放

　　拖动一个对象：

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

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

　　缩放可以使用 ScaleGestureDetector。

　　ScaleGestureDetector可以和GestureDetector一起使用。

ViewGroup中的Touch事件处理

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

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

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

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

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

　　另:

　　ViewConfiguration提供一些常量。

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

　　用法见：http://developer.android.com/training/gestures/viewgroup.html

参考资料

　　Training: Using Touch Gestures

　　http://developer.android.com/training/gestures/index.html

时间： 2024-12-08 02:25:14

Android 触摸手势基础 官方文档概览的相关文章

Android 触摸手势基础 官方文档概览2

Android 触摸手势基础 官方文档概览 触摸手势检测基础 手势检测一般包含两个阶段: 1.获取touch事件数据 2.解析这些数据,看它们是否满足你的应用所支持的某种手势. 相关API: MotionEvent 兼容版的: MotionEventCompat  (Note that MotionEventCompat is not a replacement for the MotionEvent class. Rather, it provides static utility metho

Android Data Binding Library 官方文档（译）

地址:https://developer.android.google.cn/topic/libraries/data-binding/index.html 本文地址:http://blog.csdn.net/jjwwmlp456/article/details/54915981 Data Binding Library (数据绑定库),旨在减少绑定应用程序逻辑和布局所需的一些耦合性代码 最低支持Android 2.1 (API Level 7) 构建环境 使用gradle插件1.5-alpha

4.1.Android的硬件加速官方文档

参考 https://developer.android.com/guide/topics/graphics/hardware-accel.html 硬件加速背景知识 在手机客户端尤其是Android应用的开发过程中,我们经常会接触到"硬件加速"这个词.由于操作系统对底层软硬件封装非常完善,上层软件开发者往往对硬件加速的底层原理了解很少,也不清楚了解底层原理的意义,因此常会有一些误解,如硬件加速是不是通过特殊算法实现页面渲染加速,或是通过硬件提高CPU/GPU运算速率实现渲染加速. 本

Android File类 根据官方文档理解(转)

File有四个构造函数        public File(File dir,String name)             参数为File和String,File制定构造的新的File对象的路径,而String制定新的File名字        Public File(String path)             参数为String,构造一个新的File使用制定的路径        public File(String dirPath,String name)            

Android官方文档之Introduction

写在前面的话:接触Android的时间也不短了,听了视频.看了书.敲了代码,写了博客,做了demo...但是想做出一款优秀的APP(哪怕是封装一个不错的功能)还有很长的路要走.于是前些日子我打算更加深入地往底层.往源代码方向研究Android--我就买了一本<Android群英传>拜读一下,在刚读到前言的时候,我发现作者推荐了阅读官方的Training和Guide,我才意识到,其实之前我接触到的各个渠道的Android知识,都是来自官方文档,与其更加深入地了解Android,不如把官方文档的内

Android官方文档之App Components（Loaders）

Loaders在Android 3.0中引入.在Activity和Fragment中,使用Loaders可以方便地加载数据.有关Activity和Fragment的介绍,您可以参考我翻译的官方文档: <Activities> <Fragments> 本文将介绍Loaders API.Loaders的启动.重启.Loaders管理器 等内容,如需访问Loaders的官方原文,您可以点击这个链接:<Loaders>. Loaders Loaders具有如下特性: 它适用于任

Android Google官方文档解析之——Device Compatibility

Android is designed to run on many different types of devices, from phones to tablets and televisions. As a developer, the range of devices provides a huge potential audience for your app. In order for your app to be successful on all these devices,

OpenGL ES着色器语言之着色概览（官方文档）

OpenGL ES着色器语言之着色概览(官方文档第二章) 事实上,OpenGL ES着色语言是两种紧密关联的语言.这些语言用来在OpenGL ES处理管线的可编程处理器创建着色器. 在本文档中,除非另外说明,一个语言功能适用于所有语言,并且通用用法将把他们当做一个语言来看待.特定语言将指出它们的目标处理器:顶点(vertext)或片元(fragment). 任何被着色器使用的OpenGL ES状态值都会自动地被跟踪并且作用于着色器上.这个自动状态跟踪机制允许应用程序为状态管理而使用OpenGL

Android Google官方文档(cn)解析之——Intents and Intent filter

应用程序核心组件中的三个Activity,service,还有broadcast receiver都是通过一个叫做intent的消息激活的.Intent消息传送是在相同或不同的应用程序中的组件之间后运行时绑定的一个设施.Intent对象也就是它自己是一个数据结构,这个数据结构持有将要执行操作的抽象描述,或者在broadcast的情况下,是一个已经发生而将要宣布的描述.为传递intent到每个不同类型的组件有单独的机制: 一个Intent对象被传递到Context.startActivity()或