Android触控屏幕Gesture(GestureDetector和SimpleOnGestureListener的使用教程)

最新推荐文章于 2024-04-04 22:11:22 发布

进击的小黑

最新推荐文章于 2024-04-04 22:11:22 发布

阅读量948

点赞数

分类专栏：类文章标签： Gesture GestureDetector 触控屏幕

类专栏收录该内容

58 篇文章 0 订阅

订阅专栏

1、当用户触摸屏幕的时候，会产生许多手势，例如down,up,scroll，filing等等，我们知道View类有个View.OnTouchListener内部接口，通过重写他的onTouch(View v, MotionEvent event)方法，我们可以处理一些touch事件，但是这个方法太过简单，如果需要处理一些复杂的手势，用这个接口就会很麻烦（因为我们要自己根据用户触摸的轨迹去判断是什么手势）Android sdk给我们提供了GestureDetector（Gesture：手势Detector：识别）类，通过这个类我们可以识别很多的手势，主要是通过他的onTouchEvent(event)方法完成了不同手势的识别。虽然他能识别手势，但是不同的手势要怎么处理，应该是提供给程序员实现的，因此这个类对外提供了两个接口：OnGestureListener，OnDoubleTapListener，还有一个内部类SimpleOnGestureListener，SimpleOnGestureListener类是GestureDetector提供给我们的一个更方便的响应不同手势的类，这个类实现了上述两个接口（但是所有的方法体都是空的），该类是static class，也就是说它实际上是一个外部类。程序员可以在外部继承这个类，重写里面的手势处理方法。

通过GestureDetector的构造方法可以将SimpleOnGestureListener对象传递进去，这样GestureDetector能处理不同的手势了。

2.、具体用法：

