图解Android:Touch事件传递机制

前言

Android事件管理机制是一名专业Android研发工程师必须要了解的核心知识之一,深入了解一下该机制无论对我们日常开发还是找工作,乃至于对我们的架构思想都有很大的帮助。Android中我们用到的最多的事件是InputEvent,主要是两类:MotionEvent和KeyEvent。由于事件传递模型基本一致,我将以更常用到的MotionEvent为目标来讲解。

根据实际开发的需要,本文仅讲解touch事件在viewTree中的传递机制,为广大开发者搞清原理、扫清障碍。文章参考了Kelin童鞋的图解Android事件传递机制,写的很好大家也可以去看看。

本篇是图解Android系列第一篇,更多文章敬请关注后续文章。如果这篇文章对大家学习Android有帮助,还望大家多多转载。学习小组QQ群: 193765960。

版权归作者所有,如有转发,请注明文章出处:https://xiaodanchen.github.io/archives/


Touch事件的分发、传递、消费所涉及的类与函数

老规矩,让我们先来看一张类图:


Touch事件相关回调接口图谱
  • View类定义了两个Touch事件传递分发的函数:
    • public boolean dispatchTouchEvent(MotionEvent event)
    • public boolean onTouchEvent(MotionEvent event)
  • ViewGroup继承自View类,其重写了定义了两个 Touch事件传递分发的函数
    • @Override public boolean dispatchTouchEvent(MotionEvent ev)
    • public boolean onInterceptTouchEvent(MotionEvent ev)
  • Activity类定义了两个Touch事件传递分发的函数:
    • public boolean dispatchTouchEvent(MotionEvent event)
    • public boolean onTouchEvent(MotionEvent event)
  • Activity类的viewRoot实际上是PhoneWindow的DecorView(ViewGroup)
    • DecorView维护了一个LinearLayout对象,这个对象包括两部分:TitleView和ContentViews(FrameLayout)
    • 我们定义的layout.xml其实是被加载到TitleView和ContentViews中的

Touch事件在Activity的viewTree中的传递分发,如图

Touch事件在Activity的viewTree中的传递分发
  • 箭头的上面字代表方法返回值:return true、return false、return super.xxxxx(),super 的意思是调用父类实现。
  • dispatchTouchEvent和 onTouchEvent的框里有个[true---->消费]的字,表示的意思是如果方法返回true,那么代表事件就此消费,不会继续往别的地方传了,事件终止。
  • 目前所有的图的事件是针对ACTION_DOWN的,对于ACTION_MOVE和ACTION_UP我们最后做分析。

事件分发入口:Activity类的dispatchTouchEvent()方法

    /**
     * 处理屏幕触摸事件。该方法是activity事件传递的入口。
     * 你可以通过override这个方法来拦截所有touch事件使不传递给viewTree。
     * 
     * @return 如果事件最终被消费将会返回 true.
     */
    public boolean dispatchTouchEvent(MotionEvent ev) {
        if (ev.getAction() == MotionEvent.ACTION_DOWN) {
            onUserInteraction();
        }
        //将事件分发给viewTree:以DecorView为RootView的viewTree
        //DecorView为ViewGroup
        if (getWindow().superDispatchTouchEvent(ev)) {
            //viewTree存在元素消费了该事件,返回true
            return true;
        }‘
        
        //viewTree不存在元素消费了该事件,调用activity的onTouchEvent(ev)
        return onTouchEvent(ev);
    }
     
     /**
     * 当activity中没有任何view可以消费该事件时将会调用该方法. 
     * 该方法常用来处理发生在activity的window边界之外的触摸事件。
     * (联想:Dialog类型的activity点击外侧弹框消失应该是这货起的作用吧?)
     * 
     * @return 如果你需要消费touch事件,返回true,否则返回false
     * 默认是返回false的
     */
    public boolean onTouchEvent(MotionEvent event) {
        if (mWindow.shouldCloseOnTouch(this, event)) {
            finish();
            return true;
        }
 
        return false;
    }

