欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

Android GestureDetector用户手势检测实例讲解

程序员文章站 2023-12-04 15:26:40
一、概述 当用户触摸屏幕的时候,会产生许多手势,例如down,up,scroll,filing等等。 一般情况下,我们知道view类有个view.ontouchli...

一、概述

当用户触摸屏幕的时候,会产生许多手势,例如down,up,scroll,filing等等。
一般情况下,我们知道view类有个view.ontouchlistener内部接口,通过重写他的ontouch(view v, motionevent event)方法,我们可以处理一些touch事件,但是这个方法太过简单,如果需要处理一些复杂的手势,用这个接口就会很麻烦(因为我们要自己根据用户触摸的轨迹去判断是什么手势)。

android sdk给我们提供了gesturedetector(gesture:手势detector:识别)类,通过这个类我们可以识别很多的手势,主要是通过他的ontouchevent(event)方法完成了不同手势的识别。虽然他能识别手势,但是不同的手势要怎么处理,应该是提供给程序员实现的。

gesturedetector这个类对外提供了两个接口和一个外部类
接口:ongesturelistener,ondoubletaplistener
内部类:simpleongesturelistener

这个外部类,其实是两个接口中所有函数的集成,它包含了这两个接口里所有必须要实现的函数而且都已经重写,但所有方法体都是空的;不同点在于:该类是static class,程序员可以在外部继承这个类,重写里面的手势处理方法。

下面我们先看ongesturelistener接口;

二、gesturedetector.ongesturelistener---接口

1、基本讲解
如果我们写一个类并implements ongesturelistener,会提示有几个必须重写的函数,加上之后是这个样子的:

private class gesturelistener implements gesturedetector.ongesturelistener{ 
 
 public boolean ondown(motionevent e) { 
  // todo auto-generated method stub 
  return false; 
 } 
 
 public void onshowpress(motionevent e) { 
  // todo auto-generated method stub 
   
 } 
 
 public boolean onsingletapup(motionevent e) { 
  // todo auto-generated method stub 
  return false; 
 } 
 
 public boolean onscroll(motionevent e1, motionevent e2, 
   float distancex, float distancey) { 
  // todo auto-generated method stub 
  return false; 
 } 
 
 public void onlongpress(motionevent e) { 
  // todo auto-generated method stub 
   
 } 
 
 public boolean onfling(motionevent e1, motionevent e2, float velocityx, 
   float velocityy) { 
  // todo auto-generated method stub 
  return false; 
 } 
  
} 

可见,这里总共重写了六个函数,这些函数都在什么情况下才会触发呢,下面讲一下:

ondown(motionevent e):用户按下屏幕就会触发;
onshowpress(motionevent e):如果是按下的时间超过瞬间,而且在按下的时候没有松开或者是拖动的,那么onshowpress就会执行,具体这个瞬间是多久,我也不清楚呃……
onlongpress(motionevent e):长按触摸屏,超过一定时长,就会触发这个事件

触发顺序:
ondown->onshowpress->onlongpress
onsingletapup(motionevent e):从名子也可以看出,一次单独的轻击抬起操作,也就是轻击一下屏幕,立刻抬起来,才会有这个触发,当然,如果除了down以外还有其它操作,那就不再算是single操作了,所以也就不会触发这个事件

触发顺序:
点击一下非常快的(不滑动)touchup:
ondown->onsingletapup->onsingletapconfirmed 
点击一下稍微慢点的(不滑动)touchup:
ondown->onshowpress->onsingletapup->onsingletapconfirmed

onfling(motionevent e1, motionevent e2, float velocityx,float velocityy) :滑屏,用户按下触摸屏、快速移动后松开,由1个motionevent action_down, 多个action_move, 1个action_up触发   

参数解释:
    e1:第1个action_down motionevent
    e2:最后一个action_move motionevent
    velocityx:x轴上的移动速度,像素/秒
    velocityy:y轴上的移动速度,像素/秒  

