Loading...
墨滴

帅次

2021/07/29  阅读:34  主题:全栈蓝

Android基础到进阶一文轻松搞定Touch事件分发

前言

每次听说事件分发就觉得好难、肯定不好学,其实事件分发也就那么回事。将本文看下去不说你能对事件分发有多么了解、多么深入,但是在应用开发中简单的使用是绝对没有问题的,下面咱就不叨叨,开始咱们的学习。

Android Touch事件的分发是 Android 工程师必备技能之一。关于事件分发主要有几个方向可以展开深入分析:

  • 1.Touch事件是如何从驱动层传递给 Framework 层的 InputManagerService;
  • 2.WMS是如何通过 ViewRootImpl 将事件传递到目标窗口;
  • 3.Touch事件到达 DecorView 后,是如何一步步传递到内部的子 View 中的。

名词了解

  • AMS:统一调度所有应用程序的Activity
  • WMS:控制所有Window的显示与隐藏以及要显示的位置

什么是事件

事件:Touch,既触碰,就是用户触碰手机界面的交互事件。事件主要包括:按下、滑动、抬起与取消。这些事件被封装成MotionEvent对象。该对象中的主要事件如下表所示:

事件流

按下、滑动、抬起、取消这几种事件组成了一个事件流。事件流以按下为开始,中间可能有若干次滑动,以抬起或取消作为结束。

什么是事件分发

事件分发:就是将一次完整的点击所包含的点击事件传递到某个具体的View或ViewGroup,让该View或该ViewGroup处理(消费)它。分发是从上往下依次传递的,其中可能经过的对象有最上层Activity中间层ViewGroup最下层View。例如在屏幕中有一个Button控件,点击它时该次点击事件就会从Activity传到Button所在的ViewGroup,最后传到该Button控件去处理它。即事件分发就是从上往下依次遍历,直到找到能够处理消费这次点击事件的View或ViewGroup。

在Android对事件分发的处理过程中,主要是对Down事件作分发,进而找到能够处理Down事件的组件。对于事件流中后续的事件(如Move、Up等),则直接分发给能够处理按下事件的组件。故本文讨论的内容则是主要针对按下事件的。

思路梳理

在深入分析事件分发源码之前,需要先弄清楚2个概念。

ViewGroup

ViewGroup 是一组 View 的组合,在其内部有可能包含多个子 View,当手指触摸屏幕上时,手指所在的区域既能在ViewGroup显示范围内,也可能在其内部 View 控件上。因此它内部的事件分发的重心是处理当前 ViewGroup 和子 View 之间的逻辑关系:

  • 1.当前 ViewGroup 是否需要拦截Touch事件;
  • 2.是否需要将Touch事件继续分发给子 View;
  • 3.如何将Touch事件分发给子 View。

View

View 是一个单纯的控件,不能再被细分,内部也并不会存在子 View,所以它的事件分发的重点在于当前 View 如何去处理 Touch 事件,并根据相应的手势逻辑进行一些列的效果展示(比如滑动,放大,点击,长按等)。

  • 1.是否存在 TouchListener;
  • 2.是否自己接收处理 touch 事件(主要逻辑在 onTouchEvent 方法中)。

涉及事件分发的方法

方法的简单用途解析

我们可以发现这三个方法的返回值都为boolean类型,其实它们就是通过返回值来决定下一步的传递处理方向。

1、dispatchTouchEvent() ——用来分发事件所用

该方法会将Touch事件自上而下依次分发到子元素中,直到被终止或者到达View层,该方法也是采用一种隧道方式来分发。在其中会调用onInterceptTouchEvent()和onTouchEvent(),一般不会重写

  • 返回false则不拦截继续往下分发;
  • 返回true则拦截住该事件不在向下层元素分发;

在dispatchTouchEvent()方法中默认返回false。

2、onInterceptTouchEvent() ——用来拦截事件所用

  • 返回false不拦截事件,Touch事件就会往下传递给其子View。
  • 返回true,该事件将会被拦截,并且被当前ViewGroup处理,调用ViewGroup的onTouchEvent()方法。

3、onTouchEvent() ——用来处理事件

  • 返回true则表示该View能处理该事件,事件将终止向上传递(传递给其父View)。
  • 返回false表示不能处理,则把事件传递给其父View的onTouchEvent()方法来处理。

拥有上述方法的类

