Android自定义View-手势检测(GestureDetector)

最新推荐文章于 2025-05-28 19:00:02 发布
最新推荐文章于 2025-05-28 19:00:02 发布
阅读量1k 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： android 文章标签： GestureDetector
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_34341338/article/details/87966454
本文详细介绍了Android中GestureDetector的使用，包括构造函数、监听器和常见手势的回调顺序。强调了在子线程中使用GestureDetector时Handler必须带有Looper的重要性，以及为何在监听单击和双击事件时，推荐使用onSingleTapConfirmed而不是OnClickListener。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Google为了方便我们进行手势检测，早就封装了相关的内容提供我们使用。即Android手势检测，主要就是对GestureDetector类的使用和说明。

1.GestureDetector

GestureDetector可以使用MotionEvents检测各种手势和事件。其内部包含四个监听器(三个接口以及一个外部类)：

接口含义
OnGestureListener手势检测：包括 按下(Down) 扔(Fling) 长按(LongPress) 滚动(Scroll) 触摸反馈(ShowPress) 单击抬起(SingleTapUp)
OnDoubleTapListener双击事件：有三个回调方法 双击(DoubleTap) 单击确认(SingleTapConfirmed) 双击事件回调(DoubleTapEvent)
OnContextClickListener它是在Android6.0(API 23)才添加的一个选项，是用于检测外部设备上的按钮是否按下的，例如蓝牙触控笔上的按钮，一般情况下，忽略即可。
SimpleOnGestureListener三个接口的空实现，使用较为方便

GestureDetector常用的构造函数：

构造函数
public GestureDetector(Context context, OnGestureListener listener, Handler handler)
public GestureDetector(Context context, OnGestureListener listener)

第二种需要传递上下文和手势监听器，没什么好讲的；关于第一种，传递一个Handler只是为了给GestureDetector手势监听器提供一个Looper。通常不需要传递，因为在内部会自己生成一个Handler用来传递消息，如果在主线程创建GestureDetector则会自己获取主线程中的Looper。如果在没有创建Looper的子线程中创建GestureDetector则会报错。

第二种构造函数的使用以及注意事项：

方式一：

	    //在主线程中创建Handler，Handler会自动获取主线程的Looper
        final Handler handler = new Handler();
        new Thread(new Runnable() {
            @Override
            public void run() {
                GestureDetector detector = new GestureDetector(MainActivity.this,new GestureDetector.SimpleOnGestureListener(){

                },handler);
            }
        }).start();

方式二：

        //方式二 子线程中创建Handler并指定Looper
        new Thread(new Runnable() {
            @Override
            public void run() {
                Handler handler1 = new Handler(Looper.getMainLooper());
                GestureDetector detector = new GestureDetector(MainActivity.this,new GestureDetector.SimpleOnGestureListener(){

                },handler1);
            }
        }).start();

第一种构造函数在子线程种的使用：

子线程中准备了Looper可使用第一种构造函数

 new Thread(new Runnable() {
            @Override
            public void run() {
                Looper.prepare();
                GestureDetector detector = new GestureDetector(MainActivity.this,new GestureDetector.SimpleOnGestureListener(){

                });
            }
        }).start();

注意： 传递的Handler必须带有Looper

2.GestureDetector使用

  1. 创建一个监听回调
  2. 创建一个检测器
  3. 给检测器设置数据源

例子：

//监听回调
 GestureDetector.OnGestureListener listener = new GestureDetector.OnGestureListener() {
            @Override
            public boolean onDown(MotionEvent e) {
                Log.e(TAG,"onDown");
                return true;
            }

            @Override
            public void onShowPress(MotionEvent e) {
                Log.e(TAG,"onShowPress");
            }

            @Override
            public boolean onSingleTapUp(MotionEvent e) {
                Log.e(TAG,"onSingleTapUp");
                return true;
            }

            @Override
            public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
                Log.e(TAG,"onScroll");
                return true;
            }

            @Override
            public void onLongPress(MotionEvent e) {
                Log.e(TAG,"onLongPress");
            }

            @Override
            public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
                Log.e(TAG,"onFling");
                return true;
            }
        };

		//创建监听器
        final GestureDetector detector = new GestureDetector(this,listener);
      

		//设置数据源
        view.setOnTouchListener(new View.OnTouchListener() {
            @Override
            public boolean onTouch(View v, MotionEvent event) {
                return detector.onTouchEvent(event);
            }
        });

