觸摸事件流
Down --> Move --> Move --> Up
Down --> Pointer_Down --> Move --> Move --> Pointer_Up --> Up
事件分發流程圖
源碼註釋
ViewGroup.java
@Override
public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) {
if (disallowIntercept == ((mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0)) {
// 我們已經處於這種狀態,假設我們的父View也是如此
return;
}
if (disallowIntercept) {
mGroupFlags |= FLAG_DISALLOW_INTERCEPT;
} else {
mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT;
}
// 把它傳遞給我們的父View
if (mParent != null) {
mParent.requestDisallowInterceptTouchEvent(disallowIntercept);
}
}
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
}
//如果事件以無障礙焦點的View爲目標,並且此View就是那個無障礙焦點View則開始
//正常事件分發。
if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) {
ev.setTargetAccessibilityFocus(false);
}
boolean handled = false;
if (onFilterTouchEventForSecurity(ev)) {
final int action = ev.getAction();
final int actionMasked = action & MotionEvent.ACTION_MASK;
// 處理初始的ACTION_DOWN
if (actionMasked == MotionEvent.ACTION_DOWN) {
//開始新的觸摸手勢時,丟棄(重置)所有先前的狀態。
//框架可能已經丟棄了上一個手勢的up或cancel事件
//由於應用程序切換,ANR或其他一些狀態更改。
cancelAndClearTouchTargets(ev);
resetTouchState();
}
// 檢查該ViewGroup是否攔截觸摸事件
final boolean intercepted;
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {//當觸摸事件的Action爲ACTION_DOWN,或者mFirstTouchTarget != null(表示子View已經消費了Down事件成爲TouchTarget,這個是後續發送給子View的觸摸事件(例如Move,Up))
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
if (!disallowIntercept) {// 允許此ViewGroup攔截
// Down事件和發送給TouchTarget的事件都會在這裏檢測是否攔截
intercepted = onInterceptTouchEvent(ev);
// 恢復Action以防止被更改
ev.setAction(action);
} else {
// 不允許此ViewGroup攔截
intercepted = false;
}
} else {
// 進入這裏表明了是Down之後的事件,而TouchTarget爲Null,說明子View沒有消費之前的Down事件,而是被
// 該ViewGroup攔截消費了。所以後續事件繼續被該ViewGroup消費,設置intercepted=true就可以讓該ViewGroup的onTouchEvent處理該事件
intercepted = true;
}
//如果該ViewGroup攔截事件,則啓動正常事件分發。 同樣如果已經存在的一個
//正在處理手勢的子View,執行正常的事件分發。
if (intercepted || mFirstTouchTarget != null) {
ev.setTargetAccessibilityFocus(false);
}
// 檢查 canceled
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
// 如果需要,更新pointer down的觸摸目標列表。
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
if (!canceled && !intercepted) {
//如果事件的目標是無障礙焦點,如果不處理它,我們會將其提供給
//具有無障礙焦點的View。
//我們清除標誌並像往常一樣將事件發送給所有子View。
//我們正在查找無障礙焦點宿主以避免保留
//狀態,因爲這些事件非常罕見。
View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
? findChildWithAccessibilityFocus() : null;
if (actionMasked == MotionEvent.ACTION_DOWN
|| (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
final int actionIndex = ev.getActionIndex(); // 0總是表示Down
final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
: TouchTarget.ALL_POINTER_IDS;
//清除此指針ID的早期觸摸目標,以防變得不同步了。
removePointersFromTouchTargets(idBitsToAssign);
final int childrenCount = mChildrenCount;
if (newTouchTarget == null && childrenCount != 0) {
final float x = ev.getX(actionIndex);
final float y = ev.getY(actionIndex);
//找到可以接收事件的子View。
//從前到後掃描子View。
final ArrayList<View> preorderedList = buildTouchDispatchChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
for (int i = childrenCount - 1; i >= 0; i--) {
final int childIndex = getAndVerifyPreorderedIndex(
childrenCount, i, customOrder);
final View child = getAndVerifyPreorderedView(
preorderedList, children, childIndex);
//如果有一個具有無障礙焦點的View,我們需要它
//首先獲取事件並且如果沒有處理該事件,我們將執行
//正常分發。
if (childWithAccessibilityFocus != null) {
if (childWithAccessibilityFocus != child) {
continue;
}
childWithAccessibilityFocus = null;
i = childrenCount - 1;
}
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
ev.setTargetAccessibilityFocus(false);
continue;
}
newTouchTarget = getTouchTarget(child);
if (newTouchTarget != null) {
//子View已經在其範圍內接受了觸摸。
//除了正在處理的觸摸點之外,還給它新的觸摸點(多點觸控)。
newTouchTarget.pointerIdBits |= idBitsToAssign;
break;
}
resetCancelNextUpFlag(child);
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
// 子View想在它的範圍內接收觸摸事件
mLastTouchDownTime = ev.getDownTime();
if (preorderedList != null) {
// childIndex指向預先排序列表,找到原始索引
for (int j = 0; j < childrenCount; j++) {
if (children[childIndex] == mChildren[j]) {
mLastTouchDownIndex = j;
break;
}
}
} else {
mLastTouchDownIndex = childIndex;
}
mLastTouchDownX = ev.getX();
mLastTouchDownY = ev.getY();
newTouchTarget = addTouchTarget(child, idBitsToAssign);
alreadyDispatchedToNewTouchTarget = true;
break;
}
// 無障礙焦點不處理這個事件,因此清除標誌並且對所有的子View進行的正常事件分發
ev.setTargetAccessibilityFocus(false);
}
if (preorderedList != null) preorderedList.clear();
}
if (newTouchTarget == null && mFirstTouchTarget != null) {
//沒有找到子View來接收這個事件。
//將指針分配給最近添加的目標。
newTouchTarget = mFirstTouchTarget;
while (newTouchTarget.next != null) {
newTouchTarget = newTouchTarget.next;
}
newTouchTarget.pointerIdBits |= idBitsToAssign;
}
}
}
// 分發事件到觸摸目標
if (mFirstTouchTarget == null) {
// 沒有觸摸目標,因此將此ViewGroup作爲普通View對待.
handled = dispatchTransformedTouchEvent(ev, canceled, null,
TouchTarget.ALL_POINTER_IDS);
} else {
//發送到觸摸目標。如果我們已經發送到這個新的觸摸目標,則排除。必要時取消觸摸目標。
TouchTarget predecessor = null;
TouchTarget target = mFirstTouchTarget;
while (target != null) {
final TouchTarget next = target.next;
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
final boolean cancelChild = resetCancelNextUpFlag(target.child)
|| intercepted;
if (dispatchTransformedTouchEvent(ev, cancelChild,
target.child, target.pointerIdBits)) {
handled = true;
}
if (cancelChild) {
if (prtargetedecessor == null) {
mFirstTouchTarget = next;
} else {
predecessor.next = next;
}
target.recycle();
target = next;
continue;
}
}
predecessor = target;
target = next;
}
}
// 如果需要,更新指針up或cancel的觸摸目標列表。
if (canceled
|| actionMasked == MotionEvent.ACTION_UP
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
resetTouchState();
} else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) {
final int actionIndex = ev.getActionIndex();
final int idBitsToRemove = 1 << ev.getPointerId(actionIndex);
removePointersFromTouchTargets(idBitsToRemove);
}
}
if (!handled && mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onUnhandledEvent(ev, 1);
}
return handled;
}
/**
* 將動作事件(MotionEvent)轉換到特定子View的座標空間,
* 過濾掉不相關的指針(每個手指對應一個指針)ID,並在必要時覆蓋其操作。
* 如果child爲null,則假定MotionEvent將發送給ViewGroup本身。
*/
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
View child, int desiredPointerIdBits) {
final boolean handled;
//取消手勢(MotionEvent.ACTION_CANCEL)是一種特殊情況。 我們不需要執行任何轉換
//或過濾。 重要的是動作,而不是內容。
final int oldAction = event.getAction();
if (cancel || oldAction == MotionEvent.ACTION_CANCEL) {
event.setAction(MotionEvent.ACTION_CANCEL);
if (child == null) {
handled = super.dispatchTouchEvent(event);
} else {
handled = child.dispatchTouchEvent(event);
}
event.setAction(oldAction);
return handled;
}
// 計算要傳遞的指針數。
final int oldPointerIdBits = event.getPointerIdBits();
final int newPointerIdBits = oldPointerIdBits & desiredPointerIdBits;
//如果出於某種原因,我們最終處於一個不一致的狀態,看起來
//我們可能產生了一個沒有指針的動作事件。當出現這種情況時,我們就丟棄該事件。
// If for some reason we ended up in an inconsistent state where it looks like we
// might produce a motion event with no pointers in it, then drop the event.
if (newPointerIdBits == 0) {
return false;
}
//如果指針的數量相同,並且我們不需要執行任何
//不可逆的轉換操作,這時,我們可以重複使用該動作事件進行分發,
//只要我們小心地還原我們所做的任何更改即可。
//否則,我們就需要拷貝一份該動作事件。
final MotionEvent transformedEvent;
if (newPointerIdBits == oldPointerIdBits) {
//child爲null,或者child的轉換矩陣是單位矩陣。執行完就直接返回了
if (child == null || child.hasIdentityMatrix()) {
if (child == null) {
handled = super.dispatchTouchEvent(event);
} else {
final float offsetX = mScrollX - child.mLeft;
final float offsetY = mScrollY - child.mTop;
event.offsetLocation(offsetX, offsetY);
handled = child.dispatchTouchEvent(event);//這裏有兩種,一種是View的,另一種是ViewGroup的
event.offsetLocation(-offsetX, -offsetY);
}
return handled;
}
//拷貝動作事件
transformedEvent = MotionEvent.obtain(event);
} else {
transformedEvent = event.split(newPointerIdBits);
}
// 執行任何必要的轉換和分發.
if (child == null) {
//因爲子View爲null,所以直接分發給自己。super.dispatchTouchEvent對應的是View
//的dispatchTouchEvent方法
handled = super.dispatchTouchEvent(transformedEvent);
} else {
final float offsetX = mScrollX - child.mLeft;
final float offsetY = mScrollY - child.mTop;
transformedEvent.offsetLocation(offsetX, offsetY);
if (! child.hasIdentityMatrix()) {//child的轉換矩陣不是單位矩陣
//通過反向矩陣恢復動作事件
transformedEvent.transform(child.getInverseMatrix());
}
handled = child.dispatchTouchEvent(transformedEvent);
}
// 完畢.
transformedEvent.recycle();
return handled;
}
View.java
/**
*將觸摸屏動作事件向下傳遞到目標View,或當此View是目標時,傳遞到此View
* @param event 要調度的動作事件。
* @return 如果事件由此View處理,則爲True,否則爲false。
*/
public boolean dispatchTouchEvent(MotionEvent event) {
// 如果事件應首先由可訪問性焦點處理
if (event.isTargetAccessibilityFocus()) {
// 我們沒有焦點或沒有虛擬後代擁有它,不處理這個事件。
if (!isAccessibilityFocusedViewOrHost()) {
return false;
}
// 我們有焦點並得到了事件,然後使用正常的事件分發
event.setTargetAccessibilityFocus(false);
}
boolean result = false;
// 如果有用於調試目的的一致性驗證對象
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(event, 0);
}
// 獲取動作的int值
final int actionMasked = event.getActionMasked();
// 如果動作是按下
if (actionMasked == MotionEvent.ACTION_DOWN) {
// 新手勢的防禦性清理。停止正在進行的嵌套滾動
stopNestedScroll();
}
//過濾觸摸事件以應用安全策略。True表示應該被分發,False表示應該丟棄
if (onFilterTouchEventForSecurity(event)) {
if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) {
result = true;
}
ListenerInfo li = mListenerInfo;
if (li != null && li.mOnTouchListener != null
// 如果這個View沒有調用setEnabled(false),這裏應該是相等的
&& (mViewFlags & ENABLED_MASK) == ENABLED
//如果調用了setOnTouchListener(),這裏就會回調該Listener
&& li.mOnTouchListener.onTouch(this, event)) {
result = true;//說明OnTouchListener.onTouch方法消費了觸摸事件
}
//如果事件沒有被onTouch方法消費,則傳遞給View的onTouchEvent方法
if (!result && onTouchEvent(event)) {
result = true;
}
}
// 如果事件沒有被消費,並且有用於調試目的的一致性驗證對象
if (!result && mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
}
//如果這是手勢的結束,則在嵌套滾動後清理;
//如果我們已經查驗了ACTION_DOWN,但我們不想要其餘的
//手勢,我們也取消
if (actionMasked == MotionEvent.ACTION_UP ||
actionMasked == MotionEvent.ACTION_CANCEL ||
(actionMasked == MotionEvent.ACTION_DOWN && !result)) {
//停止嵌套滾動
stopNestedScroll();
}
return result;
}
/**
* 過濾觸摸事件以應用安全策略
*
* @param event 要被過濾的觸摸事件
* @return True 如果觸摸事件應該被分發, false 如果觸摸事件應該被丟棄.
*
* @see #getFilterTouchesWhenObscured
*/
public boolean onFilterTouchEventForSecurity(MotionEvent event) {
//FILTER_TOUCHES_WHEN_OBSCURED 表示View應在其窗口被遮擋時過濾觸摸事件。
if ((mViewFlags & FILTER_TOUCHES_WHEN_OBSCURED) != 0
//FLAG_WINDOW_IS_OBSCURED
// 該標誌表示接收到該觸摸事件的窗口被其上方的另一個可見窗口部分或全部遮擋。
// 即使事件沒有直接通過遮擋區域,該標誌也設置爲true。 對安全敏感的應用程序可以檢查此標誌,
// 以識別惡意應用程序可能已覆蓋其部分內容的情況,以便誤導用戶或劫持觸摸。
// 適當的迴應可能是放棄可疑的觸摸或採取額外的預防措施來確認用戶的實際意圖。
&& (event.getFlags() & MotionEvent.FLAG_WINDOW_IS_OBSCURED) != 0) {
// Window 被遮擋, 丟棄這個觸摸事件.
return false;
}
return true;
}
Activity.java
/**
* Called to process touch screen events. You can override this to
* intercept all touch screen events before they are dispatched to the
* window. Be sure to call this implementation for touch screen events
* that should be handled normally.
*
* @param ev The touch screen event.
*
* @return boolean Return true if this event was consumed.
*/
public boolean dispatchTouchEvent(MotionEvent ev) {
if (ev.getAction() == MotionEvent.ACTION_DOWN) {
onUserInteraction();
}
if (getWindow().superDispatchTouchEvent(ev)) {//View的事件分發從這裏開始。 ViewGroup --> ... --> View
return true;
}
return onTouchEvent(ev);//如果沒有View消費該Touch事件,則分發到Activity的onTouchEvent方法
}
getAction() 返回 pointer id 和 action (例如: up, down, move)
getActionMasked() 只返回action (例如: up, down, move)
小結:
- 完整的事件流是怎麼樣的?
一個完整的事件流的都是從Down開始,然後到Cancel/Up結束,中間會經歷數個Move事件。 - 如果沒有View去消費Down事件,接下來的其它事件會怎麼樣?
如果子View沒有消費Down事件,則會調用父ViewGroup的onTouchEvent來處理該事件,如果該ViewGroup也沒有消費,就會調用該ViewGroup的父ViewGroup來處理該事件。如此往復循環一直到最頂層的DecorView。接下來的Move,Up之類的事件將全部被DecorView攔截消費。一直持續到下一次的Down事件 - 如何解決事件衝突?
首先肯定需要有一個判斷邏輯來確定應該由父ViewGroup消費Touch事件,還是由子View消費Touch事件。那如何進行切換呢?通過上面的分發流程圖我們知道,如果父ViewGroup攔截了Down事件,那子View直到下一個Down事件之前就再也接收不到其它Touch事件。因此,Down事件父ViewGroup肯定是不能攔截的。那子View接收並消費Down事件後,其餘的事件還是一層層傳遞到該子View,所以必然會經過父ViewGroup,而這個時候就會經過onInterceptTouchEvent
,當該方法返回true的時候,父View就會攔截後續事件,直到Up事件。攔截的事件都會傳遞到父ViewGroup的onTouchEvent
。
解決事件衝突的辦法,就是在父ViewGrouponInterceptTouchEvent
編寫判斷邏輯,通過返回true來攔截。具體的實踐講解可以參考這篇文章:一文解決Android View滑動衝突