注意: 需要特别注意一点就是ViewGroup中额外拥有onInterceptTouchEvent()方法,其他两个方法为这三种类所共同拥有。

事件分发流程

单个事件触发后,事件分发流程:Activity①>ViewGroup②>View③,如下图:

即要想充分理解Android分发机制,本质上是要理解:

  • Activity对点击事件的分发机制
  • ViewGroup对点击事件的分发机制
  • View对点击事件的分发机制

从U型图中可以发现,由父组件不断向子组件分发,若子组件能够处理,则立刻返回。若子组件都不处理,那传递到底层的子组件,再返回回来。整个View之间的事件分发,实质上就是一个大的递归函数

实例

下面咱们写一个简单实例来更好的理解这个大U型图,效果图:

创建实例

创建MyViewGroup继承ViewGroup

重写dispatchTouchEvent()、onInterceptTouchEvent()、onTouchEvent()方法

public class MyViewGroup extends RelativeLayout {
    public MyViewGroup(Context context) {
        super(context);
    }

    public MyViewGroup(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyViewGroup.dispatchTouchEvent:",ev);
        return super.dispatchTouchEvent(ev);
    }
    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyViewGroup.onInterceptTouchEvent:",ev);
        return false;
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        MLog.logEvent("MyViewGroup.onTouchEvent自行处理:",event);
        return super.onTouchEvent(event);
    }
}

创建MyView继承View

重写dispatchTouchEvent()、onTouchEvent()方法

public class MyView extends View {
    public MyView(Context context) {
        super(context);
    }

    public MyView(Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
    }
    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyView.dispatchTouchEvent:",ev);
        return super.dispatchTouchEvent(ev);
    }
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        MLog.logEvent("MyView.onTouchEvent:",event);
        return super.onTouchEvent(event);
    }
}

创建TouchActivity继承Activity

重写dispatchTouchEvent()、onTouchEvent()方法

public class TouchActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_touch);
    }

    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        MLog.logEvent("TouchActivity.dispatchTouchEvent:",ev);
        return super.dispatchTouchEvent(ev);
    }
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        MLog.logEvent("TouchActivity.onTouchEvent:",event);
        return super.onTouchEvent(event);
    }
}

创建布局文件

添加控件MyViewGroup和MyView

<?xml version="1.0" encoding="utf-8"?>
<com.scc.demo.view.MyViewGroup xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/mtrg_touch"
    android:layout_width="match_parent"
    android:layout_height="300dp"
    android:background="@color/color_FF773D">

    <com.scc.demo.view.MyView
        android:id="@+id/mtv_onclick"
        android:layout_width="120dp"
        android:layout_height="60dp"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="40dp"
        android:background="@color/color_188FFF"/>

</com.scc.demo.view.MyViewGroup>

MLog.logEvent()

方便查看对应事件

public static void logEvent(String msg, MotionEvent event) {
        String motionEvent = "";
        switch (event.getAction()){
            case MotionEvent.ACTION_DOWN://在屏幕按下时(所有事件的开始)
                motionEvent="DOWN";
                break;
            case MotionEvent.ACTION_UP://在屏幕抬起时(与DOWN对应)
                motionEvent="UP";
                break;
            case MotionEvent.ACTION_MOVE://在屏幕上滑动时
                motionEvent="MOVE";
                break;
            case MotionEvent.ACTION_CANCEL://滑动超出控件边界时
                motionEvent="CANCEL";
                break;
        }
        Log.e("SccEvent", msg + motionEvent);
    }

点击页面,看效果

点击Activity(白色区域)

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: TouchActivity.onTouchEvent:DOWN
E/SccEvent: TouchActivity.dispatchTouchEvent:MOVE
E/SccEvent: TouchActivity.onTouchEvent:MOVE
E/SccEvent: TouchActivity.dispatchTouchEvent:MOVE
E/SccEvent: TouchActivity.onTouchEvent:MOVE
E/SccEvent: TouchActivity.dispatchTouchEvent:UP
E/SccEvent: TouchActivity.onTouchEvent:UP