onscroll(motionevent e1, motionevent e2,float distancex, float distancey):在屏幕上拖动事件。无论是用手拖动view,或者是以抛的动作滚动,都会多次触发,这个方法在action_move动作发生时就会触发

滑屏:手指触动屏幕后,稍微滑动后立即松开
ondown-----》onscroll----》onscroll----》onscroll----》………----->onfling
拖动:
ondown------》onscroll----》onscroll------》onfiling

可见,无论是滑屏,还是拖动,影响的只是中间onscroll触发的数量多少而已,最终都会触发onfling事件!

2、实例

要使用gesturedetector,有三步要走:
1.创建ongesturelistener监听函数:
可以使用构造实例:

gesturedetector.ongesturelistener listener = new gesturedetector.ongesturelistener(){ 
   
 };

也可以构造类:

private class gesturelistener implements gesturedetector.ongesturelistener{ 
 
} 

2.创建gesturedetector实例mgesturedetector:

构造函数有下面三个,根据需要选择:

gesturedetector gesturedetector=new gesturedetector(gesturedetector.ongesturelistener listener); 
gesturedetector gesturedetector=new gesturedetector(context context,gesturedetector.ongesturelistener listener); 
gesturedetector gesturedetector=new gesturedetector(context context,gesturedetector.simpleongesturelistener listener); 

3、ontouch(view v, motionevent event)中拦截:

public boolean ontouch(view v, motionevent event) { 
 return mgesturedetector.ontouchevent(event);  
} 

4.控件绑定

textview tv = (textview)findviewbyid(r.id.tv); 
tv.setontouchlistener(this); 

现在进入实例阶段:
首先,在主布局页面添加一个textview,并将其放大到整屏,方便在其上的手势识别,代码为:

<relativelayout xmlns:android="http://schemas.android.com/apk/res/android" 
 xmlns:tools="http://schemas.android.com/tools" 
 android:layout_width="match_parent" 
 android:layout_height="match_parent" 
 tools:context="com.example.gesturedetectorinterface.mainactivity" > 
 
 <textview 
  android:id="@+id/tv" 
  android:layout_width="fill_parent" 
  android:layout_height="fill_parent" 
  android:layout_margin="50dip" 
  android:background="#ff00ff" 
  android:text="@string/hello_world" /> 
 
</relativelayout> 

然后在java代码中,依据上面的三步走原则,写出代码,并在所有的手势下添加上toast提示并写上log

public class mainactivity extends activity implements ontouchlistener{ 
 
 private gesturedetector mgesturedetector;  
  
 
 @override 
 protected void oncreate(bundle savedinstancestate) { 
  super.oncreate(savedinstancestate); 
  setcontentview(r.layout.activity_main); 
   
  mgesturedetector = new gesturedetector(new gesturelistener()); //使用派生自ongesturelistener 
   
  textview tv = (textview)findviewbyid(r.id.tv); 
  tv.setontouchlistener(this); 
  tv.setfocusable(true);  
  tv.setclickable(true);  
  tv.setlongclickable(true); 
 } 
  
  
 /* 
  * 在ontouch()方法中,我们调用gesturedetector的ontouchevent()方法,将捕捉到的motionevent交给gesturedetector 
  * 来分析是否有合适的callback函数来处理用户的手势 
  */ 
 public boolean ontouch(view v, motionevent event) { 
  return mgesturedetector.ontouchevent(event);  
 } 
  
 private class gesturelistener implements gesturedetector.ongesturelistener{ 
 
  // 用户轻触触摸屏,由1个motionevent action_down触发  
  public boolean ondown(motionevent e) { 
   log.i("mygesture", "ondown");  
   toast.maketext(mainactivity.this, "ondown", toast.length_short).show();  
   return false; 
  } 
 
