編輯:關於Android編程
摘要
本文是手勢識別輸入事件處理的完整學習記錄。內容包括輸入事件InputEvent響應方式,觸摸事件MotionEvent的概念和使用,觸摸事件的動作分類、多點觸摸。根據案例和API分析了觸摸手勢Touch Gesture的識別處理的一般過程。介紹了相關的GestureDetector,Scroller和VelocityTracker。最後分析drag和scale等一些手勢的識別。
輸入源分類
雖然android本身是一個完整的系統,它主要運行在移動設備的特性決定了我們在它上面開的app絕大數屬於客戶端程序,主要目標就是顯示界面處理交互,這點和web前端以及桌面上的應用類似。
作為“客戶端程序”,編寫的大部分功能就是處理用戶交互。不同系統(對應不同設備)可支持的用戶交互各有不同。
android可以運行在多種設備,從交互輸入上看, InputDevice.SOURCE_CLASS_xxx
常量標識了sdk所支持的幾種不同輸入源的設備。有:觸屏,物理/虛擬按鍵,搖桿,鼠標等,下面的討論針對最廣泛的交互——觸屏( SOURCE_TOUCHSCREEN)。
觸屏設備從交互設計上看就是各種手勢,有點擊,雙擊,滑動,拖拽,縮放等等交互定義,本質上它們都是基礎的幾種觸摸事件的不同模式的組合。
在安卓觸屏系統中,支持單點、多點(點通常就是手指)觸摸,每個點有按下,移動和抬起。
觸屏交互的處理分不同觸屏操作——手勢的識別,然後是根據業務對應不同處理。為了響應不同的手勢,首先就需要識別它們。識別過程就是跟蹤收集系實時提供的反應用戶在屏幕上的動作的"基本事件",然後根據這些數據(事件集合)來判定出各種不同種類的高級別的“動作”。
android.view.GestureDetector提供了對onScroll、onLongPress、onFling等幾個最常見動作的監聽。而自己的app根據需要可以通過實現自己的GestureDetector類型來識別出類似Drag、Scale這樣的交互動作。
手勢識別是智能手機和平板等觸屏設備的主流交互/輸入方式,不同於PC上的鍵盤和鼠標。
輸入事件
用戶交互產生的輸入事件最終由InputEvent的子類來表示,目前包括KeyEvent(Object used to report key and button events)和MotionEvent(Object used to report movement (mouse, pen, finger, trackball) events.)。
接收InputEvent的地方有很多,根據框架對事件的傳播路徑依次有Activity、Window、View(ViewTree的一條路徑:view stack)。
多數情況下都是在用戶交互的具體View中接收並處理這些輸入事件。
View的事件處理有2種方式,一種是添加監聽器(event listener),另一種是重寫處理器方法( event handler)。前者比較方便,後者在自定義View時根據需要去重寫,而且CustomView也可以根據需要定義自己的處理器方法,或提供監聽接口。
事件監聽
事件監聽接口都是只包含一個方法的interface,如:
// 在View.java中 public interface OnTouchListener { boolean onTouch(View v, MotionEvent event); } public interface OnLongClickListener { boolean onLongClick(View v); } public interface OnClickListener { void onClick(View v); } public interface OnKeyListener { boolean onKey(View v, int keyCode, KeyEvent event); }
在Activity等地方通過創建匿名類或實現對應接口(省去新類型和對象的分配)然後調用View.setOn...Listener()來完成注冊監聽。
根據android的ui-events(輸入事件)的傳遞機制,監聽器的回調方法會先於各種相應的處理器方法被執行,對於那些有返回boolean值的回調方法,返回值表示是否讓事件繼續被傳播,所以應該根據需要謹慎設計返回值,否則會阻塞其它處理的執行。
例如,當為View設置OnTouchListener之後,若回調方法onTouch返回true,那麼在View的 boolean dispatchTouchEvent(MotionEvent event)
中執行了回調方法後,就不再執行View中的處理器方法 boolean onTouchEvent(MotionEvent event)
。
事件處理器
事件處理器就是在“事件傳遞”經過當前View時調用的默認方法。通常也就是對應具體View的行為邏輯的實現(要知道監聽器不是必須的,甚至可以不去定義,而任何View都會為感興趣的事件提供處理)。
有關消息傳遞的知識可以寫一整篇了,這裡略過,只需要知道,輸入事件會沿著ViewTree自頂向下穿過許多“相關的”View,然後這些View處理或繼續傳遞事件。事件到達ViewTree之前還會經過Activity和Window,最終的起源當然是系統負責收集的硬件事件,從“事件管理器”發送給交互中的界面相關的某個類,開始傳播。
View類中包括下面的事件處理方法:
onKeyDown(int, KeyEvent)
- Called when a new key event occurs.onKeyUp(int, KeyEvent)
- Called when a key up event occurs.onTrackballEvent(MotionEvent)
- Called when a trackball motion event occurs.onTouchEvent(MotionEvent)
- Called when a touch screen motion event occurs.onFocusChanged(boolean, int, Rect)
- Called when the view gains or loses focus.上面的處理器方法是站在事件傳播管道的當前節點來進行處理的,也就是處理只需要考慮當前View所提供的功能邏輯,並告知調用者是否已經處理結束——需要繼續傳遞?而對於ViewGroup類,它還承擔傳遞事件給childView的任務,下面的方法和事件傳遞密切相關:
Activity.dispatchTouchEvent(MotionEvent)
- This allows your Activity to intercept all touch events before they are dispatched to the window.ViewGroup.onInterceptTouchEvent(MotionEvent)
- This allows a ViewGroup to watch events as they are dispatched to child Views.ViewParent.requestDisallowInterceptTouchEvent(boolean)
- Call this upon a parent View to indicate that it should not intercept touch events with onInterceptTouchEvent(MotionEvent).了解在哪些地方可以接收事件,什麼時候去處理消耗事件是界面編程的一個重要方面,但“輸入事件的傳遞過程”是一個重要且夠復雜的話題,本篇文章重點是觸屏事件的各種手勢識別,相關的知識僅從“理解的完整和條理性”出發占據一定篇幅。
TouchMode
對於觸屏設備,用戶開始觸摸直到離開屏幕(press->lift)期間,界面會處於TouchMode的交互狀態。大致來看,所有的View都在響應觸摸事件或者其它的KeyEvent(按鍵,按鈕等)事件。兩者在交互上截然不同,觸摸模式的狀態維護貫穿了整個系統,包括所有的Window和Activity對象(主要就是觸摸事件的分發的控制),通過View類的 public boolean isInTouchMode ()
方法可以查看當前設備是否處在觸摸模式。
Gestures
用戶手指(一或多個)按下和最終完全離開屏幕的過程為一次觸屏操作,每次操作都可歸類為不同觸摸模式(touch pattern),最終被定義為不同的手勢(手勢和模式的定義是設計上的,用戶在使用任何觸屏設備後都會學習到不同的手勢),android支持的主要手勢有:
app需要根據系統提供的API來響應這些手勢。
手勢識別過程
為了實現對手勢的響應處理,需要理解觸摸事件的表示。而識別手勢的具體過程包括:
MotionEvent
觸摸動作觸發的輸入事件由MotionEvent表示,它實現了Parcelable接口——IPC需求。
目前的設備幾乎都支持多點觸摸,每個觸摸中的手指被當做一個poiner。MotionEvent記錄了目前所有處於觸摸的poiner,包含它們各自的X,Y坐標,壓力,接觸區域等信息。
每個手指的按下、移動和抬起都會產生一個事件對象。每個事件對應一個“動作”,由MotionEvent.ACTION_xxx的常量來表示:
每一個手指的down,move和up都會產生事件。出於性能考慮,因為移動過程會產生大量的ACTION_MOVE事件,它們被“批量”發送,也就是一個MotionEvent中將可以包含若干個實際的ACTION_MOVE事件數據,很顯然,這些事件都是MOVE動作,而且poiner數量是一樣的——任何poiner的加入和去除都引發DOWN、UP事件,這樣就不是連續的MOVE事件了。
相比上一個MotionEvent數據,當前MotionEvent的所有數據都是最新的。打包的數據根據時間形成數組,而最新的數據被作為current數據。可以通過 getHistorical
系列方法訪問“歷史事件”的數據。
下面是獲得當前MotionEvent中所有事件的各個poiner的坐標的標准形式:
void printSamples(MotionEvent ev) { final int historySize = ev.getHistorySize(); final int pointerCount = ev.getPointerCount(); for (int h = 0; h < historySize; h++) { System.out.printf("At time %d:", ev.getHistoricalEventTime(h)); for (int p = 0; p < pointerCount; p++) { System.out.printf(" pointer %d: (%f,%f)", ev.getPointerId(p), ev.getHistoricalX(p, h), ev.getHistoricalY(p, h)); } } System.out.printf("At time %d:", ev.getEventTime()); for (int p = 0; p < pointerCount; p++) { System.out.printf(" pointer %d: (%f,%f)", ev.getPointerId(p), ev.getX(p), ev.getY(p)); } }
前面提到了,事件具有動作分類,而且每個事件對象中包含所有pointer的相關數據。獲得action的方式是:
action = event.getAction() & MotionEvent.ACTION_MASK;
getAction和getActionMasked
getAction()返回的int數值內可能包含pointerIndex的信息(這裡應該是類似View.MeasureSpec那樣利用bit位來提升性能的做法):對應ACTION_POINTER_DOWN和ACTION_POINTER_UP動作,返回值包含了觸發UP、DOWN的“當前”pointer的index值,然後可以在方法 getPointerId(int), getX(int), getY(int), getPressure(int), and getSize(int)中作為pointerIndex參數使用。方法 getActionIndex()
就是用來獲取其中的pointerIndex。而 getActionMasked()
和上面語句的執行邏輯是一樣的——返回不包含pointerIndex的action常量值。對應只有一個手指的情況,顯然getAction()和getActionMasked()是一樣的,因為返回值本身也沒有額外的pointerIndex數據。獲得事件動作應該使用getActionMasked——更准確些。
獲得某個pointer的數據的方式也比較特殊,比如獲得各個pointer的X坐標:
final int pointerCount = ev.getPointerCount(); // p就是pointerIndex for (int p = 0; p < pointerCount; p++) { System.out.printf(" pointer %d: (%f,%f)", ev.getPointerId(p), ev.getX(p), ev.getY(p)); }
在一次手勢操作過程中,pointer的數量可能發生變化,每一個pointer在DOWN事件的時候就獲得一個關聯的id,可以作為它的有效標識,直至UP或CANCEL後(pointerCount變化)。
在單個的MotionEvent對象中, getPointerCount()
返回了處於觸摸的pointer的總數,0~getPointerCount()-1的值就是當前所有pointer的pointerIndex。方法 float getX(int pointerIndex)
接收index來獲得對應pointer的X坐標值。
類似的,其它接收pointerIndex參數的方法用以獲得pointer的其它屬性。如果需要關注某個手指的連續動作,比如第一個按下的手指,可以通過方法 int getPointerId(int pointerIndex)
獲得pointerIndex的id,記錄此id,然後在每個MotionEvent數據檢查時通過方法 int findPointerIndex(int pointerId)
得到id在當前MotionEvent數據中對應的pointerIndex,就可以訪問連續事件中指定id的pointer的屬性了。
最後,MotionEvent的以下方法是經常用到的:
long getEventTime()
獲得事件發生的時間。long getDownTime()
獲得本次觸摸事件序列的第一個——手指按下(ACTION_DOWN)的發生時間。int getAction()
、 int getActionMasked()
、 int getActionIndex()
、 int getPointerCount()
、 int getPointerId(int pointerIndex)
、 float getX()
、 float getX(int pointerIndex)
等。接收事件數據
手勢操作產生的一系列MotionEvent對象依次分發出去,傳遞並經過一些UI相關對象,一般的最終會經過對應的Activity和組成界面的那些和當前觸屏相關的View對象——沿著ViewTree從事件所在View向上的各個parent。
在當前界面的Activity中,可以通過重寫Activity的 boolean onTouchEvent(MotionEvent event)
方法來接收觸摸事件,更多時候,因為View是具體實現UI交互的地方,所以在View的 boolean onTouchEvent(MotionEvent event)
方法中接收事件。
一次觸摸操作會發送一系列事件,所以onTouchEvent會被“很多次”調用。
@Override public boolean onTouchEvent(MotionEvent event) { int action = event.getAction() & MotionEvent.ACTION_MASK; switch (action) { case MotionEvent.ACTION_DOWN: Log.d(TAG, "ACTION_DOWN"); return true; case MotionEvent.ACTION_POINTER_DOWN: Log.d(TAG, "ACTION_POINTER_DOWN"); return true; case MotionEvent.ACTION_MOVE: Log.d(TAG, "ACTION_MOVE"); return true; case MotionEvent.ACTION_UP: Log.d(TAG, "ACTION_UP"); return true; case MotionEvent.ACTION_POINTER_UP: Log.d(TAG, "ACTION_POINTER_UP"); return true; case MotionEvent.ACTION_CANCEL: Log.d(TAG, "ACTION_CANCEL"); return true; default: Log.d(TAG, "default: action = " + action); return super.onTouchEvent(event); } }
也可以通過設置監聽器來接收觸摸事件,這是針對具體的View對象進行的:
myView.setOnTouchListener(new OnTouchListener() { public boolean onTouch(View v, MotionEvent event) { // ... Respond to touch events return true; } });
需要注意的是,不論識別那種手勢操作,ACTION_DOWN動作一定需要返回true,否則按照調用約定,將認為當前處理忽略本次觸摸操作的事件序列,後續事件不會收到。
檢測手勢
在重寫的onTouch回調方法中根據收到的事件序列就可以判定出各種手勢。例如,一個ACTION_DOWN,緊接著是一系列的ACTION_MOVE,然後是ACTION_UP,這樣的序列通常就是scroll/drag手勢。總的說來,在實現識別手勢的邏輯時,需要“精心設計”代碼,往往需要考慮多少偏移才被當做有效滑動,多少時間間隙的down、up才算tap。 android.view.GestureDetector
提供了對最常見的手勢的識別。下面分別對手勢識別的關鍵相關類型做介紹。
GestureDetector
它的作用就是識別onScroll、onFling onDown(), onLongPress()等操作。將收到的MotionEvent序列傳遞給GestureDetector,之後它觸發對應不同手勢的回調方法。
使用過程為:
1.准備GestureDetector對象,提供響應各種手勢回調方法的監聽器。OnGestureListener就是對不同手勢的回調接口,很好理解。
// public GestureDetector(Context context, OnGestureListener listener); mDetector = new GestureDetector(this, mGestureListener);
在onTouch方法中將收到的事件傳遞給GestureDetector。
@Override public boolean onTouchEvent(MotionEvent event) { boolean handled = mDetector.onTouchEvent(event); return handled || super.onTouchEvent(event); }
如果只對GestureDetector的個別手勢的回調感興趣,監聽器可以繼承 GestureDetector.SimpleOnGestureListener
。在onDown方法中需要返回true,否則後續事件會被忽略。
手勢運動
手勢可以分為運動型和非運動型。比如tap(輕敲)就沒有移動,而scroll要求手指有一定的移動距離。手指是否發生運動的判定有一個臨界值:touch slop,可以通過android.view.ViewConfiguration#getScaledTouchSlop獲得,表示觸摸被判定為滑動的最小距離。
非運動型手勢,比如點擊類型的,識別的邏輯主要是對“時間間隙”的檢測。運動型手勢稍復雜些,對運動的判定根據實際功能需要可以獲得有關運動的不同方面:
VelocityTracker
有時對手勢運動過程中的速度感興趣,可以通過android.view.VelocityTracker來根據收集的事件數據計算得到運動時的速度:
public class MainActivity extends Activity { private static final String DEBUG_TAG = "Velocity"; ... private VelocityTracker mVelocityTracker = null; @Override public boolean onTouchEvent(MotionEvent event) { int index = event.getActionIndex(); int action = event.getActionMasked(); int pointerId = event.getPointerId(index); switch(action) { case MotionEvent.ACTION_DOWN: if(mVelocityTracker == null) { // Retrieve a new VelocityTracker object to watch the velocity of a motion. mVelocityTracker = VelocityTracker.obtain(); } else { // Reset the velocity tracker back to its initial state. mVelocityTracker.clear(); } // Add a user's movement to the tracker. mVelocityTracker.addMovement(event); break; case MotionEvent.ACTION_MOVE: mVelocityTracker.addMovement(event); // When you want to determine the velocity, call // computeCurrentVelocity(). Then call getXVelocity() // and getYVelocity() to retrieve the velocity for each pointer ID. mVelocityTracker.computeCurrentVelocity(1000); // Log velocity of pixels per second // Best practice to use VelocityTrackerCompat where possible. Log.d("", "X velocity: " + VelocityTrackerCompat.getXVelocity(mVelocityTracker, pointerId)); Log.d("", "Y velocity: " + VelocityTrackerCompat.getYVelocity(mVelocityTracker, pointerId)); break; case MotionEvent.ACTION_UP: case MotionEvent.ACTION_CANCEL: // Return a VelocityTracker object back to be re-used by others. mVelocityTracker.recycle(); break; } return true; } }
Scroller
不嚴謹的區分下,scroll可以分跟隨手指的滑動——drag,和手指劃過屏幕後的附加減速滑動——fling。
通常,需要對手勢運動進行響應,比如畫面跟隨手指的移動而移動(平移),簡單的實現就是在ACTION_MOVE中即時偏移對應的x,y,這種情況下對動作的“響應時機”是顯而易見的。另一些情況下,需要達到平滑的滑動效果,但每次執行滑動的時機和滑動的增量都需要計算。比如,點擊上一頁,下一頁按鈕後執行的滾動翻頁效果——類似ViewPager的動畫效果那樣。再一種情況是,手指快速劃過屏幕後,需要讓顯示的內容繼續滑動然後漸漸停止——fling效果。這些情況下,都需要在未來一段時間內,不斷調整畫面,達到滾動動畫效果——每次執行滑動的時機和偏移量都需要計算。可以借助Scroller來完成“smoothly move”這樣的動畫效果。
推薦使用android.widget.OverScroller,它兼容性好,且支持邊緣效果。和VelocityTracker一樣,Scroller是一個“計算工具”,它支持startScroll、fling兩個滑動效果,和上面的例子對應。從設計上,它獨立於滾動效果的執行,只提供對滾動動畫過程的計算和狀態判定。
Scroller的使用流程:
准備Scroller對象。
// 在構造函數,onCreate等合適的初始化的地方 mScroller = new OverScroller(context);
在合適的時候開啟滾動動畫。一般的,fling效果會結合GestureDetector,識別出手指的fling手勢後開啟滾動動畫:在OnGestureListener中的onFling中執行Scroller.fling()方法。
而Scroller.fling()所開啟的“平滑的滑動效果”可以在任何需要開啟滑動的時候執行。
mScroller.fling(startX, startY, velocityX, velocityY, minX, maxX, minY, maxY, overX, overY); mScroller.startScroll(startX, startY, dx, dy, duration);
在動畫的每一幀的執行時刻,計算滾動增量,應用到具體View對象。在自定義View時,可以依靠android.view.View#postOnAnimation,android.view.View#postInvalidateOnAnimation()方法簡單的觸發在下一動畫幀,以執行動畫操作。或者使用Animation等可以獲得動畫幀執行頻率的機制。View本身有computeScroll()方法可以供子類執行動畫式滾動邏輯——結合postInvalidateOnAnimation()。
boolean animEnd = false; if (mScroller.computeScrollOffset()) { int currX = mScroller.getCurrX(); int currY = mScroller.getCurrY(); // 修改Viewx,y位置,可以使用View的scroll方法 } else { animEnd = false; } if (!animEnd) { postInvalidateOnAnimation(); }
像ScrollView,HorizontalScrollView自身提供了滾動功能,ViewPager也使用Scroller完成平滑的滑動行為。一般在自定義帶滑動行為的控件時使用Scroller。框架的幾個控件使用EdgeEffect完成一些邊緣效果。
Multi-Touch
上面對MotionEvent的介紹中可以看到,每個處於觸摸的手指被當做一個pointer。目前大多數手機設備幾乎都是支持10點觸摸。
是否考慮多點觸摸是根據View的功能而定。比如scroll一般一個手指就可以,而scale這一的就必須2個手指以上了。
MotionEvent的getPointerId和findPointerIndex方法提供了對當前事件數據的每個pointer的標識,根據pointerIndex可以調用其它以它為參數的方法獲得對應pointer的不同方面的值。pointerId可以作為一個pointer觸屏期間的唯一標識。
private int mActivePointerId; public boolean onTouchEvent(MotionEvent event) { .... // Get the pointer ID mActivePointerId = event.getPointerId(0); // ... Many touch events later... // Use the pointer ID to find the index of the active pointer // and fetch its position int pointerIndex = event.findPointerIndex(mActivePointerId); // Get the pointer's current position float x = event.getX(pointerIndex); float y = event.getY(pointerIndex); }
對於單點觸摸,通常在onTouchEvent方法中根據getAction就可以判定出對應動作。而多點觸摸時需要使用getActionMasked方法。區別前面提到了,下面的代碼片段給出了有關多點觸摸的一般API:
int action = MotionEventCompat.getActionMasked(event); // Get the index of the pointer associated with the action. int index = MotionEventCompat.getActionIndex(event); int xPos = -1; int yPos = -1; Log.d(DEBUG_TAG,"The action is " + actionToString(action)); if (event.getPointerCount() > 1) { Log.d(DEBUG_TAG,"Multitouch event"); // The coordinates of the current screen contact, relative to // the responding View or Activity. xPos = (int)MotionEventCompat.getX(event, index); yPos = (int)MotionEventCompat.getY(event, index); } else { // Single touch event Log.d(DEBUG_TAG,"Single touch event"); xPos = (int)MotionEventCompat.getX(event, index); yPos = (int)MotionEventCompat.getY(event, index); } ... // Given an action int, returns a string description public static String actionToString(int action) { switch (action) { case MotionEvent.ACTION_DOWN: return "Down"; case MotionEvent.ACTION_MOVE: return "Move"; case MotionEvent.ACTION_POINTER_DOWN: return "Pointer Down"; case MotionEvent.ACTION_UP: return "Up"; case MotionEvent.ACTION_POINTER_UP: return "Pointer Up"; case MotionEvent.ACTION_OUTSIDE: return "Outside"; case MotionEvent.ACTION_CANCEL: return "Cancel"; } return ""; }
類MotionEventCompat提供了一些多點觸摸相關輔助方法,兼容版本。
ViewConfiguration
該類提供了一些UI相關的常量,關於超時時間,大小,和距離等。會根據系統的版本和運行的設備環境,如分辨率,尺寸等,提供統一的標准參考值,為UI元素提供一致的交互體驗。
ViewGroup管理TouchEvent
事件攔截
在非ViewGroup的View中響應觸摸事件的“職責”比較單一,就是根據當前View的交互需求識別然後執行交互邏輯。也就是只需要在android.view.View#onTouchEvent中處理觸摸產生的事件序列。
ViewGroup繼承View,所以它本身可以很據需要在onTouchEvent()中處理事件。另一方面,作為其它View的parent,它必須對childViews執行layout,並且有控制MotionEvent傳遞給目標childView的方法onInterceptTouchEvent()。注意ViewGroup本身可以處理事件,因為它同時也是合格的View子類。根據類的功能而不同,比如ViewPager會處理左右滑動的事件,但將上下滑動的事件傳遞給childView。要知到,ViewGroup可以包含View,也可以不包含。所以實際的事件有的是childView應該處理的,有的是“落在”ViewGroup本身區域內。
相關方法
有關事件分發的機制這裡只簡單提及,ViewGroup可以管理MotionEvent的傳遞。涉及到下面的方法:
boolean onInterceptTouchEvent(MotionEvent ev)
該方法用來攔截傳遞給目標childView(可以是ViewGroup,這裡不一定是事件的最終目標view,而是事件傳遞路徑經過當前ViewGroup後的下一個view)的MotionEvent事件,可以做些額外操作,甚至是阻止事件的傳遞自己處理。如果ViewGroup希望自己的onTouchEvent()處理手勢事件,可以重寫此方法並在onTouchEvent()中配合完成期望的手勢處理。
(1)、事件經過ViewGroup的順序
(2)、返回值
Return true to steal motion events from the children and have them dispatched to this ViewGroup through onTouchEvent(). The current target will receive an ACTION_CANCEL event, and no further messages will be delivered here.
注意:ViewGroup中onInterceptTouchEvent()和onTouchEvent()的合作對事件傳遞的影響主要體現在down事件的處理上,後續事件的傳遞受此影響。
boolean onTouchEvent(MotionEvent event)
ViewGroup繼承View的onTouchEvent(),沒有任何改變。
其返回值含義如下:
true表示事件被處理(消耗),這樣以後事件的傳遞終止。
false表示未處理,那麼會沿著事件傳遞的路徑依次返回parent中去處理——parent的onTouchEvent()被執行,直到某個parent的onTouchEvent()返回true。
void requestDisallowInterceptTouchEvent(boolean disallowIntercept)
該方法上由childView調用的。childView調用後並傳遞true時,會沿著ViewTree中root到目標View的view hierarchy一直向上依次通知各個parent去設置一個和觸摸相關的標記FLAG_DISALLOW_INTERCEPT,傳遞false或者一次觸摸操作結束後會清除此標記。
檔ViewGroup包含此標記時,其默認的行為是在通過方法boolean dispatchTouchEvent(MotionEvent ev)分發事件的時候會忽略調用onInterceptTouchEvent()去攔截事件。
拓展:Dragging和Scaling
Drag操作
android 3.0以上提供了api對拖拽進行支持,見 View.OnDragListener。下面自己處理onTouchEvent()方法來響應drag操作,移動目標View。
實現的重點是對移動距離的檢測,按照設計,從第一個手指觸摸目標View引發down操作開始,只要還有手指處於觸摸狀態,就檢測對應手指的移動來移動View。移動的距離是計算pointer的MOVE動作對應事件x,y坐標的距離。需要注意的是,必須是檢測同一個pointer,因為允許多點觸摸,那麼就需要記錄一個作為移動參考的pointer——定義為activePointer。規則是:第一個手指ACTION_DOWN時記錄對應pointerId作為activePointer,如果有手指離開就記錄剩余的某個pointer作為新的activePointer。
在ACTION_MOVE中獲得新的x,y和最後的(每次設置activePointer時記錄對應x,y作為最後的坐標)坐標進行對比,計算產生的距離就是移動距離。
// The ‘active pointer' is the one currently moving our object. private int mActivePointerId = INVALID_POINTER_ID; @Override public boolean onTouchEvent(MotionEvent ev) { // Let the ScaleGestureDetector inspect all events. mScaleDetector.onTouchEvent(ev); final int action = MotionEventCompat.getActionMasked(ev); switch (action) { case MotionEvent.ACTION_DOWN: { final int pointerIndex = MotionEventCompat.getActionIndex(ev); final float x = MotionEventCompat.getX(ev, pointerIndex); final float y = MotionEventCompat.getY(ev, pointerIndex); // Remember where we started (for dragging) mLastTouchX = x; mLastTouchY = y; // Save the ID of this pointer (for dragging) mActivePointerId = MotionEventCompat.getPointerId(ev, 0); break; } case MotionEvent.ACTION_MOVE: { // Find the index of the active pointer and fetch its position final int pointerIndex = MotionEventCompat.findPointerIndex(ev, mActivePointerId); final float x = MotionEventCompat.getX(ev, pointerIndex); final float y = MotionEventCompat.getY(ev, pointerIndex); // Calculate the distance moved final float dx = x - mLastTouchX; final float dy = y - mLastTouchY; mPosX += dx; mPosY += dy; invalidate(); // Remember this touch position for the next move event mLastTouchX = x; mLastTouchY = y; break; } case MotionEvent.ACTION_UP: { mActivePointerId = INVALID_POINTER_ID; break; } case MotionEvent.ACTION_CANCEL: { mActivePointerId = INVALID_POINTER_ID; break; } case MotionEvent.ACTION_POINTER_UP: { final int pointerIndex = MotionEventCompat.getActionIndex(ev); final int pointerId = MotionEventCompat.getPointerId(ev, pointerIndex); if (pointerId == mActivePointerId) { // This was our active pointer going up. Choose a new // active pointer and adjust accordingly. final int newPointerIndex = pointerIndex == 0 ? 1 : 0; mLastTouchX = MotionEventCompat.getX(ev, newPointerIndex); mLastTouchY = MotionEventCompat.getY(ev, newPointerIndex); mActivePointerId = MotionEventCompat.getPointerId(ev, newPointerIndex); } break; } } return true; }
上面的方法分別在ACTION_DOWN和ACTION_POINTER_UP中設置mActivePointerId,以及上一次的觸摸位置。在ACTION_MOVE中記錄移動到的位置,以及更新最後的觸摸位置。最後,在UP、CANCEL中清除記錄的pointerId。
可見,drag手勢的識別重點就是記錄作為移動參考的pointerId,它必須是連續的。
對於drag操作的識別和響應,可以直接使用GestureDetector響應其中的onScroll()方法即可。
scroll,drag和pan這些都是一樣的手勢/操作。
Scale
可以使用ScaleGestureDetector來檢測縮放動作。下面的例子是drag和scale一起識別的代碼范例,注意其識別操作對事件的消耗順序:
private ScaleGestureDetector mScaleDetector; private GestureDetector mGestureDetector; private float mScaleFactor = 1.f; public MyCustomView(Context mContext){ ... mScaleDetector = new ScaleGestureDetector(context, new ScaleListener()); } ... public boolean onTouchEvent(MotionEvent event) { boolean retVal = mScaleGestureDetector.onTouchEvent(event); retVal = mGestureDetector.onTouchEvent(event) || retVal; return retVal || super.onTouchEvent(event); } private class ScaleListener extends ScaleGestureDetector.SimpleOnScaleGestureListener { @Override public boolean onScale(ScaleGestureDetector detector) { mScaleFactor *= detector.getScaleFactor(); // 控制縮放的最大值 mScaleFactor = Math.max(0.1f, Math.min(mScaleFactor, 5.0f)); // 縮放系數變化後通知View重繪 invalidate(); return true; } }
關於GestureDetector的用法前面給出了,上面代碼片段只展示ScaleGestureDetector、ScaleGestureDetector.SimpleOnScaleGestureListener的一般用法。
注意onTouchEvent()中先執行ScaleGestureDetector的事件檢測,然後是GestureDetector的,只要兩次識別都未處理時,才調用父類的默認行為。
小結
理解手勢識別的整體過程是在onTouchEvent中根據MotionEvent事件序列來匹配不同的模式是整片文章的目標。要知道,GestureDetector和ScaleGestureDetector這些框架提供的類型都是方便大家在自定義View時的手勢識別功能的實現。只要掌握手勢識別的思路,可以自己識別任何期望的觸摸事件模式。不過,研究框架GestureDetector的源碼,以及一些開源的控件中對手勢操作的處理是一個很好的開始。
資料
官方文檔
文章主要內容參考來自api 22的開發文檔。
Using Touch Gestures
文件路徑:/docs/training/gestures/detector.html
Input Events
文件路徑:/docs/guide/topics/ui/ui-events.htm
案例:PhotoView
在自定義View時根據需要會出現監聽特殊的手勢的需要,這個時候就需要定義自己的GestureDetector類型了。研究系統的GestureDetector類的實現非常有幫助,如果需要識別多種手勢時,根據實際的特征,可以設計多個Detector類型,用來識別不同手勢,但需要注意在使用它們時對事件的消耗順序,比如drag和scale手勢的先後識別。
開源項目PhotoView用來展示圖片並支持各種手勢對圖片進行縮放,平移等操作。它裡面包含了幾個手勢識別的類,建議可以閱讀它的代碼來作為對手勢識別的“實現細節”的實踐。
源碼下載:項目下載
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持本站。
1、為什麼要有AIDL? 無論學什麼東西,最先得弄明白為什麼要有這個東西,不要說存在即是合理,存在肯定合理,但是你還是沒有明白。對於AIDL有一些人的淺顯概念就是,AID
你應該有過手機解鎖密碼忘記的經歷吧,一開始對圖案解鎖十分好奇,設置了一個比較復雜的圖案,只是沒有過多久就忘記了,只能通過刷機解決了,還好本文的出現將會幫助一
一、問題描述 今天使用SDK Manager將Android SDK的版本更新到了Android 5.1的版本,eclipse創建android項目時,預覽activi
以前的Android(4.1之前的版本)中,SDcard路徑通過“/sdcard”或者“/mnt/sdcard”來表示,而在JellyBean(安卓4.1)系統中修改為了