点击ViewGroup(黄色区域)

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.onInterceptTouchEvent:DOWN
E/SccEvent: MyViewGroup.onTouchEvent:DOWN
E/SccEvent: TouchActivity.onTouchEvent:DOWN
E/SccEvent: TouchActivity.dispatchTouchEvent:MOVE
E/SccEvent: TouchActivity.onTouchEvent:MOVE
E/SccEvent: TouchActivity.dispatchTouchEvent:MOVE
E/SccEvent: TouchActivity.onTouchEvent:MOVE
E/SccEvent: TouchActivity.dispatchTouchEvent:UP
E/SccEvent: TouchActivity.onTouchEvent:UP

点击View(蓝色区域)

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.onInterceptTouchEvent:DOWN
E/SccEvent: MyView.dispatchTouchEvent:DOWN
E/SccEvent: MyView.onTouchEvent:DOWN
E/SccEvent: MyViewGroup.onTouchEvent:DOWN
E/SccEvent: TouchActivity.onTouchEvent:DOWN
E/SccEvent: TouchActivity.dispatchTouchEvent:MOVE
E/SccEvent: TouchActivity.onTouchEvent:MOVE
E/SccEvent: TouchActivity.dispatchTouchEvent:MOVE
E/SccEvent: TouchActivity.onTouchEvent:MOVE
E/SccEvent: TouchActivity.dispatchTouchEvent:UP
E/SccEvent: TouchActivity.onTouchEvent:UP

结果分析

重叠区域越多触发事件越多。这就用到了事件分发。

点击蓝色区域,走完了一个大U分发,没有人拦截和处理。

看看上面的日志你会发现按下事件走了那么多方法,为什么滑动和抬起仅调用Activity中的方法?

原因就是:MOVE、UP 等事件的分发交给谁,取决于它们的起始事件 Down 是由谁捕获的。可参阅文章后面的为什么 DOWN 事件特殊

本次将所有Touch事件打印,后续仅打印按下事件。

事件分发和处理

Activity处理和分发

Activity处理

1.将MyViewGroup.dispatchTouchEvent()返回修改为false

  @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyViewGroup.dispatchTouchEvent:",ev);
        return false;
    }

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.dispatchTouchEvent:DOWN
E/SccEvent: TouchActivity.onTouchEvent:DOWN
E/SccEvent: TouchActivity.SccEvent就在这里玩

2.MyViewGroup仅拦截不处理,也会交给Activity.onTouchEvent处理

3.向下分发的事件ViewGroup和View都不处理,最后还是交给Activity.onTouchEvent处理(如上面点击蓝色区域结果分析)

Activity分发

Actvitiy是事件分发的顶层,dispatchTouchEvent方法返回true不做分发,事件结束。返回false或者super.dispatchTouchEvent(ev)则向下分发事件。向下分发就没必要处理(重写)dispatchTouchEvent()

ViewGroup拦截处理和分发

ViewGroup拦截处理

确保Activity做好分发后(即不对dispatchTouchEvent做修改),修改MyViewGroup.onInterceptTouchEvent()和MyViewGroup.onTouchEvent()方法,ViewGroup的重点在于事件拦截(onInterceptTouchEvent),所以咱重写拦截事件和处理事件的两个方法即可。

    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyViewGroup.dispatchTouchEvent:",ev);
        return super.dispatchTouchEvent(ev);
    }
    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyViewGroup.onInterceptTouchEvent:",ev);
        return true;
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        MLog.logEvent("MyViewGroup.onTouchEvent:",event);
        MLog.logEvent("MyViewGroup.SccEvent就在这里玩",event.getAction());
        return true;
    }

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.onInterceptTouchEvent:DOWN
E/SccEvent: MyViewGroup.onTouchEvent:DOWN
E/SccEvent: MyViewGroup.SccEvent就在这里玩

结果分析

在MyViewGroup.onTouchEvent()方法将事件处理了,MyViewGroup告诉TouchActivity已经处理掉了。这个时候MyView想不想处理都不重要了,因为事件已经让MyViewGroup拐跑了。

如果这个时候返回super.onTouchEvent(event),则默认未处理,后面会交给TouchActivity.onTouchEvent()来处理。看效果

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        MLog.logEvent("MyViewGroup.onTouchEvent:",event);
        MLog.logEvent("MyViewGroup.SccEvent就在这里玩",event.getAction());
        return super.onTouchEvent(event);
    }

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.onInterceptTouchEvent:DOWN
E/SccEvent: MyViewGroup.onTouchEvent:DOWN
E/SccEvent: MyViewGroup.SccEvent就在这里玩
TouchActivity.onTouchEvent:DOWN