  /* 
   * 用户轻触触摸屏,尚未松开或拖动,由一个1个motionevent action_down触发 
   * 注意和ondown()的区别,强调的是没有松开或者拖动的状态 
   * 
   * 而ondown也是由一个motioneventaction_down触发的,但是他没有任何限制, 
   * 也就是说当用户点击的时候,首先motioneventaction_down,ondown就会执行, 
   * 如果在按下的瞬间没有松开或者是拖动的时候onshowpress就会执行,如果是按下的时间超过瞬间 
   * (这块我也不太清楚瞬间的时间差是多少,一般情况下都会执行onshowpress),拖动了,就不执行onshowpress。 
   */ 
  public void onshowpress(motionevent e) { 
   log.i("mygesture", "onshowpress");  
   toast.maketext(mainactivity.this, "onshowpress", toast.length_short).show();  
  } 
 
  // 用户(轻触触摸屏后)松开,由一个1个motionevent action_up触发  
  ///轻击一下屏幕,立刻抬起来,才会有这个触发 
  //从名子也可以看出,一次单独的轻击抬起操作,当然,如果除了down以外还有其它操作,那就不再算是single操作了,所以这个事件 就不再响应 
  public boolean onsingletapup(motionevent e) { 
   log.i("mygesture", "onsingletapup");  
   toast.maketext(mainactivity.this, "onsingletapup", toast.length_short).show();  
   return true;  
  } 
 
  // 用户按下触摸屏,并拖动,由1个motionevent action_down, 多个action_move触发  
  public boolean onscroll(motionevent e1, motionevent e2, 
    float distancex, float distancey) { 
   log.i("mygesture22", "onscroll:"+(e2.getx()-e1.getx()) +" "+distancex);  
   toast.maketext(mainactivity.this, "onscroll", toast.length_long).show();  
    
   return true;  
  } 
 
  // 用户长按触摸屏,由多个motionevent action_down触发  
  public void onlongpress(motionevent e) { 
    log.i("mygesture", "onlongpress");  
    toast.maketext(mainactivity.this, "onlongpress", toast.length_long).show();  
  } 
 
  // 用户按下触摸屏、快速移动后松开,由1个motionevent action_down, 多个action_move, 1个action_up触发  
  public boolean onfling(motionevent e1, motionevent e2, float velocityx, 
    float velocityy) { 
   log.i("mygesture", "onfling");  
   toast.maketext(mainactivity.this, "onfling", toast.length_long).show();  
   return true; 
  } 
 }; 
  
 
} 

源码在博客底部给出。

三、gesturedetector.ondoubletaplistener---接口

1、构建

有两种方式设置双击监听:

方法一:新建一个类同时派生自ongesturelistener和ondoubletaplistener:

private class gesturelistener implements gesturedetector.ongesturelistener,gesturedetector.ondoubletaplistener{ 
 } 


方法二:使用gesturedetector::setondoubletaplistener();函数设置监听:

//构建gesturedetector实例  
mgesturedetector = new gesturedetector(new gesturelistener()); //使用派生自ongesturelistener 
private class gesturelistener implements gesturedetector.ongesturelistener{ 
  
} 
 
//设置双击监听器 
mgesturedetector.setondoubletaplistener(new doubletaplistener()); 
private class doubletaplistener implements gesturedetector.ondoubletaplistener{ 
  
} 

注意:大家可以看到无论在方法一还是在方法二中,都需要派生自gesturedetector.ongesturelistener,前面我们说过gesturedetector 的构造函数,如下:
gesturedetector gesturedetector=new gesturedetector(gesturedetector.ongesturelistener listener); 
gesturedetector gesturedetector=new gesturedetector(context context,gesturedetector.ongesturelistener listener); 
gesturedetector gesturedetector=new gesturedetector(context context,gesturedetector.simpleongesturelistener listener); 

可以看到,在构造函数中,除了后面要讲的simpleongesturelistener 以外的其它两个构造函数都必须是ongesturelistener的实例。所以要想使用ondoubletaplistener的几个函数,就必须先实现ongesturelistener。

2、函数讲解

首先看一下ondoubletaplistener接口必须重写的三个函数:

private class doubletaplistener implements gesturedetector.ondoubletaplistener{ 
 
 public boolean onsingletapconfirmed(motionevent e) { 
  // todo auto-generated method stub 
  return false; 
 } 
 