ViewGroup 中touch事件是如何传递的

ViewGroup的dispatchTouchEvent()方法

     /**
     * ViewGroup.java
     */
    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        
        ...//次要代码,在此省略
 
        boolean handled = false;
        if (onFilterTouchEventForSecurity(ev)) {
         
            ...//次要代码,在此省略
            
             //标志是否拦截事件
            final boolean intercepted;
            if (actionMasked == MotionEvent.ACTION_DOWN
                    || mFirstTouchTarget != null) {
                ...
                if (!disallowIntercept) {
                    //当前ViewGroup是否需要拦截该事件
                    intercepted = onInterceptTouchEvent(ev);
                    ev.setAction(action); 
                } else {
                    intercepted = false;
                }
            } else {
                intercepted = true;
            }
            
            ...
            TouchTarget newTouchTarget = null;
            boolean alreadyDispatchedToNewTouchTarget = false;
            //如果当前ViewGroup不拦截该事件,则继续向叶子节点分发该事件
            if (!canceled && !intercepted) {
                ...
                if (actionMasked == MotionEvent.ACTION_DOWN) {
                    ...
                    //叶子节点的数量
                    final int childrenCount = mChildrenCount;
                    if (newTouchTarget == null && childrenCount != 0) {
                        final float x = ev.getX(actionIndex);
                        final float y = ev.getY(actionIndex);
                        ...
                        //根据Z-order得到拍好序的children
                        final ArrayList<View> preorderedList = buildOrderedChildList();
                        ...
                        //找到一个能接受Event的子View,再对子View的View树进行遍历
                        final View[] children = mChildren;
                        //遍历叶子节点
                        for (int i = childrenCount - 1; i >= 0; i--) {
                            ...
                            final View child = (preorderedList == null)
                                    ? children[childIndex] : preorderedList.get(childIndex);
                            ...
                            //当前叶子view不能接收该touch事件,或者该叶子view不在触摸事件的触摸区域内,则查看下一个叶子
                            if (!canViewReceivePointerEvents(child)
                                    || !isTransformedTouchPointInView(x, y, child, null)) {
                                ev.setTargetAccessibilityFocus(false);
                                //跳出本次循环,遍历下一个叶子
                                continue;
                            }
                          
                            //找到了可以接收该事件并处于触摸区域内的叶子view: child
                            
                            newTouchTarget = getTouchTarget(child);
                            //child已经存在target链表中
                            if (newTouchTarget != null) {
                                // 如果touch事件之前已经被该child消费,则后续touch事件不会继续向下层viewtree分发
                                break;
                            }
                            //将事件分发给该叶子的viewTree
                            if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
                                //叶子dispatch最终返回true
                                ...
                                //将child加入到target链表中
                                newTouchTarget = addTouchTarget(child, idBitsToAssign);
                                alreadyDispatchedToNewTouchTarget = true;
                                //终止遍历
                                break;
                            }
                            //设置标志:当前遍历没有找到可消费事件的view,事件可继续正常分发
                            ev.setTargetAccessibilityFocus(false);
                        }
                    }
                }
            }

            // 找不到可以消费该事件的view
            if (mFirstTouchTarget == null) { 
                //继续事件传递流程
                handled = dispatchTransformedTouchEvent(ev, canceled, null,
                        TouchTarget.ALL_POINTER_IDS);
            } else {
                
                TouchTarget predecessor = null;
                TouchTarget target = mFirstTouchTarget;
                //找到可以消费该事件的view
                while (target != null) {
                    final TouchTarget next = target.next;
                    //之前已经分发同类事件给了view
                    if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
                        //返回true
                        handled = true;
                    } else {
                        final boolean cancelChild = resetCancelNextUpFlag(target.child)
                                || intercepted;
                         //将事件分发给他
                        if (dispatchTransformedTouchEvent(ev, cancelChild,
                                target.child, target.pointerIdBits)) {
                          //返回true  
                          handled = true;
                        }
                    }
                }
            }
        }
        //返回ViewTree的事件传递消费结果:true 事件被消费;false 事件没有被消费
        return handled;
    }

