Android 多點(diǎn)手勢(shì)識(shí)別
2018-07-20 來源：open-open
google 提供的API中，有個(gè)類，大家都很熟悉，GestureDetector。使用它，我們可以識(shí)別用戶通常會(huì)用的手勢(shì)。但是，這個(gè)類不支持多點(diǎn)觸摸（可能 google認(rèn)為沒有人會(huì)在幾個(gè)手指都在屏幕上的時(shí)候，使用手勢(shì)吧~），不過，最近和朋友們一起做的一個(gè)App，的確用到了多點(diǎn)手勢(shì)（主要是 onScroll和onFling兩個(gè)手勢(shì)），所以，我就把這個(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è)問題。 使用以下的這個(gè)類，可以實(shí)現(xiàn)從2.2到3.2平臺(tái)上手勢(shì)識(shí)別的兼容。
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";
/**
* 事件信息類 <br/>
* 用來記錄一個(gè)手勢(shì)
*/
private class EventInfo {
private MultiMotionEvent mCurrentDownEvent; //當(dāng)前的down事件
private MultiMotionEvent mPreviousUpEvent; //上一次up事件
private boolean mStillDown; //當(dāng)前手指是否還在屏幕上
private boolean mInLongPress; //當(dāng)前事件是否屬于長(zhǎng)按手勢(shì)
private boolean mAlwaysInTapRegion; //是否當(dāng)前手指僅在小范圍內(nèi)移動(dòng)，當(dāng)手指僅在小范圍內(nèi)移動(dòng)時(shí)，視為手指未曾移動(dòng)過，不會(huì)觸發(fā)onScroll手勢(shì)
private boolean mAlwaysInBiggerTapRegion; //是否當(dāng)前手指在較大范圍內(nèi)移動(dòng)，僅當(dāng)此值為true時(shí)，雙擊手勢(shì)才能成立
private boolean mIsDoubleTapping; //當(dāng)前手勢(shì)，是否為雙擊手勢(shì)
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)事件類 <br/>
* 將一個(gè)多點(diǎn)事件拆分為多個(gè)單點(diǎn)事件，并方便獲得事件的絕對(duì)坐標(biāo)
* <br/> 絕對(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)手勢(shì)監(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ā)，可以簡(jiǎn)單的理解為單擊事件，即手指點(diǎn)擊時(shí)間不長(zhǎng)（未構(gòu)成長(zhǎng)按事件），也不曾移動(dòng)過
boolean onSingleTapUp(MultiMotionEvent e);
// 長(zhǎng)按，手指點(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<EventInfo> sEventInfos = new ArrayList<EventInfo>(10);
// 雙擊判斷隊(duì)列，這個(gè)隊(duì)列中的元素等待雙擊超時(shí)的判斷結(jié)果
private static List<EventInfo> sEventForDoubleTap = new ArrayList<EventInfo>(5);
// 指定大點(diǎn)擊區(qū)域的大�。ㄟ@個(gè)比較拗口），這個(gè)值主要用于幫助判斷雙擊是否成立
private int mBiggerTouchSlopSquare = 20 * 20;
// 判斷是否構(gòu)成onScroll手勢(shì)，當(dāng)手指在這個(gè)范圍內(nèi)移動(dòng)時(shí)，不觸發(fā)onScroll手勢(shì)
private int mTouchSlopSquare;
// 判斷是否構(gòu)成雙擊，只有兩次點(diǎn)擊的距離小于該值，才能構(gòu)成雙擊手勢(shì)
private int mDoubleTapSlopSquare;
// 最小滑動(dòng)速度
private int mMinimumFlingVelocity;
// 最大滑動(dòng)速度
private int mMaximumFlingVelocity;
// 長(zhǎng)按閥值，當(dāng)手指按下后，在該閥值的時(shí)間內(nèi)，未移動(dòng)超過mTouchSlopSquare的距離并未抬起，則長(zhǎng)按手勢(shì)觸發(fā)
private static final int LONGPRESS_TIMEOUT = ViewConfiguration.getLongPressTimeout();
// showPress手勢(shì)的觸發(fā)閥值，當(dāng)手指按下后，在該閥值的時(shí)間內(nèi)，未移動(dòng)超過mTouchSlopSquare的距離并未抬起，則showPress手勢(shì)觸發(fā)
private static final int TAP_TIMEOUT = ViewConfiguration.getTapTimeout();
// 雙擊超時(shí)閥值，僅在兩次雙擊事件的間隔（第一次單擊的UP事件和第二次單擊的DOWN事件）小于此閥值，雙擊事件才能成立
private static final int DOUBLE_TAP_TIMEOUT = ViewConfiguration.getDoubleTapTimeout();
// 雙擊區(qū)域閥值，僅在兩次雙擊事件的距離小于此閥值，雙擊事件才能成立
private static final int DOUBLE_TAP_SLAP = 64;
// GestureHandler所處理的Message的what屬性可能為以下 常量：
// showPress手勢(shì)
private static final int SHOW_PRESS = 1;
// 長(zhǎng)按手勢(shì)
private static final int LONG_PRESS = 2;
// SingleTapConfirmed手勢(shì)
private static final int TAP_SINGLE = 3;
// 雙擊手勢(shì)
private static final int TAP_DOUBLE = 4;
// 手勢(shì)處理器
private final GestureHandler mHandler;
// 手勢(shì)監(jiān)聽器
private final MultiTouchGestureListener mListener;
// 雙擊監(jiān)聽器
private MultiTouchDoubleTapListener mDoubleTapListener;
// 長(zhǎng)按允許閥值
private boolean mIsLongpressEnabled;
// 速度追蹤器
private VelocityTracker mVelocityTracker;
private class GestureHandler extends Handler {
GestureHandler() {
super();
}
GestureHandler(Handler handler) {
super(handler.getLooper());
}
@Override
public void handleMessage(Message msg) {
int idx = (Integer) msg.obj;
switch (msg.what) {
case SHOW_PRESS: {
if (idx >= sEventInfos.size()) {
// Log.w(MYTAG, CLASS_NAME + ":handleMessage, msg.what = SHOW_PRESS, idx=" + idx + ", while sEventInfos.size()="
// + sEventInfos.size());
break;
}
EventInfo info = sEventInfos.get(idx);
if (info == null) {
// Log.e(MYTAG, CLASS_NAME + ":handleMessage, msg.what = SHOW_PRESS, idx=" + idx + ", Info = null");
break;
}
// 觸發(fā)手勢(shì)監(jiān)聽器的onShowPress事件
mListener.onShowPress(info.mCurrentDownEvent);
break;
}
case LONG_PRESS: {
// Log.d(MYTAG, CLASS_NAME + ":trigger LONG_PRESS");
if (idx >= sEventInfos.size()) {
// Log.w(MYTAG, CLASS_NAME + ":handleMessage, msg.what = LONG_PRESS, idx=" + idx + ", while sEventInfos.size()="
// + sEventInfos.size());
break;
}
EventInfo info = sEventInfos.get(idx);
if (info == null) {
// Log.e(MYTAG, CLASS_NAME + ":handleMessage, msg.what = LONG_PRESS, idx=" + idx + ", Info = null");
break;
}
dispatchLongPress(info, idx);
break;
}
case TAP_SINGLE: {
// Log.d(MYTAG, CLASS_NAME + ":trriger TAP_SINGLE");
// If the user's finger is still down, do not count it as a tap
if (idx >= sEventInfos.size()) {
// Log.e(MYTAG, CLASS_NAME + ":handleMessage, msg.what = TAP_SINGLE, idx=" + idx + ", while sEventInfos.size()="
// + sEventInfos.size());
break;
}
EventInfo info = sEventInfos.get(idx);
if (info == null) {
// Log.e(MYTAG, CLASS_NAME + ":handleMessage, msg.what = TAP_SINGLE, idx=" + idx + ", Info = null");
break;
}
if (mDoubleTapListener != null && !info.mStillDown) { //手指在雙擊超時(shí)的閥值內(nèi)未離開屏幕進(jìn)行第二次單擊事件，則確定單擊事件成立（不再觸發(fā)雙擊事件）
mDoubleTapListener.onSingleTapConfirmed(info.mCurrentDownEvent);
}
break;
}
case TAP_DOUBLE: {
if (idx >= sEventForDoubleTap.size()) {
// Log.w(MYTAG, CLASS_NAME + ":handleMessage, msg.what = TAP_DOUBLE, idx=" + idx + ", while sEventForDoubleTap.size()="
// + sEventForDoubleTap.size());
break;
}
EventInfo info = sEventForDoubleTap.get(idx);
if (info == null) {
// Log.w(MYTAG, CLASS_NAME + ":handleMessage, msg.what = TAP_DOUBLE, idx=" + idx + ", Info = null");
break;
}
sEventForDoubleTap.set(idx, null);// 這個(gè)沒什么好做的，就是把隊(duì)列中對(duì)應(yīng)的元素清除而已
break;
}
default:
throw new RuntimeException("Unknown message " + msg); // never
}
}
}
/**
* 觸發(fā)長(zhǎng)按事件
* @param info
* @param idx
*/
private void dispatchLongPress(EventInfo info, int idx) {
mHandler.removeMessages(TAP_SINGLE, idx);//移除單擊事件確認(rèn)
info.mInLongPress = true;
mListener.onLongPress(info.mCurrentDownEvent);
}
/**
* 構(gòu)造器1
* @param context
* @param listener
*/
public MultiTouchGestureDetector(Context context, MultiTouchGestureListener listener) {
this(context, listener, null);
}
/**
* 構(gòu)造器2
* @param context
* @param listener
* @param handler
*/
public MultiTouchGestureDetector(Context context, MultiTouchGestureListener listener, Handler handler) {
if (handler != null) {
mHandler = new GestureHandler(handler);
} else {
mHandler = new GestureHandler();
}
mListener = listener;
if (listener instanceof MultiTouchDoubleTapListener) {
setOnDoubleTapListener((MultiTouchDoubleTapListener) listener);
}
init(context);
}
/**
* 初始化識(shí)別器
* @param context
*/
private void init(Context context) {
if (mListener == null) {
throw new NullPointerException("OnGestureListener must not be null");
}
mIsLongpressEnabled = true;
int touchSlop, doubleTapSlop;
if (context == null) {
touchSlop = ViewConfiguration.getTouchSlop();
doubleTapSlop = DOUBLE_TAP_SLAP;
mMinimumFlingVelocity = ViewConfiguration.getMinimumFlingVelocity();
mMaximumFlingVelocity = ViewConfiguration.getMaximumFlingVelocity();
} else {//允許識(shí)別器在App中，使用偏好的設(shè)定
final ViewConfiguration configuration = ViewConfiguration.get(context);
touchSlop = configuration.getScaledTouchSlop();
doubleTapSlop = configuration.getScaledDoubleTapSlop();
mMinimumFlingVelocity = configuration.getScaledMinimumFlingVelocity();
mMaximumFlingVelocity = configuration.getScaledMaximumFlingVelocity();
}
mTouchSlopSquare = touchSlop * touchSlop / 16;
mDoubleTapSlopSquare = doubleTapSlop * doubleTapSlop;
}
/**
* 設(shè)置雙擊監(jiān)聽器
* @param onDoubleTapListener
*/
public void setOnDoubleTapListener(MultiTouchDoubleTapListener onDoubleTapListener) {
mDoubleTapListener = onDoubleTapListener;
}
/**
* 設(shè)置是否允許長(zhǎng)按
* @param isLongpressEnabled
*/
public void setIsLongpressEnabled(boolean isLongpressEnabled) {
mIsLongpressEnabled = isLongpressEnabled;
}
/**
* 判斷是否允許長(zhǎng)按
* @return
*/
public boolean isLongpressEnabled() {
return mIsLongpressEnabled;
}
/**
* 判斷當(dāng)前事件是否為雙擊事件
* <br/> 通過遍歷sEventForDoubleTap來匹配是否存在能夠構(gòu)成雙擊事件的單擊事件
* @param e
* @return
*/
private EventInfo checkForDoubleTap(MultiMotionEvent e) {
if (sEventForDoubleTap.isEmpty()) {
// Log.e(MYTAG, CLASS_NAME + ":checkForDoubleTap(), sEventForDoubleTap is empty !");
return null;
}
for (int i = 0; i < sEventForDoubleTap.size(); i++) {
EventInfo info = sEventForDoubleTap.get(i);
if (info != null && isConsideredDoubleTap(info, e)) {
sEventForDoubleTap.set(i, null);// 這個(gè)單擊事件已經(jīng)被消耗了，所以置為null
mHandler.removeMessages(TAP_DOUBLE, i);// 移除Handler內(nèi)的為處理消息
return info;
}
}
return null;
}
/**
* 判斷當(dāng)前按下事件是否能和指定的單擊事件構(gòu)成雙擊事件
*
* @param info
* @param secondDown
* @return
*/
private boolean isConsideredDoubleTap(EventInfo info, MultiMotionEvent secondDown) {
if (!info.mAlwaysInBiggerTapRegion) { //如多第一次單擊事件有過較大距離的移動(dòng)，則無法構(gòu)成雙擊事件
return false;
}
if (secondDown.getEventTime() - info.mPreviousUpEvent.getEventTime() > DOUBLE_TAP_TIMEOUT) {
//如果第一次單擊的UP時(shí)間和第二次單擊的down時(shí)間時(shí)間間隔大于DOUBLE_TAP_TIMEOUT，也無法構(gòu)成雙擊事件
return false;
}
int deltaX = (int) info.mCurrentDownEvent.getX() - (int) secondDown.getX();
int deltaY = (int) info.mCurrentDownEvent.getY() - (int) secondDown.getY();
return (deltaX * deltaX + deltaY * deltaY < mDoubleTapSlopSquare);//最后判斷兩次單擊事件的距離
}
/**
* 將事件信息放入雙擊判斷隊(duì)列，并返回序號(hào)
*
* @param info
* @return
*/
private int addIntoTheMinIndex(EventInfo info) {
for (int i = 0; i < sEventForDoubleTap.size(); i++) {
if (sEventForDoubleTap.get(i) == null) {
sEventForDoubleTap.set(i, info);
return i;
}
}
sEventForDoubleTap.add(info);
return sEventForDoubleTap.size() - 1;
}
/**
* 從事件信息隊(duì)列中移除指定序號(hào)的事件
*
* @param idx
*/
private void removeEventFromList(int id) {
if (id > sEventInfos.size() || id < 0) {
// Log.e(MYTAG, CLASS_NAME + ".removeEventFromList(), id=" + id + ", while sEventInfos.size() =" + sEventInfos.size());
return;
}
sEventInfos.set(id, null);
}
/**
* 向事件隊(duì)列中添加新信息
*
* @param e
*/
private void addEventIntoList(EventInfo info) {
int id = info.mCurrentDownEvent.getId();
if (id < sEventInfos.size()) {
// if (sEventInfos.get(id) != null)
// Log.e(MYTAG, CLASS_NAME + ".addEventIntoList, info(" + id + ") has not set to null !");
sEventInfos.set(info.mCurrentDownEvent.getId(), info);
} else if (id == sEventInfos.size()) {
sEventInfos.add(info);
} else {
// Log.e(MYTAG, CLASS_NAME + ".addEventIntoList, invalidata id !");
}
}
public boolean onTouchEvent(MotionEvent ev) {
if (mVelocityTracker == null) {
mVelocityTracker = VelocityTracker.obtain();
}
mVelocityTracker.addMovement(ev);//把所有事件都添加到速度追蹤器，為計(jì)算速度做準(zhǔn)備
boolean handled = false;
final int action = ev.getAction(); //獲取Action
// int idx = (action & MotionEvent.ACTION_POINTER_INDEX_MASK) >> MotionEvent.ACTION_POINTER_INDEX_SHIFT;//獲取觸摸事件的序號(hào)
int idx = ev.getPointerId(ev.getActionIndex());//獲取觸摸事件的id
switch (action & MotionEvent.ACTION_MASK) {
case MotionEvent.ACTION_DOWN:
case MotionEvent.ACTION_POINTER_DOWN: {
EventInfo info = new EventInfo(MotionEvent.obtain(ev));
this.addEventIntoList(info);//將手勢(shì)信息保存到隊(duì)列中
if (mDoubleTapListener != null) {//如果雙擊監(jiān)聽器不為null
if (mHandler.hasMessages(TAP_DOUBLE)) {
MultiMotionEvent e = new MultiMotionEvent(ev);
EventInfo origInfo = checkForDoubleTap(e);//檢查是否構(gòu)成雙擊事件
if (origInfo != null) {
info.mIsDoubleTapping = true;
handled |= mDoubleTapListener.onDoubleTap(origInfo.mCurrentDownEvent);
handled |= mDoubleTapListener.onDoubleTapEvent(e);
}
}
if (!info.mIsDoubleTapping) {//當(dāng)前事件不構(gòu)成雙擊事件，那么發(fā)送延遲消息以判斷onSingleTapConfirmed事件
mHandler.sendMessageDelayed(mHandler.obtainMessage(TAP_SINGLE, idx), DOUBLE_TAP_TIMEOUT);
// Log.d(MYTAG, CLASS_NAME + ": add TAP_SINGLE");
}
}
// 記錄X坐標(biāo)和Y坐標(biāo)
info.mLastMotionX = info.mCurrentDownEvent.getX();
info.mLastMotionY = info.mCurrentDownEvent.getY();
if (mIsLongpressEnabled) {//允許長(zhǎng)按
mHandler.removeMessages(LONG_PRESS, idx);
mHandler.sendMessageAtTime(mHandler.obtainMessage(LONG_PRESS, idx), info.mCurrentDownEvent.getEventTime() + TAP_TIMEOUT
+ LONGPRESS_TIMEOUT);//延時(shí)消息以觸發(fā)長(zhǎng)按手勢(shì)
// Log.d(MYTAG, CLASS_NAME +
// ":add LONG_PRESS to handler for idx " + idx);
}
mHandler.sendMessageAtTime(mHandler.obtainMessage(SHOW_PRESS, idx), info.mCurrentDownEvent.getEventTime() + TAP_TIMEOUT);// 延時(shí)消息，觸發(fā)showPress手勢(shì)
handled |= mListener.onDown(info.mCurrentDownEvent);//觸發(fā)onDown（）
break;
}
case MotionEvent.ACTION_UP:
case MotionEvent.ACTION_POINTER_UP: {
MultiMotionEvent currentUpEvent = new MultiMotionEvent(ev);
if (idx >= sEventInfos.size()) {
// Log.e(MYTAG, CLASS_NAME + ":ACTION_POINTER_UP, idx=" + idx + ", while sEventInfos.size()=" + sEventInfos.size());
break;
}
EventInfo info = sEventInfos.get(currentUpEvent.getId());
if (info == null) {
// Log.e(MYTAG, CLASS_NAME + ":ACTION_POINTER_UP, idx=" + idx + ", Info = null");
break;
}
info.mStillDown = false;
if (info.mIsDoubleTapping) { //處于雙擊狀態(tài)，則觸發(fā)onDoubleTapEvent事件
handled |= mDoubleTapListener.onDoubleTapEvent(currentUpEvent);
} else if (info.mInLongPress) {//處于長(zhǎng)按狀態(tài)
mHandler.removeMessages(TAP_SINGLE, idx);//可以無視這行代碼
info.mInLongPress = false;
} else if (info.mAlwaysInTapRegion) {//尚未移動(dòng)過
if (mHandler.hasMessages(TAP_SINGLE, idx)) {//還在雙擊的時(shí)間閥值內(nèi)，所以要為雙擊判斷做額外處理
mHandler.removeMessages(TAP_SINGLE, idx);
info.mPreviousUpEvent = new MultiMotionEvent(MotionEvent.obtain(ev));
int index = this.addIntoTheMinIndex(info);// 把當(dāng)前事件放入隊(duì)列，等待雙擊的判斷
mHandler.sendMessageAtTime(mHandler.obtainMessage(TAP_DOUBLE, index), info.mCurrentDownEvent.getEventTime()
+ DOUBLE_TAP_TIMEOUT); // 將雙擊超時(shí)判斷添加到Handler
// Log.d(MYTAG, CLASS_NAME + ": add TAP_DOUBLE");
}
handled = mListener.onSingleTapUp(currentUpEvent);//觸發(fā)onSingleTapUp事件
} else {
// A fling must travel the minimum tap distance
final VelocityTracker velocityTracker = mVelocityTracker;
velocityTracker.computeCurrentVelocity(1000, mMaximumFlingVelocity);//計(jì)算1秒鐘內(nèi)的滑動(dòng)速度
//獲取X和Y方向的速度
final float velocityX = velocityTracker.getXVelocity(idx);
final float velocityY = velocityTracker.getYVelocity(idx);
// Log.i(MYTAG, CLASS_NAME + ":ACTION_POINTER_UP, idx=" + idx +
// ", vx=" + velocityX + ", vy=" + velocityY);
// 觸發(fā)滑動(dòng)事件
if ((Math.abs(velocityY) > mMinimumFlingVelocity) || (Math.abs(velocityX) > mMinimumFlingVelocity)) {
handled = mListener.onFling(info.mCurrentDownEvent, currentUpEvent, velocityX, velocityY);
}
}
// Hold the event we obtained above - listeners may have changed the
// original.
if (action == MotionEvent.ACTION_UP) { //釋放速度追蹤器
mVelocityTracker.recycle();
mVelocityTracker = null;
// Log.w(MYTAG, CLASS_NAME +
// ":ACTION_POINTER_UP, mVelocityTracker.recycle()");
}
info.mIsDoubleTapping = false;
// Log.d(MYTAG, CLASS_NAME + "remove LONG_PRESS");
// 移除showPress和長(zhǎng)按消息
mHandler.removeMessages(SHOW_PRESS, idx);
mHandler.removeMessages(LONG_PRESS, idx);
removeEventFromList(currentUpEvent.getId());//手指離開，則從隊(duì)列中刪除手勢(shì)信息
break;
}
case MotionEvent.ACTION_MOVE:
for (int rIdx = 0; rIdx < ev.getPointerCount(); rIdx++) {//因?yàn)闊o法確定當(dāng)前發(fā)生移動(dòng)的是哪個(gè)手指，所以遍歷處理所有手指
MultiMotionEvent e = new MultiMotionEvent(ev, rIdx);
if (e.getId() >= sEventInfos.size()) {
// Log.e(MYTAG, CLASS_NAME + ":ACTION_MOVE, idx=" + rIdx + ", while sEventInfos.size()=" + sEventInfos.size());
break;
}
EventInfo info = sEventInfos.get(e.getId());
if (info == null) {
// Log.e(MYTAG, CLASS_NAME + ":ACTION_MOVE, idx=" + rIdx + ", Info = null");
break;
}
if (info.mInLongPress) { //長(zhǎng)按，則不處理move事件
break;
}
//當(dāng)前坐標(biāo)
float x = e.getX();
float y = e.getY();
//距離上次事件移動(dòng)的位置
final float scrollX = x - info.mLastMotionX;
final float scrollY = y - info.mLastMotionY;
if (info.mIsDoubleTapping) {//雙擊事件
handled |= mDoubleTapListener.onDoubleTapEvent(e);
} else if (info.mAlwaysInTapRegion) {//該手勢(shì)尚未移動(dòng)過（移動(dòng)的距離小于mTouchSlopSquare,視為未移動(dòng)過）
// 計(jì)算從落下到當(dāng)前事件，移動(dòng)的距離
final int deltaX = (int) (x - info.mCurrentDownEvent.getX());
final int deltaY = (int) (y - info.mCurrentDownEvent.getY());
// Log.d(MYTAG, CLASS_NAME + "deltaX="+deltaX+";deltaY=" +
// deltaX +"mTouchSlopSquare=" + mTouchSlopSquare);
int distance = (deltaX * deltaX) + (deltaY * deltaY);
if (distance > mTouchSlopSquare) { // 移動(dòng)距離超過mTouchSlopSquare
handled = mListener.onScroll(info.mCurrentDownEvent, e, scrollX, scrollY);
info.mLastMotionX = e.getX();
info.mLastMotionY = e.getY();
info.mAlwaysInTapRegion = false;
// Log.d(MYTAG, CLASS_NAME +
// ":remove LONG_PRESS for idx" + rIdx +
// ",mTouchSlopSquare("+mTouchSlopSquare+"), distance("+distance+")");
// 清除onSingleTapConform，showPress,longPress三種消息
int id = e.getId();
mHandler.removeMessages(TAP_SINGLE, id);
mHandler.removeMessages(SHOW_PRESS, id);
mHandler.removeMessages(LONG_PRESS, id);
}
if (distance > mBiggerTouchSlopSquare) {//移動(dòng)距離大于mBiggerTouchSlopSquare，則無法構(gòu)成雙擊事件
info.mAlwaysInBiggerTapRegion = false;
}
} else if ((Math.abs(scrollX) >= 1) || (Math.abs(scrollY) >= 1)) {//之前已經(jīng)移動(dòng)過了
handled = mListener.onScroll(info.mCurrentDownEvent, e, scrollX, scrollY);
info.mLastMotionX = x;
info.mLastMotionY = y;
}
}
break;
case MotionEvent.ACTION_CANCEL:
cancel();//清理
}
return handled;
}
// 清理所有隊(duì)列
private void cancel() {
mHandler.removeMessages(SHOW_PRESS);
mHandler.removeMessages(LONG_PRESS);
mHandler.removeMessages(TAP_SINGLE);
mVelocityTracker.recycle();
mVelocityTracker = null;
sEventInfos.clear();
sEventForDoubleTap.clear();
}
}
版權(quán)申明：本站文章部分自網(wǎng)絡(luò)，如有侵權(quán)，請(qǐng)聯(lián)系：west999com@outlook.com
特別注意：本站所有轉(zhuǎn)載文章言論不代表本站觀點(diǎn)！
本站所提供的圖片等素材，版權(quán)歸原作者所有，如需使用，請(qǐng)與原作者聯(lián)系。
最新資訊
熱門推薦