 public boolean ondoubletap(motionevent e) { 
  // todo auto-generated method stub 
  return false; 
 } 
 
 public boolean ondoubletapevent(motionevent e) { 
  // todo auto-generated method stub 
  return false; 
 } 
} 

onsingletapconfirmed(motionevent e):单击事件。用来判定该次点击是singletap而不是doubletap,如果连续点击两次就是doubletap手势,如果只点击一次,系统等待一段时间后没有收到第二次点击则判定该次点击为singletap而不是doubletap,然后触发singletapconfirmed事件。触发顺序是:ondown->onsingletapup->onsingletapconfirmed
关于onsingletapconfirmed和onsingletapup的一点区别: ongesturelistener有这样的一个方法onsingletapup,和onsingletapconfirmed容易混淆。二者的区别是:onsingletapup,只要手抬起就会执行,而对于onsingletapconfirmed来说,如果双击的话,则onsingletapconfirmed不会执行。
ondoubletap(motionevent e):双击事件

ondoubletapevent(motionevent e):双击间隔中发生的动作。指触发ondoubletap以后,在双击之间发生的其它动作,包含down、up和move事件;下图是双击一下的log输出:

Android GestureDetector用户手势检测实例讲解

两点总结:

1、从上图可以看出,在第二下点击时,先触发ondoubletap,然后再触发ondown(第二次点击)

2、其次在触发ondoubletap以后,就开始触发ondoubletapevent了,ondoubletapevent后面的数字代表了当前的事件,0指action_down,1指action_up,2 指action_move
在上一个例子的基础上,我们再添加一个双击监听类,实现如下:

public class mainactivity extends activity implements ontouchlistener{ 
 
 private gesturedetector mgesturedetector;  
  
 
 @override 
 protected void oncreate(bundle savedinstancestate) { 
  super.oncreate(savedinstancestate); 
  setcontentview(r.layout.activity_main); 
   
 
  mgesturedetector = new gesturedetector(new gesturelistener()); //使用派生自ongesturelistener 
  mgesturedetector.setondoubletaplistener(new doubletaplistener()); 
   
  textview tv = (textview)findviewbyid(r.id.tv); 
  tv.setontouchlistener(this); 
  tv.setfocusable(true);  
  tv.setclickable(true);  
  tv.setlongclickable(true); 
 } 
  
  
 /* 
  * 在ontouch()方法中,我们调用gesturedetector的ontouchevent()方法,将捕捉到的motionevent交给gesturedetector 
  * 来分析是否有合适的callback函数来处理用户的手势 
  */ 
 public boolean ontouch(view v, motionevent event) { 
  return mgesturedetector.ontouchevent(event);  
 } 
  
 //ongesturelistener监听 
 private class gesturelistener implements gesturedetector.ongesturelistener{ 
 
  public boolean ondown(motionevent e) { 
   log.i("mygesture", "ondown");  
   toast.maketext(mainactivity.this, "ondown", toast.length_short).show();  
   return false; 
  } 
 
  public void onshowpress(motionevent e) { 
   log.i("mygesture", "onshowpress");  
   toast.maketext(mainactivity.this, "onshowpress", toast.length_short).show();  
  } 
 
  public boolean onsingletapup(motionevent e) { 
   log.i("mygesture", "onsingletapup");  
   toast.maketext(mainactivity.this, "onsingletapup", toast.length_short).show();  
   return true;  
  } 
 
  public boolean onscroll(motionevent e1, motionevent e2, 
    float distancex, float distancey) { 
   log.i("mygesture22", "onscroll:"+(e2.getx()-e1.getx()) +" "+distancex);  
   toast.maketext(mainactivity.this, "onscroll", toast.length_long).show();  
    
   return true;  
  } 
 
  public void onlongpress(motionevent e) { 
    log.i("mygesture", "onlongpress");  
    toast.maketext(mainactivity.this, "onlongpress", toast.length_long).show();  
  } 
 