那这就是个失败的拦截和处理

ViewGroup分发

不对ViewGroup的dispatchTouchEvent()和onInterceptTouchEvent()做修改即可

View处理和分发

View处理

确保ViewGroup做好分发后,修改MyView.onTouchEvent()方法

@Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        MLog.logEvent("MyView.dispatchTouchEvent:",ev);
        return super.dispatchTouchEvent(ev);
    }
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        MLog.logEvent("MyView.onTouchEvent:",event);
        MLog.logEvent("MyView.SccEvent就在这里玩",event.getAction());
        return true;
//        return super.onTouchEvent(event);
    }

运行结果

E/SccEvent: TouchActivity.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.dispatchTouchEvent:DOWN
E/SccEvent: MyViewGroup.onInterceptTouchEvent:DOWN
E/SccEvent: MyView.dispatchTouchEvent:DOWN
E/SccEvent: MyView.onTouchEvent:DOWN
E/SccEvent: MyView.SccEvent就在这里玩

结果分析

在MyView.onTouchEvent()将事件处理了,MyTouchView告诉MyViewGroup我消费掉了,MyViewGroup告诉TouchActivity消费掉了。

分发

View本身就是最小的View,没有子View给他做分发,所以MyView.dispatchTouchEvent() 方法可以不做改变,或者不重写。

onTouch()与onTouchEvent()的区别(View)

onTouchEvent()方法:

onTouchEvent是手机屏幕事件的处理方法,是获取的对屏幕的各种操作,比如向左向右滑动,点击返回按钮等等。当屏幕有touch事件时,此方法就会别调用。

onTouch方法:

onTouch()是OnTouchListener接口的方法,它是获取某一个控件的触摸事件,因此使用时,必须使用setOnTouchListener绑定到控件,然后才能鉴定该控件的触摸事件。

小结

onTouch()优先级比onTouchEvent()高,会先触发。

假如onTouch方法返回false,会接着触发onTouchEvent,反之onTouchEvent方法不会被调用。

onClick等事件的实现等等都基于onTouchEvent,假如onTouchEvent返回true,这些事件将不会被触发。

以上以ViewGroup分发为前提

上面几种情况基本包含应用中出现的场景,合理利用你也可以正确的使用Touch事件分发。是不是很简单。

为什么 DOWN 事件特殊

所有 Touch 事件都是从 DOWN 事件开始的,这是 DOWN 事件比较特殊的原因之一。另一个原因是 DOWN 事件的处理结果会直接影响后续 MOVE、UP 事件的逻辑。也就是说后续的 MOVE、UP 等事件的分发交给谁,取决于它们的起始事件 Down 是由谁捕获的。

  • 向上滑动:查看方法的简单用途解析进行巩固
  • 向下滑动:查看源码分析进一步学习

源码分析

下面,咱们一起通过源码,全面解析事件分发机制,即按顺序讲解:

  • Activity事件分发机制
  • ViewGroup事件分发机制
  • View事件分发机制

Activity事件分发机制

Android事件分发机制首先会将点击事件传递到Activity中,具体是执行dispatchTouchEvent()进行事件分发。

Activity.dispatchTouchEvent()源码

/**
  * 创建人:帅次
  * 创建时间:2021/7/5
  * 功能:Activity.dispatchTouchEvent()
  */

public boolean dispatchTouchEvent(MotionEvent ev) {
    if (ev.getAction() == MotionEvent.ACTION_DOWN) {
 //在这里仅用于ACTION_DOWN的判断
 onUserInteraction();
    }
    //返回true
    if (getWindow().superDispatchTouchEvent(ev)) {
  //Activity.dispatchTouchEvent()就返回true,则方法结束。
   //该点击事件停止往下传递&事件传递过程结束(让爷爷吃了嘿嘿)
   return true;
    }
    return onTouchEvent(ev);
}

Activity.onUserInteraction()源码

/**
  * 创建人:帅次
  * 创建时间:2021/7/6
  * 功能:该方法是用户交互,每当向Activity分派按键、触摸或轨迹球事件时调用。
  */

public void onUserInteraction() {
}

Window.superDispatchTouchEvent()源码

/**
  * 创建人:帅次
  * 创建时间:2021/7/6
  * 功能:Window.superDispatchTouchEvent属于抽象方法。
  * 用于自定义窗口,如Dialog,传递触摸屏事件进一步向下视图层次结构。
  * 应用程序开发人员应该不需要实现或调用它。
  */