/**
* 当我们捕捉到Touch操作的时候，如何识别出用户的Gesture？这里我们需要GestureDetector.OnGestureListener接口的帮助
*
* @author HB
*/
public class MySurfaceView extends SurfaceView implements OnGestureListener,
OnTouchListener, Callback {
GestureDetector gd;
Context context;
public MySurfaceView(Context context) {
super(context);
this.context = context;
setFocusable(true);
requestFocus();
this.setLongClickable(true);
this.setOnTouchListener(this);
setFocusable(true);
gd = new GestureDetector(new MySimpleGesture());// 这里或者可以直接传递this参数，因为本类已经继承了OnGestureListener接口，也可以把new
// MySimpleGesture()，它继承了SimpleOnGestureListener类；，两种方法都可以，只是把两种方法归在一个里面，方便学习；
// 。实惠屏幕触控事件；
gd.setIsLongpressEnabled(true);
// TODO Auto-generated constructor stub
}
// 用户轻触触摸屏，由1个MotionEvent ACTION_DOWN触发
@Override
public boolean onDown(MotionEvent e) {
// TODO Auto-generated method stub
System.out.println("onDown");
return false;
}
/*
* 用户轻触触摸屏，尚未松开或拖动，由一个1个MotionEvent ACTION_DOWN触发
* 注意和onDown()的区别，强调的是没有松开或者拖动的状态 (单击没有松开或者移动时候就触发此事件，再触发onLongPress事件)
*/
@Override
public void onShowPress(MotionEvent e) {
// TODO Auto-generated method stub
System.out.println("onShowPress");
}
// 用户（轻触触摸屏后）松开，由一个1个MotionEvent ACTION_UP触发
@Override
public boolean onSingleTapUp(MotionEvent e) {
// TODO Auto-generated method stub
System.out.println("onSingleTopUp");
return false;
}
// 用户按下触摸屏，并拖动，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE触发
@Override
public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,
float distanceY) {
System.out.println("onScroll");
// TODO Auto-generated method stub
return false;
}
// 用户长按触摸屏，由多个MotionEvent ACTION_DOWN触发
@Override
public void onLongPress(MotionEvent e) {
// TODO Auto-generated method stub
System.out.println("onLongPress");
}
/*
* 用户按下触摸屏、快速移动后松开，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE,
* 1个ACTION_UP触发(non-Javadoc)
* Fling事件的处理代码：除了第一个触发Fling的ACTION_DOWN和最后一个ACTION_MOVE中包含的坐标等信息外
* ，我们还可以根据用户在X轴或者Y轴上的移动速度作为条件
* 比如下面的代码中我们就在用户移动超过100个像素，且X轴上每秒的移动速度大于200像素时才进行处理。
*
* @see android.view.GestureDetector.OnGestureListener#onFling(android.view.
* MotionEvent, android.view.MotionEvent, float, float)
* 这个例子中，tv.setLongClickable( true )是必须的，因为
* 只有这样，view才能够处理不同于Tap（轻触）的hold（即ACTION_MOVE，或者多个ACTION_DOWN）
* ，我们同样可以通过layout定义中的android:longClickable来做到这一点
*/
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
float velocityY) {
// TODO Auto-generated method stub
System.out.println("onFling");
// 参数解释：
// e1：第1个ACTION_DOWN MotionEvent
// e2：最后一个ACTION_MOVE MotionEvent
// velocityX：X轴上的移动速度，像素/秒
// velocityY：Y轴上的移动速度，像素/秒
// 触发条件：
// X轴的坐标位移大于FLING_MIN_DISTANCE，且移动速度大于FLING_MIN_VELOCITY个像素/秒
final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;
if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE
&& Math.abs(velocityX) > FLING_MIN_VELOCITY) {
// Fling left
Log.i("MyGesture", "Fling left");
Toast.makeText(context, "Fling Left", Toast.LENGTH_SHORT).show();
} else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE
&& Math.abs(velocityX) > FLING_MIN_VELOCITY) {
// Fling right
Log.i("MyGesture", "Fling right");
Toast.makeText(context, "Fling Right", Toast.LENGTH_SHORT).show();
}
return true;
}
/**
* 当发行屏幕触控事件的时候，首先出发此方法，再通过此方法，监听具体的整件
* 在onTouch()方法中，我们调用GestureDetector的onTouchEvent
* ()方法，将捕捉到的MotionEvent交给GestureDetector 来分析是否有合适的callback函数来处理用户的手势
*/
@Override
public boolean onTouch(View v, MotionEvent event) {
// TODO Auto-generated method stub
System.out.println("onTouch");
return gd.onTouchEvent(event);
}
@Override
public void surfaceCreated(SurfaceHolder holder) {
// TODO Auto-generated method stub
}
@Override
public void surfaceChanged(SurfaceHolder holder, int format, int width,
int height) {
// TODO Auto-generated method stub
}
@Override
public void surfaceDestroyed(SurfaceHolder holder) {
// TODO Auto-generated method stub
}
/**
* SimpleOnGestureListener implements GestureDetector.OnDoubleTapListener,
* GestureDetector.OnGestureListener
*/
private class MySimpleGesture extends SimpleOnGestureListener {
// 双击的第二下Touch down时触发
public boolean onDoubleTap(MotionEvent e) {
Log.i("MyGesture", "onDoubleTap");
return super.onDoubleTap(e);
}
// 双击的第二下Touch down和up都会触发，可用e.getAction()区分
public boolean onDoubleTapEvent(MotionEvent e) {
Log.i("MyGesture", "onDoubleTapEvent");
return super.onDoubleTapEvent(e);
}
// Touch down时触发
public boolean onDown(MotionEvent e) {
Log.i("MyGesture", "onDown");
return super.onDown(e);
}
// Touch了滑动一点距离后，up时触发
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
float velocityY) {
Log.i("MyGesture", "onFling");
return super.onFling(e1, e2, velocityX, velocityY);
}
// Touch了不移动一直Touch down时触发
public void onLongPress(MotionEvent e) {
Log.i("MyGesture", "onLongPress");
super.onLongPress(e);
}
// Touch了滑动时触发
public boolean onScroll(MotionEvent e1, MotionEvent e2,
float distanceX, float distanceY) {
Log.i("MyGesture", "onScroll");
return super.onScroll(e1, e2, distanceX, distanceY);
}
/*
* Touch了还没有滑动时触发 (1)onDown只要Touch Down一定立刻触发 (2)Touch
* Down后过一会没有滑动先触发onShowPress再触发onLongPress So: Touch Down后一直不滑动，onDown
* -> onShowPress -> onLongPress这个顺序触发。
*/
public void onShowPress(MotionEvent e) {
Log.i("MyGesture", "onShowPress");
super.onShowPress(e);
}
/*
* 两个函数都是在Touch Down后又没有滑动(onScroll)，又没有长按(onLongPress)，然后Touch Up时触发
* 点击一下非常快的(不滑动)Touch Up: onDown->onSingleTapUp->onSingleTapConfirmed
* 点击一下稍微慢点的(不滑动)Touch Up://确认是单击事件触发
* onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
*/
public boolean onSingleTapConfirmed(MotionEvent e) {
Log.i("MyGesture", "onSingleTapConfirmed");
return super.onSingleTapConfirmed(e);
}
public boolean onSingleTapUp(MotionEvent e) {
Log.i("MyGesture", "onSingleTapUp");
return super.onSingleTapUp(e);
}
}
}

结果：

1、当单击屏幕的时候，输出：

2、当单击等一会再松开时候输出（触触摸屏，比单击慢）：