  public boolean onfling(motionevent e1, motionevent e2, float velocityx, 
    float velocityy) { 
   log.i("mygesture", "onfling");  
   toast.maketext(mainactivity.this, "onfling", toast.length_long).show();  
   return true; 
  } 
 }; 
  
 //ondoubletaplistener监听 
 private class doubletaplistener implements gesturedetector.ondoubletaplistener{ 
 
  public boolean onsingletapconfirmed(motionevent e) { 
   log.i("mygesture", "onsingletapconfirmed");  
   toast.maketext(mainactivity.this, "onsingletapconfirmed", toast.length_long).show(); 
   return true; 
  } 
 
  public boolean ondoubletap(motionevent e) { 
   log.i("mygesture", "ondoubletap");  
   toast.maketext(mainactivity.this, "ondoubletap", toast.length_long).show(); 
   return true; 
  } 
 
  public boolean ondoubletapevent(motionevent e) { 
   log.i("mygesture", "ondoubletapevent");  
   toast.maketext(mainactivity.this, "ondoubletapevent", toast.length_long).show(); 
   return true; 
  } 
 }; 
} 

双击一下,部分截图如下:

Android GestureDetector用户手势检测实例讲解

双击所对应的触发事件顺序:

Android GestureDetector用户手势检测实例讲解

轻轻单击一下,对应的事件触发顺序为:

Android GestureDetector用户手势检测实例讲解

源码在博客底部给出。

四、gesturedetector.simpleongesturelistener---类

它与前两个不同的是:
1、这是一个类,在它基础上新建类的话,要用extends派生而不是用implements继承!
2、ongesturelistener和ondoubletaplistener接口里的函数都是强制必须重写的,即使用不到也要重写出来一个空函数但在simpleongesturelistener类的实例或派生类中不必如此,可以根据情况,用到哪个函数就重写哪个函数,因为simpleongesturelistener类本身已经实现了这两个接口的所有函数,只是里面全是空的而已。
下面利用simpleongesturelistener类来重新实现上面的几个效果,代码如下:

public class mainactivity extends activity implements ontouchlistener { 
 
 private gesturedetector mgesturedetector;  
  
 @override 
 protected void oncreate(bundle savedinstancestate) { 
  super.oncreate(savedinstancestate); 
  setcontentview(r.layout.activity_main); 
   
  mgesturedetector = new gesturedetector(new simplegesturelistener()); 
   
  textview tv = (textview)findviewbyid(r.id.tv); 
  tv.setontouchlistener(this); 
  tv.setfocusable(true);  
  tv.setclickable(true);  
  tv.setlongclickable(true); 
 } 
  
 public boolean ontouch(view v, motionevent event) { 
  // todo auto-generated method stub 
  return mgesturedetector.ontouchevent(event);  
 } 
 
 private class simplegesturelistener extends 
   gesturedetector.simpleongesturelistener { 
   
  /*****ongesturelistener的函数*****/ 
  public boolean ondown(motionevent e) { 
   log.i("mygesture", "ondown"); 
   toast.maketext(mainactivity.this, "ondown", toast.length_short) 
     .show(); 
   return false; 
  } 
 
  public void onshowpress(motionevent e) { 
   log.i("mygesture", "onshowpress"); 
   toast.maketext(mainactivity.this, "onshowpress", toast.length_short) 
     .show(); 
  } 
 
  public boolean onsingletapup(motionevent e) { 
   log.i("mygesture", "onsingletapup"); 
   toast.maketext(mainactivity.this, "onsingletapup", 
     toast.length_short).show(); 
   return true; 
  } 
 
  public boolean onscroll(motionevent e1, motionevent e2, 
    float distancex, float distancey) { 
   log.i("mygesture", "onscroll:" + (e2.getx() - e1.getx()) + " " 
     + distancex); 
   toast.maketext(mainactivity.this, "onscroll", toast.length_long) 
     .show(); 
 
   return true; 
  } 
 
  public void onlongpress(motionevent e) { 
   log.i("mygesture", "onlongpress"); 
   toast.maketext(mainactivity.this, "onlongpress", toast.length_long) 
     .show(); 
  } 
 
  public boolean onfling(motionevent e1, motionevent e2, float velocityx, 
    float velocityy) { 
   log.i("mygesture", "onfling"); 
   toast.maketext(mainactivity.this, "onfling", toast.length_long) 
     .show(); 
   return true; 
  } 
   
  /*****ondoubletaplistener的函数*****/ 
  public boolean onsingletapconfirmed(motionevent e) { 
   log.i("mygesture", "onsingletapconfirmed"); 
   toast.maketext(mainactivity.this, "onsingletapconfirmed", 
     toast.length_long).show(); 
   return true; 
  } 
 
  public boolean ondoubletap(motionevent e) { 
   log.i("mygesture", "ondoubletap"); 
   toast.maketext(mainactivity.this, "ondoubletap", toast.length_long) 
     .show(); 
   return true; 
  } 
 
  public boolean ondoubletapevent(motionevent e) { 
   log.i("mygesture", "ondoubletapevent"); 
   toast.maketext(mainactivity.this, "ondoubletapevent", 
     toast.length_long).show(); 
   return true; 
  } 
 
 } 
} 