public abstract boolean superDispatchTouchEvent(MotionEvent event);

因为Window是抽象类,咱就继续挖,就找到了它的唯一实现类PhoneWindow

PhoneWindow.superDispatchTouchEvent()源码

// This is the top-level view of the window, containing the window decor.
//这是窗口的顶层View的实例对象。 
private DecorView mDecor;
@Override
public boolean superDispatchTouchEvent(MotionEvent event) {
 //咱们继续往下看
 return mDecor.superDispatchTouchEvent(event);
}

DecorView.superDispatchTouchEvent()源码

public boolean superDispatchTouchEvent(MotionEvent event) {
 //super调用父类dispatchTouchEvent方法。那它的父类是谁呢?
 //DecorView extends FrameLayout、FrameLayout extends ViewGroup!
 //从上面看出DecorView 是ViewGroup的间接子类。
 //看到这里Activity.dispatchTouchEvent()也基本差不多了
 //如果ViewGroup.dispatchTouchEvent return true,
 //则Activity.dispatchTouchEvent()return true。
 //如果ViewGroup.dispatchTouchEvent return false,
 //则执行Activity.onTouchEvent(ev)。
 return super.dispatchTouchEvent(event);
}

Activity.onTouchEvent()源码

/**
  * 创建人:帅次
  * 创建时间:2021/7/6
  * 功能:当Touch事件未被其下的任何View消费时调用。
  */

public boolean onTouchEvent(MotionEvent event) {
    //Window.shouldCloseOnTouch来判断是否消费。
    //那咱就继续看看Window.shouldCloseOnTouch是干嘛的
    if (mWindow.shouldCloseOnTouch(this, event)) {
        finish();
        //已经消费了该事件,则返回true
        return true;
    }
    //还没有消费返回false,默认返回false
    return false;
}

Window.shouldCloseOnTouch()源码

//这里支持的最高版本maxTargetSdk = Build.VERSION_CODES.P(28),咱使用SDK30就没办法处理了。
//主要是对于处理边界外点击事件的判断:是否是DOWN事件,event的坐标是否在边界内等
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
public boolean shouldCloseOnTouch(Context context, MotionEvent event) {
    final boolean isOutside =
            event.getAction() == MotionEvent.ACTION_UP && isOutOfBounds(context, event)
            || event.getAction() == MotionEvent.ACTION_OUTSIDE;
    if (mCloseOnTouchOutside && peekDecorView() != null && isOutside) {
 //return true:说明事件在边界外,即 消费事件
 return true;
    }
//返回false:在边界内,即未消费(默认)
    return false;
}

Activity.onTouchEvent()到这里就基本结束了。后面源码完善在再补充。

Activity源码总结

当一个点击事件发生时,从Activity的事件分发开始(Activity.dispatchTouchEvent()),流程如下:

ViewGroup事件分发机制

从上面Activity的事件分发机制可知,在Activity.dispatchTouchEvent()实现了将事件从Activity->ViewGroup的传递,ViewGroup的事件分发机制从dispatchTouchEvent()开始。

在Activity.dispatchTouchEvent()中遗留了ViewGroup.dispatchTouchEvent()什么时候返回true/false在下面的源码分析中找出来。

ViewGroup.dispatchTouchEvent()源码

先从宏观角度,纵览整个 dispatch 的源码如下:

@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
    /**
     * 一、检查当前ViewGroup是否需要拦截事件
     * 1、如果事件为DOWN事件,则调用onInterceptTouchEvent进行拦截判断;
     * 2、mFirstTouchTarget!=null,代表已经有子View捕获了这个事件,
     子 View 的 dispatchTouchEvent 返回true就是代表捕获touch 件。
     */

    /**
     * 二、将事件分发给子View
     * 满足条件canceled和intercepted都为false,既不取消也不拦截
     * 1、actionMasked==MotionEvent.ACTION_DOWN
     表明事件主动分发的前提是事件为 DOWN 事件
     * 2、通过for循环,遍历当前ViewGroup下的所有子View;
     * 3、处判断事件坐标是否在子 View 坐标范围内,并且子 View 并没有处在动画状态;
     * 4、调用 dispatchTransformedTouchEvent 方法将事件分发给子 View,
     如果子 View 捕获事件成功,则将 mFirstTouchTarget 赋值给子 View。
     */

    /**
     * 三、根据mFirstTouchTarget再次分发事件
     * 3.1、mFirstTouchTarget为null,说明在上述的事件分发中并没有子 View 对事件进行了捕获操作。
     直接调用 dispatchTransformedTouchEvent 方法,并传入child为 null
     最终会调用 super.dispatchTouchEvent 方法。实际上最终会调用自身的 onTouchEvent 方法,进行处理touch事件。
     结论:如果没有子 View 捕获处理 touch 事件,ViewGroup会通过自身的onTouchEvent方法进行处理。
     * 3.2、mFirstTouchTarget 不为 null,说明在上述的事件分发中有子 View 对 touch 事件进行了捕获,
     则直接将当前以及后续的事件交给 mFirstTouchTarget 指向的 View 进行处理。
     */

}

下面咱逐层分析:

@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    // 是否按下操作 , 最终的对外返回结果 , 该方法的最终返回值 
    boolean handled = false;
    /*onFilterTouchEventForSecurity以应用安全策略过滤触摸事件。
    /return true分派事件,return false删除事件。*/

    if (onFilterTouchEventForSecurity(ev)) {
        final int action = ev.getAction();
        final int actionMasked = action & MotionEvent.ACTION_MASK;
        final boolean intercepted;
        /**
         * 一、检查当前ViewGroup是否需要拦截事件
         * 1、如果事件为DOWN事件,则调用onInterceptTouchEvent进行拦截判断;
         * 2、mFirstTouchTarget!=null,代表已经有子View捕获了这个事件,
         子 View 的 dispatchTouchEvent 返回true就是代表捕获touch 件。
         */

        if (actionMasked == MotionEvent.ACTION_DOWN
                || mFirstTouchTarget != null) {
            final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
            if (!disallowIntercept) {
                intercepted = onInterceptTouchEvent(ev);
                //恢复操作以防它被更改
                ev.setAction(action);
            } else {
                intercepted = false;
            }
        } else {
            // There are no touch targets and this action is not an initial down
            // so this view group continues to intercept touches.
            intercepted = true;
        }
        // Check for cancelation.
        final boolean canceled = resetCancelNextUpFlag(this)
                || actionMasked == MotionEvent.ACTION_CANCEL;

        // Update list of touch targets for pointer down, if needed.
        final boolean isMouseEvent = ev.getSource() == InputDevice.SOURCE_MOUSE;
        final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0
                && !isMouseEvent;
        TouchTarget newTouchTarget = null;
        boolean alreadyDispatchedToNewTouchTarget = false;
        /**
         * 二、将事件分发给子View
         * 满足条件canceled和intercepted都为false,既不取消也不拦截
         */

        if (!canceled && !intercepted) {
            /*1、actionMasked==MotionEvent.ACTION_DOWN表明
            事件主动分发的前提是事件为 DOWN 事件*/

            if (actionMasked == MotionEvent.ACTION_DOWN
                    || (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
                    || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
                final int actionIndex = ev.getActionIndex(); // always 0 for down
                final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
                        : TouchTarget.ALL_POINTER_IDS;

                // Clean up earlier touch targets for this pointer id in case they
                // have become out of sync.
                removePointersFromTouchTargets(idBitsToAssign);

                final int childrenCount = mChildrenCount;
                if (newTouchTarget == null && childrenCount != 0) {
                    final float x =
                            isMouseEvent ? ev.getXCursorPosition() : ev.getX(actionIndex);
                    final float y =
                            isMouseEvent ? ev.getYCursorPosition() : ev.getY(actionIndex);
                    // Find a child that can receive the event.
                    // Scan children from front to back.
                    final ArrayList<View> preorderedList = buildTouchDispatchChildList();
                    final boolean customOrder = preorderedList == null
                            && isChildrenDrawingOrderEnabled();
                    final View[] children = mChildren;
                    //2、通过for循环,遍历当前ViewGroup下的所有子View;
                    for (int i = childrenCount - 1; i >= 0; i--) {
                        final int childIndex = getAndVerifyPreorderedIndex(
                                childrenCount, i, customOrder);
                        final View child = getAndVerifyPreorderedView(
                                preorderedList, children, childIndex);
                        //3、处判断事件坐标是否在子 View 坐标范围内,并且子 View 并没有处在动画状态;
                        if (!child.canReceivePointerEvents()
                                || !isTransformedTouchPointInView(x, y, child, null)) {
                            continue;
                        }

                        newTouchTarget = getTouchTarget(child);
                        if (newTouchTarget != null) {
                            // Child is already receiving touch within its bounds.
                            // Give it the new pointer in addition to the ones it is handling.
                            newTouchTarget.pointerIdBits |= idBitsToAssign;
                            break;
                        }

                        resetCancelNextUpFlag(child);
                        /*4、调用 dispatchTransformedTouchEvent 方法将事件分发给子 View,
                         如果子 View 捕获事件成功,则将 mFirstTouchTarget 赋值给子 View。*/

                        if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
                            // Child wants to receive touch within its bounds.
                            mLastTouchDownTime = ev.getDownTime();
                            if (preorderedList != null) {
                                // childIndex points into presorted list, find original index
                                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;
                        }


                    }
                    if (preorderedList != null) preorderedList.clear();
                }
            }
        }
        /**
         * 三、根据mFirstTouchTarget再次分发事件
         */

        //3.1mFirstTouchTarget为null,
        if (mFirstTouchTarget == null) {
            /*说明在上述的事件分发中并没有子 View 对事件进行了捕获操作。
            直接调用 dispatchTransformedTouchEvent 方法,并传入child为 null
            最终会调用 super.dispatchTouchEvent 方法。
            实际上最终会调用自身的 onTouchEvent 方法,进行处理touch事件。*/

            /*结论:如果没有子 View 捕获处理 touch 事件,
            ViewGroup会通过自身的onTouchEvent方法进行处理。*/

            handled = dispatchTransformedTouchEvent(ev, canceled, null,
                    TouchTarget.ALL_POINTER_IDS);
        } else {
            // Dispatch to touch targets, excluding the new touch target if we already
            // dispatched to it.  Cancel touch targets if necessary.
            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;

                    /*mFirstTouchTarget 不为 null,说明在上述的事件分发中有子 View 对 touch 事件进行了捕获,
                    则直接将当前以及后续的事件交给 mFirstTouchTarget 指向的 View 进行处理。
                     */

                    if (dispatchTransformedTouchEvent(ev, cancelChild,
                            target.child, target.pointerIdBits)) {
                        handled = true;
                    }
                }
                predecessor = target;
                target = next;
            }
        }
    }
    return handled;
}