ViewGroup的dispatchTransformedTouchEvent()方法

    /**
     * 将touch事件根据view的坐标系进行变换,
     * 如果view==null,则将事件传递给viewgroup继续分发事件
     */
    private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
            View child, int desiredPointerIdBits) {
        final boolean handled;

        //cacel事件
        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);
            //cacel事件不需要转换,处理后在此返回处理结果
            return handled;
        }

        ...
        final MotionEvent transformedEvent;
        if (newPointerIdBits == oldPointerIdBits) {
            //child不可以消费该事件,继续分发
            if (child == null || child.hasIdentityMatrix()) {
                if (child == null) {
                    //不存在可以消费该事件的child,父节点继续事件分发
                    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);

                    event.offsetLocation(-offsetX, -offsetY);
                }
                //返回分发结果
                return handled;
            }
            //child可以消费该事件
            transformedEvent = MotionEvent.obtain(event);
        } else {
            //手指点数变化
            transformedEvent = event.split(newPointerIdBits);
        }

        if (child == null) {
            // 手指点数变化后,child无法对事件消费,则父节点继续分发
            handled = super.dispatchTouchEvent(transformedEvent);
        } else {
            //child可以消费该事件,坐标系变换
            final float offsetX = mScrollX - child.mLeft;
            final float offsetY = mScrollY - child.mTop;
            transformedEvent.offsetLocation(offsetX, offsetY);
            if (! child.hasIdentityMatrix()) {
                transformedEvent.transform(child.getInverseMatrix());
            }
            //child分发事件
            handled = child.dispatchTouchEvent(transformedEvent);
        }
       
        transformedEvent.recycle();
        //返回child的分发处理结果
        return handled;
    }

ViewGroup的onInterceptTouchEvent()方法

    /**
     * @return  true: 拦截事件并交给ViewGroup的onTouchEvent()处理
     *          false: ViewGroup不消费事件,继续向子view分发事件
     */
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        //如果子类不override该方法,则默认返回false
        return false;
    }

View 中touch事件是如何传递的

View的onInterceptTouchEvent()方法

    /**
     * 将屏幕的touch事件传递给目标view或者view自己(view本身就是目标view)
     * 
     * @return True if the event was handled by the view, false otherwise.
     */
    public boolean dispatchTouchEvent(MotionEvent event) {
        ...
        boolean result = false;
 
        if (mInputEventConsistencyVerifier != null) {
            mInputEventConsistencyVerifier.onTouchEvent(event, 0);
        }
 
        final int actionMasked = event.getActionMasked();
        if (actionMasked == MotionEvent.ACTION_DOWN) {
            // Defensive cleanup for new gesture
            stopNestedScroll();
        }
 
        if (onFilterTouchEventForSecurity(event)) {
            ListenerInfo li = mListenerInfo;
            //如果view设置了touchlistener并且view是enable状态,则在listener中处理事件
            if (li != null && li.mOnTouchListener != null
                    && (mViewFlags & ENABLED_MASK) == ENABLED
                    && li.mOnTouchListener.onTouch(this, event)) {
                result = true;
            }
            //lsitener未处理(包括未定义listener),则交给ontouchEvent()
            if (!result && onTouchEvent(event)) {
                result = true;
            }
        }
 
        //如果该view未消费该事件,则标记event交由父节点处理
        if (!result && mInputEventConsistencyVerifier != null) {
            mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
        }
        
        if (actionMasked == MotionEvent.ACTION_UP ||
                actionMasked == MotionEvent.ACTION_CANCEL ||
                (actionMasked == MotionEvent.ACTION_DOWN && !result)) {
            stopNestedScroll();
        }

        return result;
    }