3、当用户按住不放的时候，输出：

4、当用户按住不放，拖动鼠标的时候输出：

5、当用户按住不放，快速拖动鼠标的时候：

6、当用户双击的时候（观察与单击的区别---onDubleTab在第二次按下Down的时候才出发，说明是双击事件在onDown事件之前；）：

——————————————————————————————————————————————————————————————————————

当用户触摸屏幕的时候，会产生许多手势，例如down，up，scroll，filing等等。

一般情况下，我们知道View类有个View.OnTouchListener内部接口，通过重写他的onTouch(View v, MotionEvent event)方法，我们可以处理一些touch事件，但是这个方法太过简单，如果需要处理一些复杂的手势，用这个接口就会很麻烦（因为我们要自己根据用户触摸的轨迹去判断是什么手势）。

Android sdk给我们提供了GestureDetector（Gesture：手势Detector：识别）类，通过这个类我们可以识别很多的手势，主要是通过他的onTouchEvent(event)方法完成了不同手势的识别。虽然他能识别手势，但是不同的手势要怎么处理，应该是提供给程序员实现的。

GestureDetector这个类对外提供了两个接口：OnGestureListener，OnDoubleTapListener，还有一个内部类SimpleOnGestureListener。

GestureDetector.OnDoubleTapListener接口：用来通知DoubleTap事件，类似于鼠标的双击事件。

1，onDoubleTap(MotionEvente)：在双击的第二下，Touchdown时触发。

2，onDoubleTapEvent(MotionEvente)：通知DoubleTap手势中的事件，包含down、up和move事件（这里指的是在双击之间发生的事件，例如在同一个地方双击会产生DoubleTap手势，而在DoubleTap手势里面还会发生down和up事件，这两个事件由该函数通知）；双击的第二下Touchdown和up都会触发，可用e.getAction()区分。

3，onSingleTapConfirmed(MotionEvente)：用来判定该次点击是SingleTap而不是DoubleTap，如果连续点击两次就是DoubleTap手势，如果只点击一次，系统等待一段时间后没有收到第二次点击则判定该次点击为SingleTap而不是DoubleTap，然后触发SingleTapConfirmed事件。这个方法不同于onSingleTapUp，他是在GestureDetector确信用户在第一次触摸屏幕后，没有紧跟着第二次触摸屏幕，也就是不是“双击”的时候触发

GestureDetector.OnGestureListener接口：用来通知普通的手势事件，该接口有如下六个回调函数：
1. onDown(MotionEvente)：down事件；
2. onSingleTapUp(MotionEvente)：一次点击up事件；在touchdown后又没有滑动

（onScroll），又没有长按（onLongPress），然后Touchup时触发。

点击一下非常快的（不滑动）Touchup：

onDown->onSingleTapUp->onSingleTapConfirmed
点击一下稍微慢点的（不滑动）Touchup：

onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
3. onShowPress(MotionEvente)：down事件发生而move或则up还没发生前触发该

事件；Touch了还没有滑动时触发（与onDown，onLongPress）比较onDown只要Touchdown一定立刻触发。而Touchdown后过一会没有滑动先触发onShowPress再是onLongPress。所以Touchdown后一直不滑动

按照onDown->onShowPress->onLongPress这个顺序触发。
4. onLongPress(MotionEvente)：长按事件；Touch了不移动一直Touchdown时触发
5. onFling(MotionEvent e1, MotionEvente2, float velocityX, floatvelocityY)：滑动手

势事件；Touch了滑动一点距离后，在ACTION_UP时才会触发

参数：e1 第1个ACTION_DOWN MotionEvent并且只有一个；e2 最后一个ACTION_MOVE MotionEvent；velocityX X轴上的移动速度，像素/秒；velocityY Y轴上的移动速度，像素/秒.触发条件：X轴的坐标位移大于FLING_MIN_DISTANCE，且移动速度大于FLING_MIN_VELOCITY个像素/秒

6. onScroll(MotionEvent e1, MotionEvente2, float distanceX, floatdistanceY)：在屏幕上

拖动事件。无论是用手拖动view，或者是以抛的动作滚动，都会多次触发,这个方法在ACTION_MOVE动作发生时就会触发

抛：手指触动屏幕后，稍微滑动后立即松开

onDown-----》onScroll----》onScroll----》onScroll----》………----->onFling

拖动

onDown------》onScroll----》onScroll------》onFiling

SimpleOnGestureListener类是GestureDetector提供给我们的一个更方便的响应不同手势的类，这个类实现了上述两个接口（但是所有的方法体都是空的），该类是static class，也就是说它实际上是一个外部类。程序员可以在外部继承这个类，重写里面的手势处理方法。

方法步骤