ViewGroup.onInterceptTouchEvent()源码

/**
  * 创建人:帅次
  * 创建时间:2021/7/6
  * 前提ViewGroup.dispatchTouchEvent return super.dispatchTouchEvent(ev);
  * 功能:是否拦截事件 return true拦截,return false(默认)不拦截
  */

public boolean onInterceptTouchEvent(MotionEvent ev) {
    if (ev.isFromSource(InputDevice.SOURCE_MOUSE)
            && ev.getAction() == MotionEvent.ACTION_DOWN
            && ev.isButtonPressed(MotionEvent.BUTTON_PRIMARY)
            && isOnScrollbarThumb(ev.getX(), ev.getY())) {
        return true;
    }
    return false;
}

ViewGroup.onTouchEvent()源码

ViewGroup是没有onTouchEvent()这个方法的,因为ViewGroup是View的子类,所以ViewGroup可以直接调用View的onTouchEvent()方法。这里就不做详细介绍,下面在View事件分发机制中一起解答。

ViweGroup源码总结

Android事件分发传递到Acitivity后,总是先传递到ViewGroup、再传递到View。流程总结如下:(假设已经经过了Acitivity事件分发传递并传递到ViewGroup)

View的事件分发机制

从上面ViewGroup事件分发机制知道,View事件分发机制从dispatchTouchEvent()开始。

View.dispatchTouchEvent()源码

