Android 多點(diǎn)手勢識(shí)別
? ? google提供的API中,有個(gè)類,大家都很熟悉,GestureDetector。使用它,我們可以識(shí)別用戶通常會(huì)用的手勢。但是,這個(gè)類不支持多點(diǎn)觸摸(可能google認(rèn)為沒有人會(huì)在幾個(gè)手指都在屏幕上的時(shí)候,使用手勢吧~),不過,最近和朋友們一起做的一個(gè)App,的確用到了多點(diǎn)手勢(主要是onScroll和onFling兩個(gè)手勢),所以,我就把這個(gè)類拓展了一下,來實(shí)現(xiàn)讓多個(gè)控件各自跟著一跟手指實(shí)現(xiàn)拖動(dòng)和滑動(dòng)的效果。
? ? 順便說一下,大家應(yīng)該都知道,在Android3.0以后,Android的觸摸事件的分配機(jī)制和以前的版本是有區(qū)別的。從3.0開始,用戶在不同控件上操作產(chǎn)生的touch消息不會(huì)相互干擾,touch消息會(huì)被分派到不同控件上的touchListener中處理。而
在以前的版本中,所有的touch消息,都會(huì)被分排到第一個(gè)碰到屏幕的手指所操作的控件的touchListener中處理,也就是說,會(huì)出現(xiàn)這樣一個(gè)矛盾的現(xiàn)象:
? ? 在界面上有A,B,C三個(gè)控件,然后,當(dāng)你先用食指按住A,跟著又用中指和無名指(嘛,別的手指也行,不用在意中指還是無名指)按住B,C。當(dāng)中指和無名指移動(dòng)的時(shí)候,B和C都無法接收到這個(gè)ACTION_MOVE消息,而接收到消息的卻是A。而在3.0以上版本中,并不存在這個(gè)問題。
? ?
package com.finger.utils;
import java.util.ArrayList;
import java.util.List;
import android.content.Context;
import android.os.Handler;
import android.os.Message;
import android.view.MotionEvent;
import android.view.VelocityTracker;
import android.view.ViewConfiguration;
public class MultiTouchGestureDetector {
@SuppressWarnings("unused")
private static final String MYTAG = "Ray";
public static final String CLASS_NAME = "MultiTouchGestureDetector";
/**
* 事件信息類
* 用來記錄一個(gè)手勢
*/
private class EventInfo {
private MultiMotionEvent mCurrentDownEvent; //當(dāng)前的down事件
private MultiMotionEvent mPreviousUpEvent; //上一次up事件
private boolean mStillDown; //當(dāng)前手指是否還在屏幕上
private boolean mInLongPress; //當(dāng)前事件是否屬于長按手勢
private boolean mAlwaysInTapRegion; //是否當(dāng)前手指僅在小范圍內(nèi)移動(dòng),當(dāng)手指僅在小范圍內(nèi)移動(dòng)時(shí),視為手指未曾移動(dòng)過,不會(huì)觸發(fā)onScroll手勢
private boolean mAlwaysInBiggerTapRegion; //是否當(dāng)前手指在較大范圍內(nèi)移動(dòng),僅當(dāng)此值為true時(shí),雙擊手勢才能成立
private boolean mIsDoubleTapping; //當(dāng)前手勢,是否為雙擊手勢
private float mLastMotionY; //最后一次事件的X坐標(biāo)
private float mLastMotionX; //最后一次事件的Y坐標(biāo)
private EventInfo(MotionEvent e) {
this(new MultiMotionEvent(e));
}
private EventInfo(MultiMotionEvent me) {
mCurrentDownEvent = me;
mStillDown = true;
mInLongPress = false;
mAlwaysInTapRegion = true;
mAlwaysInBiggerTapRegion = true;
mIsDoubleTapping = false;
}
//釋放MotionEven對(duì)象,使系統(tǒng)能夠繼續(xù)使用它們
public void recycle() {
if (mCurrentDownEvent != null) {
mCurrentDownEvent.recycle();
mCurrentDownEvent = null;
}
if (mPreviousUpEvent != null) {
mPreviousUpEvent.recycle();
mPreviousUpEvent = null;
}
}
@Override
public void finalize() {
this.recycle();
}
}
/**
* 多點(diǎn)事件類
* 將一個(gè)多點(diǎn)事件拆分為多個(gè)單點(diǎn)事件,并方便獲得事件的絕對(duì)坐標(biāo)
*
絕對(duì)坐標(biāo)用以在界面中找到觸點(diǎn)所在的控件
* @author ray-ni
*/
public class MultiMotionEvent {
private MotionEvent mEvent;
private int mIndex;
private MultiMotionEvent(MotionEvent e) {
mEvent = e;
mIndex = (e.getAction() & MotionEvent.ACTION_POINTER_ID_MASK) >> MotionEvent.ACTION_POINTER_ID_SHIFT; ?//等效于 mEvent.getActionIndex();
}
private MultiMotionEvent(MotionEvent e, int idx) {
mEvent = e;
mIndex = idx;
}
// 行為
public int getAction() {
int action = mEvent.getAction() & MotionEvent.ACTION_MASK; //等效于 mEvent.getActionMasked();
switch (action) {
case MotionEvent.ACTION_POINTER_DOWN:
action = MotionEvent.ACTION_DOWN;
break;
case MotionEvent.ACTION_POINTER_UP:
action = MotionEvent.ACTION_UP;
break;
}
return action;
}
// 返回X的絕對(duì)坐標(biāo)
public float getX() {
return mEvent.getX(mIndex) + mEvent.getRawX() - mEvent.getX();
}
// 返回Y的絕對(duì)坐標(biāo)
public float getY() {
return mEvent.getY(mIndex) + mEvent.getRawY() - mEvent.getY();
}
// 事件發(fā)生的時(shí)間
public long getEventTime() {
return mEvent.getEventTime();
}
// 事件序號(hào)
public int getIndex() {
return mIndex;
}
// 事件ID
public int getId() {
return mEvent.getPointerId(mIndex);
}
// 釋放事件對(duì)象,使系統(tǒng)能夠繼續(xù)使用
public void recycle() {
if (mEvent != null) {
mEvent.recycle();
mEvent = null;
}
}
}
// 多點(diǎn)手勢監(jiān)聽器
public interface MultiTouchGestureListener {
// 手指觸碰到屏幕,由一個(gè) ACTION_DOWN觸發(fā)
boolean onDown(MultiMotionEvent e);
// 確定一個(gè)press事件,強(qiáng)調(diào)手指按下的一段時(shí)間(TAP_TIMEOUT)內(nèi),手指未曾移動(dòng)或抬起
void onShowPress(MultiMotionEvent e);
// 手指點(diǎn)擊屏幕后離開,由 ACTION_UP引發(fā),可以簡單的理解為單擊事件,即手指點(diǎn)擊時(shí)間不長(未構(gòu)成長按事件),也不曾移動(dòng)過
boolean onSingleTapUp(MultiMotionEvent e);
// 長按,手指點(diǎn)下后一段時(shí)間(DOUBLE_TAP_TIMEOUT)內(nèi),不曾抬起或移動(dòng)
void onLongPress(MultiMotionEvent e);
// 拖動(dòng),由ACTION_MOVE觸發(fā),手指地按下后,在屏幕上移動(dòng)
boolean onScroll(MultiMotionEvent e1, MultiMotionEvent e2, float distanceX, float distanceY);
// 滑動(dòng),由ACTION_UP觸發(fā),手指按下并移動(dòng)一段距離后,抬起時(shí)觸發(fā)
boolean onFling(MultiMotionEvent e1, MultiMotionEvent e2, float velocityX, float velocityY);
}
// 多點(diǎn)雙擊監(jiān)聽器
public interface MultiTouchDoubleTapListener {
// 單擊事件確認(rèn),強(qiáng)調(diào)第一個(gè)單擊事件發(fā)生后,一段時(shí)間內(nèi),未發(fā)生第二次單擊事件,即確定不會(huì)觸發(fā)雙擊事件
boolean onSingleTapConfirmed(MultiMotionEvent e);
// 雙擊事件, 由ACTION_DOWN觸發(fā),從第一次單擊事件的DOWN事件開始的一段時(shí)間(DOUBLE_TAP_TIMEOUT)內(nèi)結(jié)束(即手指),
// 并且在第一次單擊事件的UP時(shí)間開始后的一段時(shí)間內(nèi)(DOUBLE_TAP_TIMEOUT)發(fā)生第二次單擊事件,
// 除此之外兩者坐標(biāo)間距小于定值(DOUBLE_TAP_SLAP)時(shí),則觸發(fā)雙擊事件
boolean onDoubleTap(MultiMotionEvent e);
// 雙擊事件,與onDoubleTap事件不同之處在于,構(gòu)成雙擊的第二次點(diǎn)擊的ACTION_DOWN,ACTION_MOVE和ACTION_UP都會(huì)觸發(fā)該事件
boolean onDoubleTapEvent(MultiMotionEvent e);
}
// 事件信息隊(duì)列,隊(duì)列的下標(biāo)與MotionEvent的pointId對(duì)應(yīng)
private static List