手势识别是Android触摸交互体系中最基础也最常用的能力。无论是列表的滑动翻页、图片的双击放大，还是下拉刷新、侧滑删除，背后都依赖手势识别机制把原始的触摸事件翻译成有业务含义的动作。Android SDK提供了GestureDetector这个现成的工具类，开发者只需要实现几个回调方法，就能拿到单击、双击、长按、快速滑动等手势通知，而不必自己去计算按下到抬起的距离和时间。这篇文章从触摸事件的基本原理讲起，逐步展开GestureDetector的用法、自定义手势处理的技巧以及一些容易踩坑的细节。
一、触摸事件与MotionEvent基础
在讨论手势识别之前，必须先理解Android如何传递触摸事件。当用户手指接触屏幕时，系统会生成一系列MotionEvent对象，沿着View树从上往下分发，任何一个环节消费了事件，后续事件就会持续交给它处理。MotionEvent中最重要的字段是action，常见的取值包括ACTION_DOWN（手指按下）、ACTION_MOVE（手指移动）、ACTION_UP（手指抬起）和ACTION_CANCEL（事件被系统取消，比如被来电打断）。
一次完整的触摸过程可以理解为一个事件流：DOWN是起点，UP是终点，中间穿插着若干个MOVE。如果只监听Activity的onTouchEvent方法，拿到的就是这些原始事件，想要判断用户是单击还是滑动，就得自己记录按下的坐标和时间，再在抬起时计算位移差。这样的代码写多了非常啰嗦，而且阈值不好把握，比如移动多少像素才算滑动、两次点击间隔多久才算双击，这些细节Google已经帮我们封装好了，GestureDetector就是为此而生的。
还有一个关键规则值得注意：onTouchEvent如果返回true表示消费当前事件，后续事件才会继续送达；返回false则表示不处理，事件会交还给父级。很多初学者写的点击响应不生效，就是因为DOWN事件时返回了false，后面的MOVE和UP根本收不到。
二、用GestureDetector实现常见手势监听
GestureDetector是官方提供的手势识别助手，它内部维护了状态机，负责把原始MotionEvent流解析成高级手势。使用方式分三步：创建监听器、实例化GestureDetector、在onTouchEvent中把事件转交给它处理。下面是一个最小可用示例：
public class MainActivity extends Activity {
private GestureDetector detector;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
detector = new GestureDetector(this, new GestureDetector.SimpleOnGestureListener() {
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
Toast.makeText(MainActivity.this, "单击", Toast.LENGTH_SHORT).show();
return true;
}
@Override
public boolean onDoubleTap(MotionEvent e) {
Toast.makeText(MainActivity.this, "双击", Toast.LENGTH_SHORT).show();
return true;
}
@Override
public void onLongPress(MotionEvent e) {
Toast.makeText(MainActivity.this, "长按", Toast.LENGTH_SHORT).show();
}
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2,
float velocityX, float velocityY) {
Toast.makeText(MainActivity.this, "快速滑动", Toast.LENGTH_SHORT).show();
return true;
}
});
}
@Override
public boolean onTouchEvent(MotionEvent event) {
return detector.onTouchEvent(event);
}
}
这段代码里用的是SimpleOnGestureListener，它已经把OnGestureListener和OnDoubleTapListener的所有方法都实现了空壳版本，我们只需覆盖关心的那几个。其中onSingleTapConfirmed和onSingleTapUp的区别经常被问到：onSingleTapUp在手指抬起瞬间立即回调，无法区分后续是否还有第二次点击；而onSingleTapConfirmed会等待约300毫秒确认没有第二次点击才回调，适合需要严格区分单击与双击的场景。
onFling是另一个高频使用的回调，参数中的e1是起始事件，e2是当前事件，velocityX和velocityY是横向与纵向的滑动速度，单位是像素每秒。典型的应用是阅读器翻页，通过判断速度和位移方向决定向前翻还是向后翻。需要注意的是，从某些版本开始e1可能为null，实际编码时要做好判空保护。
三、自定义View中的手势处理与进阶技巧
在自定义View中做手势处理是更常见的场景，比如绘图板、图片缩放控件、游戏摇杆等。此时应当重写View的onTouchEvent方法，或者使用onGenericMotionEvent处理滚轮等通用动作。如果View默认不可点击，记得调用setClickable(true)，否则可能在DOWN阶段就返回false导致收不到后续事件，这是自定义View手势失效的头号原因。
处理复杂手势时，VelocityTracker是个好帮手，它专门用来追踪手指的滑动速度。用法是在DOWN时通过obtain获取实例，MOVE时addMovement添加数据，最后在UP时computeCurrentVelocity再读取速度值。使用完一定要调用recycle回收，避免内存泄漏。下面这段代码演示了在自定义View中追踪横向滑动速度的写法：
public class SwipeView extends View {
private VelocityTracker tracker;
private float lastX;
public SwipeView(Context context, AttributeSet attrs) {
super(context, attrs);
setClickable(true);
}
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getActionMasked()) {
case MotionEvent.ACTION_DOWN:
tracker = VelocityTracker.obtain();
tracker.addMovement(event);
lastX = event.getX();
return true;
case MotionEvent.ACTION_MOVE:
tracker.addMovement(event);
float dx = event.getX() - lastX;
// 根据 dx 做跟手拖动
scrollBy((int) -dx, 0);
lastX = event.getX();
return true;
case MotionEvent.ACTION_UP:
tracker.addMovement(event);
tracker.computeCurrentVelocity(1000);
float vx = tracker.getXVelocity();
if (Math.abs(vx) > 2000) {
// 速度足够快，判定为惯性滑动
}
tracker.recycle();
tracker = null;
return true;
}
return super.onTouchEvent(event);
}
}
如果要处理双指缩放这类多点触控手势，就要用getActionMasked配合ACTION_POINTER_DOWN、ACTION_POINTER_UP来跟踪多个手指，配合PointerId区分具体是哪根手指在移动。当然，双指缩放这种常见需求也可以直接用ScaleGestureDetector，它和GestureDetector的接入方式几乎一样，在onTouchEvent里调用它的onTouchEvent即可，省去自己计算两指间距的麻烦。
最后提两点实践建议。一是手势判定不要用绝对像素做阈值，应结合DisplayMetrics的density把阈值换算成dp，否则在大屏设备上灵敏度会明显不对。二是当View嵌套在ScrollView或ViewPager里时，可以通过requestDisallowInterceptTouchEvent通知父容器不要拦截事件，避免滑动冲突。掌握这些细节后，再配合Material Design的手势规范去设计交互，应用的触摸体验会有明显提升。
Android手势识别GestureDetector触摸事件修改时间：2026-09-14 01:16:45