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

转载 2015年11月20日 15:00:57


  转自http://www.cnblogs.com/mengdd/p/3335508.html

 

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:

  IndexMotionEvent会把每一个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()方法。

 //相对于屏幕
event.getRawX();
event.getRawY();
//相对于该控件
event.getX();
event.getY();

//多点情形
event.getY(event.getPointerId(pointerIndex));
event.getX(event.getPointerId(pointerIndex));

  另:

  ViewConfiguration提供一些常量。

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

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

相关文章推荐

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

转:http://www.cnblogs.com/mengdd/p/3335508.html 触摸手势检测基础   手势检测一般包含两个阶段:   1.获取touch事件...
  • javalfx
  • javalfx
  • 2015年08月25日 15:54
  • 240

Android 触摸手势(来自官方文档)

Detecting Common Gestures(参考来自官方文档)本文翻译自安卓官方文档: https://developer.android.com/training/gestures/dete...

Android Web App官方文档翻译第一章:概览

Android Web App官方文档翻译第一章:概览 Figure 1. 你可以使用两种方式让用户访问你的Web内容:用一种传统的方式,即通过浏览器,或者在一个An...

Android API官方文档 UI概览

UI 概览Android 应用中的所有用户界面元素都是使用 View 和 ViewGroup 对象构建而成。View 对象用于在屏幕上绘制可供用户交互的内容。ViewGroup 对象用于储存其他 Vi...

移动端手势库hammerJS 2.0.4官方文档翻译

hammerJS是一个优秀的、轻量级的触屏设备手势库,现在已经更新到2.04版本,跟1.0版本有点天壤地别了,毕竟改写了事件名并新增了许多方法,允许同时监听多个手势、自定义识别器,也可以识别滑动方向。...

Saltstack安装和基础配置官方文档

 2.2.7. RHEL / CentOS / Scientific Linux / Amazon Linux / Oracle Linux¶ 2.2.7.1. Installation ...

OpenCV基础入门 基于官方文档解读(5)--core模块学习

(1) 基本介绍 (2)Mat类的整体结构 (3)Mat对象的初始化 1. 通过构造函数初始化 2. 通过非构造函数初始化 (4)Mat对象内像素数据的获取 1. 了解对象内部数据部...

App开发日报 2015-05-20 如何仅凭官方文档零基础学习Swift开发

1. 如何仅凭官方文档零基础学习Swift开发 2. 自己动手写iOS网络请求库之封装接口 3. iOS课程 4. Scrapy+Flask+Mongodb+Swift开发全攻略之四 5. 使用Swi...

OpenGL ES着色器语言之语言基础(官方文档第三章)

3.1字符集         OpenGL ES着色语言的源字符集是ASCII编码的一个子集,包含以下字符:               字符 a-z, A-Z, and下划线 ( _ ). ...

react native 性能优化基础 - 官方文档

使用React Native的一个重要原因就是达到60FPS的刷新,这看起来跟本地APP是一样的。在可能的情况下,我们尽量完善ReactNative的性能,使你只关注APP的逻辑,而可以不用管性能的优...
  • cexo425
  • cexo425
  • 2016年08月01日 17:09
  • 7022
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Android 触摸手势基础 官方文档概览
举报原因:
原因补充:

(最多只允许输入30个字)