View的onTouchEvent()方法

    /**
     * Implement this method to handle touch screen motion events.
     * @return True if the event was handled, false otherwise.
     */
    public boolean onTouchEvent(MotionEvent event) {
        final float x = event.getX();
        final float y = event.getY();
        final int viewFlags = mViewFlags;
        final int action = event.getAction();

        if ((viewFlags & ENABLED_MASK) == DISABLED) {
            //view如果是disabled状态,该view仍然消费该事件,但是不会做出UI的相应
            return (((viewFlags & CLICKABLE) == CLICKABLE
                    || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
                    || (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE);
        }

        if (mTouchDelegate != null) {
            if (mTouchDelegate.onTouchEvent(event)) {
                return true;
            }
        }

        if (((viewFlags & CLICKABLE) == CLICKABLE ||
                (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
                (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) {
            switch (action) {
                case MotionEvent.ACTION_UP:
                    ...
                    break;
                case MotionEvent.ACTION_DOWN:
                    ...
                    }
                    break;
                case MotionEvent.ACTION_CANCEL:
                    ...
                    break;
                case MotionEvent.ACTION_MOVE:
                    ...
                    break;
            }
            return true;
        }
        return false;
    }

如果事件不被中断,整个事件流向是一个类U型图,我们来看下这张图,可能更能理解U型图的意思。

U型事件传递模型

注意:这张图只是一张事件的传递模型的示意图,事件传递的实际实现细节跟图中不太一致,但最终事件的传递方向是一致的。

通过代码我们注意到,每一层的dispatchtouchevent()都是该层的事件的入口,在每一层的逻辑都大致遵循如下调用规则:

  • dispatchtouchevent捕获到上层分发过来的事件
  • 调用oninterceptTouchevent用来逻辑判断该事件是否需要在本层处理
  • 如果oninterceptTouchevent 返回false,则调用下一层的viewtree的dispatchtouchevent(递归),子viewtree的返回结果会作为本层dispatchtouchevent的结果返回
  • 如果oninterceptTouchevent返回true,则调用本层的ontouchevent方法
  • ontouchevent的逻辑处理结果会返回给dispatchtouchevent座位结果返回
  • 最终本层的dispatchtouchevent的处理结果会返回给父view

整个viewtree其实都是在按照同样的逻辑进行着层层的递归。
希望读者能够好好的把握一下代码和递归逻辑,这样在我们的view中就可以根据实际需要灵活使用时间分发、拦截和处理的三种接口,灵活的控制事件的传递和消费。

ACTION_MOVE和ACTION_UP事件

我们上文中讲到的事件传递流程是ACTION_DOWN的处理流程。
由于ACTION_DOWN事件是touch事件的第一个事件,所以其处理流程会相对复杂。而后续的一系列其他事件,其处理逻辑收到ACTION_DOWN事件的处理结果的影响而更加的智能。系统不会傻傻的把前人走过的死路让后人再走一遍。换句话说,一旦ACTION_DOWN事件找到了target,后续的一些列事件就会直达target,而不会再分发往更底层进行逻辑迭代。
还是那句话,看图(再次感谢kelin童鞋做出了这么优雅的图片):


ACTION_MOVE和ACTION_UP事件
  • 红色的箭头代表ACTION_DOWN 事件的流向
  • 蓝色的箭头代表ACTION_MOVE 和 ACTION_UP 事件的流向

本篇是Glide框架及源码解析的第一篇,更多文章敬请关注后续文章。版权归作者所有,如有转发,请注明文章出处:原文链接

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,390评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,821评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,632评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,170评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,033评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,098评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,511评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,204评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,479评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,572评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,341评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,213评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,576评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,893评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,171评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,486评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,676评论 2 335

推荐阅读更多精彩内容