public boolean dispatchTouchEvent(MotionEvent event) {
    /*一、(mViewFlags & ENABLED_MASK) == ENABLED
     1、该条件是判断当前点击的控件是否enable
     2、由于很多View默认enable,故该条件恒定为true(除非手动设置为false)
     */


    /*二、mOnTouchListener != null
     1、mOnTouchListener变量在View.setOnTouchListener()里赋值
     2、即只要给控件注册了Touch事件,mOnTouchListener就一定被赋值(即不为空)
     */


     /*三、mOnTouchListener.onTouch(this, event)
     1、即回调控件注册Touch事件时的onTouch();
     2、需手动复写设置,具体如下(以View为例)
     view.setOnTouchListener(new OnTouchListener() {
        @Override
        public boolean onTouch(View v, MotionEvent event) {
            MLog.logEvent("MyTouchTrueView.onTouch自行处理:",event);
            return true;
            // 1、若在onTouch()返回true,就会让上述三个条件全部成立,
            从而使得View.dispatchTouchEvent()直接返回true,事件分发结束
            // 2、若在onTouch()返回false,就会使得上述三个条件不全部成立,
            从而使得View.dispatchTouchEvent()中跳出if,执行onTouchEvent(event)
            // 3、onTouchEvent()源码分析 
        }
    });
     */

    if ( (mViewFlags & ENABLED_MASK) == ENABLED &&
            mOnTouchListener != null &&
            mOnTouchListener.onTouch(this, event)) {
        return true;
    }

    return onTouchEvent(event);
}

View.onTouchEvent()源码

public boolean onTouchEvent(MotionEvent event) {  
    ... // 仅展示关键代码
    // 若该控件可点击,则进入switch判断中
    if (((viewFlags & CLICKABLE) == CLICKABLE || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {  
        // 根据当前事件类型进行判断处理
        switch (event.getAction()) { 
            // 抬起View
            case MotionEvent.ACTION_UP:  
                    performClick(); 
                    break;  
            // 按下
            case MotionEvent.ACTION_DOWN:  
                postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());  
                break;  
            // 取消
            case MotionEvent.ACTION_CANCEL:  
                refreshDrawableState();  
                removeTapCallback();  
                break;
            // 滑动
            case MotionEvent.ACTION_MOVE:  
                final int x = (int) event.getX();  
                final int y = (int) event.getY();  
                int slop = mTouchSlop;  
                if ((x < 0 - slop) || (x >= getWidth() + slop) ||  
                        (y < 0 - slop) || (y >= getHeight() + slop)) {  
                    removeTapCallback();  
                    if ((mPrivateFlags & PRESSED) != 0) {  
                        removeLongPressCallback();  
                        mPrivateFlags &= ~PRESSED;  
                        refreshDrawableState();  
                    }  
                }  
                break;  
        }  

        // 若该控件可点击,就一定返回true
        return true;  
    }  
  // 若该控件不可点击,就一定返回false
  return false;  
}
  public boolean performClick() {  
      if (mOnClickListener != null) {
          // 只要通过setOnClickListener()为控件View注册1个点击事件
          // 那么就会给mOnClickListener变量赋值(即不为空)
          // 则会往下回调onClick() & performClick()返回true
          playSoundEffect(SoundEffectConstants.CLICK);  
          mOnClickListener.onClick(this);  
          return true;  
      }  
      return false;  
  }  

View源码总结

Android事件分发传递到Acitivity后,总是先传递到ViewGroup、再传递到View。流程总结如下:(假设已经经过了ViewGroup事件分发传递并传递到View)

总结

重点分析了 dispatchTouchEvent 的事件的流程机制,这一过程主要分 3 部分:

  • 1、判断是否需要拦截 —> 主要是根据 onInterceptTouchEvent 方法的返回值来决定是否拦截;
  • 2、在 DOWN 事件中将 touch 事件分发给子 View —> 这一过程如果有子 View 捕获消费了 touch 事件,会对 mFirstTouchTarget 进行赋值;
  • 3、最后一步,DOWN、MOVE、UP 事件都会根据 mFirstTouchTarget 是否为 null,决定是自己处理 touch 事件,还是再次分发给子 View。

然后介绍了整个事件分发中的几个特殊的点。

  • 1、DOWN 事件的特殊之处:事件的起点;决定后续事件由谁来消费处理;
  • 2、mFirstTouchTarget 的作用:记录捕获消费 touch 事件的 View,是一个链表结构;
  • 3、CANCEL 事件的触发场景:当父视图先不拦截,然后在 MOVE 事件中重新拦截,此时子 View 会接收到一个 CANCEL 事件。

以上就是本文的全部内容,希望对大家学习 Android 事件分发有所帮助和启发。

帅次

2021/07/29  阅读:34  主题:全栈蓝

作者介绍

帅次

公众号:帅次