第一种示例：

1，通过GestureDetector的构造方法可以将SimpleOnGestureListener对象传递进去，这样GestureDetector能处理不同的手势了。

public GestureDetector

(Context context,GestureDetector.OnGestureListener listener)

2，在OnTouchListener的onTouch方法中

private OnTouchListenergestureTouchListener = new OnTouchListener() {
              public boolean onTouch(View v, MotionEvent event) {
            returngDetector.onTouchEvent(event);
       }
   };

第二种示例：

使用方法

private GestureDetectormGestureDetector;

mGestureListener = newBookOnGestureListener();

构造出来mGestureDetector = newGestureDetector(mGestureListener);

class BookOnGestureListener implementsOnGestureListener {

同时要public boolean onTouchEvent(MotionEvent event){
mGestureListener.onTouchEvent(event);
}

第三种示例代码

代码：

01.privateGestureDetector mGestureDetector;
02.@Override
03.public void onCreate(Bundle savedInstanceState) {
04. super.onCreate(savedInstanceState);
05. mGestureDetector = new GestureDetector(this, newLearnGestureListener());
06.}
07.@Override
08.public boolean onTouchEvent(MotionEvent event) {
09. if(mGestureDetector.onTouchEvent(event))
10.      returntrue;
11. else
12.      returnfalse;
13.}
14.class LearnGestureListener extendsGestureDetector.SimpleOnGestureListener{
15. @Override
16. public booleanonSingleTapUp(MotionEvent ev) {
17.      Log.d("onSingleTapUp",ev.toString());
18.      returntrue;
19. }
20. @Override
21. public voidonShowPress(MotionEvent ev) {
22.      Log.d("onShowPress",ev.toString());
23. }
24. @Override
25. public voidonLongPress(MotionEvent ev) {
26.      Log.d("onLongPress",ev.toString());
27. }
28. @Override
29. public booleanonScroll(MotionEvent e1, MotionEvent e2, float distanceX, floatdistanceY) {
30.      Log.d("onScroll",e1.toString());
31.      returntrue;
32. }
33. @Override
34. public booleanonDown(MotionEvent ev) {
35.      Log.d("onDownd",ev.toString());
36.      returntrue;
37. }
38. @Override
39. public booleanonFling(MotionEvent e1, MotionEvent e2, float velocityX, floatvelocityY) {
40.      Log.d("d",e1.toString());
41.      Log.d("e2",e2.toString());
42.      returntrue;
43. }
44.}

1，在当前类中创建一个GestureDetector实例。

private GestureDetectormGestureDetector;

2，创建一个Listener来实时监听当前面板操作手势。
class LearnGestureListener extendsGestureDetector.SimpleOnGestureListener

3，在初始化时，将Listener实例关联当前的GestureDetector实例。
mGestureDetector = new GestureDetector(this, newLearnGestureListener());

4，利用onTouchEvent方法作为入口检测，通过传递MotionEvent参数来监听操作手势。
1.mGestureDetector.onTouchEvent(event)

第四种示例代码

private GestureDetectormGestureDetector;

@Override

public void onCreate(BundlesavedInstanceState) {

super.onCreate(savedInstanceState);

mGestureDetector = newGestureDetector(this, new MyGestureListener());

}

@Override

public booleanonTouchEvent(MotionEvent event) {

returnmGestureDetector.onTouchEvent(event);

}

class MyGestureListener extendsGestureDetector.SimpleOnGestureListener{

@Override

public booleanonSingleTapUp(MotionEvent ev) {

Log.d("onSingleTapUp",ev.toString());

return true;

}

@Override

public voidonShowPress(MotionEvent ev) {

Log.d("onShowPress",ev.toString());

}

@Override

public voidonLongPress(MotionEvent ev) {

Log.d("onLongPress",ev.toString());

}

…

}

基本的内容就是创建一个GestureDetector的对象，传入listener对象，在自己接收到的onTouchEvent中将event传给GestureDetector进行分析，listener会回调给我们相应的动作。其中GestureDetector.SimpleOnGestureListener（Framework帮我们简化了）是实现了上面提到的OnGestureListener和OnDoubleTapListener两个接口的类，我们只需要继承它并重写其中我们关心的回调即可。

最后，再提一下双击和三击的识别过程：在第一次单击down时，给Hanlder发送了一个延时300ms的消息，如果300ms里，发生了第二次单击的down事件，那么，就认为是双击事件了，并移除之前发送的延时消息。如果300ms后仍没有第二次的down消息，那么就判定为SingleTapConfirmed事件（当然，此时用户的手指应已完成第一次点击的up过程）。三击的判定和双击的判定类似，只是多了一次发送延时消息的过程。