到此,有关gesturedetector的所有基础知识都讲解完了,下面给出一个小应用——识别用户是向左滑还是向右滑!

源码在博客底部给出。

五、onfling应用——识别向左滑还是向右滑

这部分就有点意思了,可以说是上面知识的一个小应用,我们利用onfling函数来识别当前用户是在向左滑还是向右滑,从而打出日志。先看下onfling的参数:

boolean onfling(motionevent e1, motionevent e2, float velocityx,float velocityy) 

参数解释:    
e1:第1个action_down motionevent    
e2:最后一个action_move motionevent    
velocityx:x轴上的移动速度,像素/秒    
velocityy:y轴上的移动速度,像素/秒    
首先,先说一下实现的功能:当用户向左滑动距离超过100px,且滑动速度超过100 px/s时,即判断为向左滑动;向右同理.代码如下:

public class mainactivity extends activity implements ontouchlistener { 
 
 private gesturedetector mgesturedetector;  
  
 @override 
 protected void oncreate(bundle savedinstancestate) { 
  super.oncreate(savedinstancestate); 
  setcontentview(r.layout.activity_main); 
   
  mgesturedetector = new gesturedetector(new simplegesturelistener()); 
   
  textview tv = (textview)findviewbyid(r.id.tv); 
  tv.setontouchlistener(this); 
  tv.setfocusable(true);  
  tv.setclickable(true);  
  tv.setlongclickable(true); 
 } 
  
 public boolean ontouch(view v, motionevent event) { 
  // todo auto-generated method stub 
  return mgesturedetector.ontouchevent(event);  
 } 
 
 private class simplegesturelistener extends 
   gesturedetector.simpleongesturelistener { 
   
  /*****ongesturelistener的函数*****/ 
 
  final int fling_min_distance = 100, fling_min_velocity = 200; 
   
  // 触发条件 :  
  // x轴的坐标位移大于fling_min_distance,且移动速度大于fling_min_velocity个像素/秒  
   
  // 参数解释:  
  // e1:第1个action_down motionevent  
  // e2:最后一个action_move motionevent  
  // velocityx:x轴上的移动速度,像素/秒  
  // velocityy:y轴上的移动速度,像素/秒  
  public boolean onfling(motionevent e1, motionevent e2, float velocityx, 
    float velocityy) { 
    
    
   if (e1.getx() - e2.getx() > fling_min_distance 
     && math.abs(velocityx) > fling_min_velocity) { 
    // fling left  
    log.i("mygesture", "fling left"); 
    toast.maketext(mainactivity.this, "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(mainactivity.this, "fling right", toast.length_short).show(); 
   } 
   return true; 
  } 
 
 } 
} 

这段代码难度不大,就不再细讲,看下效果:

Android GestureDetector用户手势检测实例讲解

源码在博客底部给出。

源码地址:gesturedetector手势检测

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。