如果想单独设置OnDoubleTapListener的话直接调用：

  detector.setOnDoubleTapListener(new DoubleTapListener());

前面提到SimpleOnGestureListener实现了三个接口，因此我们使用时通常都是使用它来构建监听器的。。

接下来通过各种不同的手势动作来观察事件的回调顺序。使用SimpleOnGestureListener重写全部的空方法，并添加日志。

final GestureDetector detector = new GestureDetector(this,new GestureDetector.SimpleOnGestureListener(){
            @Override
            public boolean onDown(MotionEvent e) {
                Log.e(TAG,"onDown");
                return true;
            }

            @Override
            public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
                Log.e(TAG,"onFling");
                return false;
            }

            @Override
            public void onLongPress(MotionEvent e) {
                Log.e(TAG,"onLongPress");
            }

            @Override
            public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
                Log.e(TAG,"onScroll");
                return false;
            }

            @Override
            public void onShowPress(MotionEvent e) {
                super.onShowPress(e);
                Log.e(TAG,"onShowPress");
            }

            @Override
            public boolean onSingleTapUp(MotionEvent e) {
                Log.e(TAG,"onSingleTapUp");
                return super.onSingleTapUp(e);
            }

            @Override
            public boolean onDoubleTap(MotionEvent e) {
                Log.e(TAG,"onDoubleTap");
                return false;
            }

            @Override
            public boolean onSingleTapConfirmed(MotionEvent e) {
                Log.e(TAG,"onSingleTapConfirmed");
                return false;
            }

            @Override
            public boolean onDoubleTapEvent(MotionEvent e) {
                Log.e(TAG,"onDoubleTapEvent");
                return false;
            }
        });
        view.setOnTouchListener(new View.OnTouchListener() {
            @Override
            public boolean onTouch(View v, MotionEvent event) {
                return detector.onTouchEvent(event);
            }
        });

在这里插入图片描述

在这里插入图片描述

从上面的图大概可以看出每个回调方法的作用以及调用时刻：

方法时间
onDown(MotionEvent e)按下屏幕就会触发
onShowPress(MotionEvent e)如果是按下的时间超过瞬间，而且在按下的时候没有松开或者是拖动
onLongPress(MotionEvent e)长按触摸时触发
onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)滑动触发，x y 表示移动的距离
onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY)快速移动时松开触发 x,y是XY轴的移动速度
onSingleTapUp(MotionEvent e)单击松开触发
onDoubleTap(MotionEvent e)双击第二次按下就会触发
onSingleTapConfirmed(MotionEvent e)单击事件
onDoubleTapEvent(MotionEvent e)双击事件触发（可判断move up down 情况）

如果你只想监听双击事件，那么只用关注 onDoubleTap 就行了，如果你同时要监听单击事件则需要关注 onSingleTapConfirmed 这个回调函数。

有人可能会有疑问，监听单击事件为什么要使用 onSingleTapConfirmed，使用 OnClickListener 不行吗？主要有两个原因：
1.它们两个是存在一定冲突的，如果想要两者同时被触发，则 setOnTouchListener 不能消费事件，如果 onTouchListener 消费了事件，就可能导致 OnClick 无法正常触发。
2.需要同时监听单击和双击，则说明单击和双击后响应逻辑不同，然而使用 OnClickListener 会在双击事件发生时触发两次，这显然不是我们想要的结果。而使用 onSingleTapConfirmed 就不用考虑那么多了，你完全可以把它当成单击事件来看待，而且在双击事件发生时，onSingleTapConfirmed 不会被调用，这样就不会引发冲突。

假如说我们想要在第二次按下抬起后才判定这是一个双击操作，触发后续的内容，则不能使用 onDoubleTap 了，需要使用 onDoubleTapEvent 来进行更细微的控制:

final GestureDetector detector = new GestureDetector(MainActivity.this, new GestureDetector.SimpleOnGestureListener() {
    @Override public boolean onDoubleTap(MotionEvent e) {
        Logger.e("第二次按下时触发");
        return super.onDoubleTap(e);
    }

    @Override public boolean onDoubleTapEvent(MotionEvent e) {
        switch (e.getActionMasked()) {
            case MotionEvent.ACTION_UP:
                Logger.e("第二次抬起时触发");
                break;
        }
        return super.onDoubleTapEvent(e);
    }
});

down 在事件分发体系中是一个较为特殊的事件，为了保证事件被唯一的 View 消费，哪个 View 消费了 down 事件，后续的内容就会传递给该 View。如果我们想让一个 View 能够接收到事件，有两种做法：

1、让该 View 可以点击，因为可点击状态会默认消费 down 事件。

 view.setClickable(true);

2、手动消费掉 down 事件。

@Override
            public boolean onDown(MotionEvent e) {
                Log.e(TAG,"onDown");
                return true;
            }

参考：
https://www.cnblogs.com/ldq2016/p/7000300.html
http://www.gcssloop.com/customview/gestruedector

Android自定义view---手势识别，双击，惯性滑动，相册图片效果
lbj23vs6的博客
10-04 1445
文章目录前言一、GestureDetectorCompat是什么？二、使用步骤1.定义一个GestureDetectorCompat的实例2.重写方法，实现自定义效果①想让检测器消费一系列的触摸事件，那么就要在重写方法`onDown`中去返回true，那么后续的一系列触摸过程才能让手势检测器获取②既然我们要去实现双击效果，那么就得再给手势检测器设置一个监听③实现双击变大变小④重写onDoubleTap④实现惯性滑动总结完整代码 前言 在view中我们可以重写onTouchEvent来自定义点击事件，但是M
Android自定义viewgroup可滚动布局 GestureDetector手势监听（5）
08-31
通过上述知识点，可以总结出实现Android自定义ViewGroup可滚动布局的关键点在于Scroller和GestureDetector的使用。Scroller负责滚动动画的执行，而GestureDetector则用于简化手势事件的处理。通过合理地结合这两个类...
Android Gesture Detector
xiangyong2008的专栏
04-21 940
感谢android中国开发者的众多先驱，本文主要内容来自于总结，一小部分是自己的体会。主要参考文章为： http://www.williamhua.com/2009/04/23/android-touchscreen-gesture-recogniton/http://goro.javaeye.com/blog/402163 Android Touch Screen 与传统
Android-GestureDetector学习总结
最新发布
2301_80329517的博客
05-28 1177
gesture学习总结
Android 手势检测---GestureDetector
AND_YOU_with_ME的博客
11-27 939
Android 手势检测---GestureDetector
android.view.GestureDetector类
az44yao的专栏
12-14 1130
通过android.view.GestureDetector类可以检测各种手势事件，该类有两个回调接口分别用来通知具体的事件：  http://www.cnblogs.com/feng88724/archive/2011/01/31/1961237.html GestureDetector.OnDoubleTapListener：用来通知DoubleTap事件，类似于鼠标的双击事件，该
Android View体系（四）--GestureDetector手势识别
soleil雪寂
02-16 468
文章目录1 简介2 使用2.1 onGestureListener2.2 OnDoubleTapListener2.3 SimpleOnGestureListener 1 简介 手势识别在 Android 开发中也是非常常见，我们通过设置监听 View.onTouchListener 接口，重写 onTouch(View v, MotionEvent event) 可以处理一些触摸事件，但是在处理...
Android-安卓手势解锁示例-手势解锁-自定义手势-安卓手势
08-13
`GestureOverlayView`是Android SDK提供的一种用于处理手势输入的视图，它可以自动检测并绘制用户的手势轨迹。 1. 创建`GestureOverlayView`：在布局文件中添加`GestureOverlayView`，设置其宽度和高度，并监听手势...
Android自定义GestureDetector实现手势检测
Android自定义GestureDetector实现手势ImageView Android中GestureDetector是一个非常重要的组件，它可以帮助开发者检测用户的各种手势操作，如滑动、缩放、旋转等等。在Android系统中，GestureDetector是通过...
[Android开发]一、自定义View手势监听GestureDetector使用教程
u013077428的博客
10-23 768
自定义View手势监听GestureDetector使用教程，各个回调方法的详细介绍
android view gesturedetector,如何在Android中利用 GestureDetector进行手势检测
weixin_29367347的博客
05-28 288
如何在Android中利用 GestureDetector进行手势检测发布时间：2020-11-26 16:15:21来源：亿速云阅读：92作者：Leah今天就跟大家聊聊有关如何在Android中利用 GestureDetector进行手势检测，可能很多人都不太了解，为了让大家更加了解，小编给大家总结了以下内容，希望大家根据这篇文章可以有所收获。一、概述当用户触摸屏幕的时候，会产生许多手势，例如d...
Android View进行手势识别详解
09-01
本文主要介绍 Android View进行手势识别，这里整理了相关资料和简单示例，有兴趣的小伙伴可以参考下
Android自定义GestureDetector实现手势ImageView
01-04
不说废话了，进入我们今天的主题吧。 先贴上前面内容的地址： Android手势ImageView三部曲（一） Android手势ImageView三部曲（二） Android手势ImageView三部曲（三） 前面我们讲到了ScaleGestureDetector这个工具类，我在疑惑，为什么搞出一个ScaleGestureDetector，不顺带把什么旋转、移动、做了呢？ 好吧～！ 谷歌肯定还是想给开发者留一点自己的空间哈。 仿照ScaleGestureDetector，我们来定义一个叫MoveGestureDetector的工具类（专门用于检测滑动手势），在定义MoveGestureDe
自定义 View 之 GestureDetector（手势识别）的使用
你若盛开，蜜蜂自来
08-14 9420
博主声明： 转载请在开头附加本文链接及作者信息，并标记为转载。本文由博主威威喵原创，请多支持与指教。 本文首发于此 博主：威威喵|博客主页：https://blog.csdn.net/smile_running 学习自定义View，这个对于初学者来说确实有点难度。因为这需要你熟悉View绘制的基本流程，不仅如此，你还需要熟悉手势识别、解决事件冲突等知识。这是一系列综...
android view gesturedetector,每日一问 Android有个GestureDetector很好用？那么你知道它内部是如何实现的吗？...
weixin_42378289的博客
05-28 218
来咯~~~ 其实应该是昨晚就要写完的了，没想到昨晚居然不小心睡着了，一拖又拖到了现在。。。之前关于多指触控的问题就有同学提及过GestureDetector这个类，是的，这个类内部也是已经实现了多指触控的，只是在次要手指按下和抬起时不会有通知。我们在创建这个类实例的时候，需要把接口OnGestureListener(用来监听各种手势)实现并作为参数传进它的构造方法中：GestureDetecto...
android 自定义view 手势,android自定义View实现手势解锁
weixin_42443992的博客
05-25 719
有时候为了程序的安全性,我们经常要采取一些安全措施,就像我们常用的支付宝那样,隔一定的时间再回到应用程序时会让用户利用手势去解锁应用程序,最近由于项目需求,也要求做这样一个功能,当用户切出本应用程序15分钟后回来,让用户手势解锁,整个需求的难点就在如何实现这个手势锁,开始一点头绪也没有,没有一点思路去实现这个手势解锁功能,在google了一番后看了一篇非常好的博客后,按照博主的思路的确是可以实现一...
Android 手把手进阶自定义View（十一）- 手势检测 GestureDetector
lerendan的博客
03-31 827
一、前言 二、手势检测 三、滑动手势检测
Android 自定义View 开发 入门与实践7 自定义 attr ViewGroup gestureDetector手势检测,window (manager)
FlyPig_Vip的博客
08-04 293
自定义View 之设置自定义属性attr 在Values下面创建一个attr.xml文件 <?xml version="1.0" encoding="utf-8"?> <resources> <declare-styleable name="BounceScrollView"> <attr name="damping" format="float" /> <attr name="scrollOrientati
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值