KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

TouchEventBus

★ 262 Open GitHub ↗

一种处理嵌套和非嵌套滑动冲突的解决方案

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 滑动冲突解决方案

---
# 非嵌套滑动  |  [嵌套滑动][1]

> Android 系统的触摸事件分发总是从父布局开始分发，从最顶层的子 View 开始处理，这种特性有时候会限制了我们一些很复杂的交互设计。
> 
> **``TouchEventBus``** 致力于解决非嵌套的滑动冲突，比如多个 **在同一层级** 的``Fragment`` 对触摸事件的处理：触摸事件会先到达顶层 ``Fragment`` 的 ``onTouch`` 方法，然后逐层判断是否消费，在都不消费的情况下才到达底层的 ``Fragment`` 。而且这些层级互不嵌套，没有形成 parent 和 child 的关系，意味着想通过 ``onInterceptTouchEvent()`` 或者 ``requestDisallowInterceptTouchEvent()`` 方法来调整事件分发都是不可能的。 :full_moon_with_face:

## 同级视图的触摸事件

下面是手机YY的开播预览页：

![YY预览页][2]

在这个页面上有很多对触摸事件的处理，包括且不限于：

- 在屏幕上点击，会触发摄像头的聚焦（黄色框出现的地方）
- 双指缩放，会触发摄像头的缩放
- 左右滑动，可以切换 ``ViewPager`` ，从“直播”和“玩游戏”两个选项卡之间切换
- “玩游戏”选项卡上的列表可以滑动
- “直播”选项卡上的控件可以点击（开播按钮，添加图片…）
- 由于预览页和开播页是同一个 ``Activity`` ，所以这个 ``Activity`` 上还有很多开播后的 ``Fragment``,比如公屏等等也有触摸事件

从视觉上可以判断出View Tree的层级以及对触摸处理的层级：

![处理顺序][3]

图左侧是 UI 的层级，上层是一些按钮控件和 ``ViewPager`` ，下层是视频流展示的 ``Fragment``。右边是触摸事件处理的层级，双指缩放/View点击/聚焦点击需要在 ``ViewPager``上面，否则都会被 ``ViewPager`` 消费掉，但是 ``ViewPager`` 的 UI 层级又比视频的 ``Fragment`` 要高。这就是非嵌套的滑动冲突的核心矛盾：

> **业务逻辑的层级** 与 **用户看到的UI层级** 不一致

## 对触摸事件的重新分发

手机YY直播间中的 ``Fragment``  非常多，而且因为插件化的原因，各个业务插件可以动态地往直播间添加/移除自己业务的 ``Fragment`` ，这些 ``Fragment`` 层级相同互不嵌套，有自己比较独立的业务逻辑，也会有点击/滑动等事件处理的需求。但由于业务场景复杂，``Fragment`` 的上下层级顺序也会动态改变，这就很容易导致一些 ``Fragment`` 一直收不到触摸事件或者在切换业务模板的时候触摸事件被其他业务消费。

``TouchEventBus`` 用于这种场景下对触摸事件进行重新分发，我们可以随心所欲地决定业务逻辑的层级顺序。

![TouchEventBus重新分发触摸事件][4]

每个手势的处理就是一个 ``TouchEventHandler``，比如镜头的缩放是 **CameraZoomHandler** ，镜头的聚焦点击是 **CameraClickHandler** ，``ViewPager`` 滑动是 **PreviewSlideHandler** ，然后为这些 Handler 重新排序，按照业务的需要来传递 ``MotionEvent`` 。然后是 ``TouchEventHandler`` 和ui的对应关系：通过Handler的 ``attach`` / ``dettach`` 方法来绑定/解绑对应的 ui 。而 ui 可以是一个具体的 ``Fragment``，也可以是一个抽象的接口，一个对触摸事件作出响应的业务。

比如开播预览页的聚焦点击处理，先是定义ui的接口：

```Java
public interface CameraClickView {
    /**
     * 在指定位置为中心显示一个黄色矩形的聚焦框
     *
     * @param x 手指触摸坐标x
     * @param y 手指触摸坐标y
     */
    void showVideoClickFocus(float x, float y);

/**
     * 给VideoSdk传递触摸事件，让其在指定坐标进行摄像头聚焦
     *
     * @param e 触摸事件
     */
    void onTouch(MotionEvent e);
}
```

然后是 ``TouchEventHandler`` 的定义：

```Java
public class CameraClickHandler extends TouchEventHandler<CameraClickView> {
    
    private boolean performClick = false;
    //...
    
    @Override
    public boolean onTouch(@NonNull CameraClickView v, MotionEvent e, boolean hasBeenIntercepted) {
        super.onTouch(v, e, hasBeenIntercepted);
        if (!isCameraFocusEnable()) { //一些特殊业务需要禁止摄像头聚焦
            return false;
        }
        //通过MotionEvent判断performClick是否为true
        switch (e.getAction()) {
            case MotionEvent.ACTION_DOWN:
                //...
                break;
            case MotionEvent.ACTION_MOVE:
                //...
                break;
            case MotionEvent.ACTION_UP: 
                //...
                break;
            default:
                break;
        }

if (performClick) { //认为是点击行为，调用ui的接口
            v.showVideoClickFocus(e.getRawX(), e.getRawY());
            v.onTouch(e);
        }
        return performClick; //点击的时候消费掉触摸事件
    }
}
```

最后是 ``TouchEventHandler`` 与 ui 的对应的绑定

```Java
public class MobileLiveVideoComponent extends Fragment implements CameraClickView{
    
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        //...
        //CameraClickHandler与当前Fragment绑定
        TouchEventBus.of(CameraClickHandler.class).attach(this);
    }
    
    @Override
    public void onDestroyView() {
        //...
        //CameraClickHandler与当前Fragment解绑
        TouchEventBus.of(CameraClickHandler.class).dettach(this);
    }
    
    @Override
    public void showVideoClickFocus(float x, float y) {
        //todo: 展示一个黄色框ui
    }
    
    @Override
    public void onTouch(MotionEvent e) {
        //todo: 调用SDK的摄像头聚焦
    }
}
```

当用户对ui的进行手势操作时，``MotionEvent`` 就会沿着 ``TouchEventBus`` 里面的顺序进行分发。如果在 **CameraClickHandler** 之前没有别的 Handler 把事件消费掉，那么就能在 ``onTouch`` 方法进行处理，然后在 ui 作出响应。

## 事件的分发顺序

多个 ``TouchEventHandler`` 之间需要定义一个分发的顺序，最先接收到触摸事件的 Handler 可以拦截后面的 Handler。在顺序的定义上，很难固定一条绝对的分发路线，因为随着直播间模版的切换，``Fragment`` 的层级可能会产生变化。
所以 ``TouchEventBus`` 使用相对的顺序定义。每个 Handler 可以决定要拦截哪些其他的 Handler。比如要把 **CameraClickHandler** 排在其他几个Handler前面：

```Java
public class CameraClickHandler extends AbstractTouchEventHandler<CameraClickView> {
    //...

@Override
    public boolean onTouch(@NonNull CameraClickView v, MotionEvent e, boolean hasBeenIntercepted) {
        //...
    }

/**
     * 定义哪些Handler需要排在我的后面
     **/
    @Override
    protected void defineNextHandlers(@NonNull List<Class<? extends TouchEventHandler<?, ? extends TouchViewHolder<?>>>> handlers) {
        //下面的Handler都会在CameraClickHandler后面，但他们之间的顺序还未定义
        handlers.add(CameraZoomHandler.class);
        handlers.add(MediaMultiTouchHandler.class);
        handlers.add(PreviewSlideHandler.class);
        handlers.add(VideoControlTouchEventHandler.class);
    }
}
```

每个 Handler 都会指定排在自己后面的 Handler，从而形成一张图。通过拓扑排序我们就能动态地获得一条分发路径。下图的箭头指向 “A->B” 表示A需要排在B的前面：

![拓扑排序][5]

在直播间模版切换的时候，任何一个 Handler 都可以动态地添加到这个图当中，也可以从这个图中随时移除，不会影响其他业务的正常进行。

## 嵌套的视图用 Android 系统的触摸分发

互不嵌套的 ``Fragment`` 层级才需要使用 ``TouchEventBus``，``Fragment`` 内部用 Android 默认的触摸事件分发。如下图：红色箭头部分为 ``TouchEventBus`` 的分发，按 Handler 的拓扑顺序进行逐层调用。蓝色箭头部分为 ``Fragment`` 内部 ViewTree 的分发，完全依照 Android 系统的分发顺序，即从父布局向子视图分发，子视图向父布局逐层决定是否消费。

![触摸事件分发][6]

## 使用例子

运行本工程的 ***TouchSample*** 模块，是一个使用 ``TouchEventBus`` 的简单 Demo 。

![TouchSample][7]

- 单指左右滑动切换选项卡
- 双指缩放中间的"Tab%_subTab%"文本框
- 双指左右滑动切换背景图
- 滑动屏幕左侧拉出侧边面板

ui的层级：Activity -> 背景图 -> 侧边面板 -> 选项卡 -> 文本框

触摸处理的顺序：侧边面板 -> 文本缩放 -> 背景图滑动 -> 底部导航点击 -> 选项卡滑动

> 这里还做了一个操作是：让底部导航点击不消费触摸事件。所以你可以在底部的导航栏区域上左右滑动，切换的是一级Tab。而在背景图区域左右滑动，切换的是二级Tab。

## 配置

1. 在项目 build.gradle 添加仓库地址

```groovy
    allprojects {
        repositories {
            maven { url 'https://jitpack.io' }
    	}
    }
    ```

2. 对应模块添加依赖

```groovy
    dependencies {
        compile 'com.github.YvesCheung.TouchEventBus:toucheventbus:1.4.3'
    }
    ```

## 许可证

Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

[1]: https://github.com/YvesCheung/TouchEventBus/blob/master/README_NESTEDSCROLL.md
  [2]: https://raw.githubusercontent.com/YvesCheung/TouchEventBus/master/img/touchEventBusInYYPreview.gif
  [3]: https://raw.githubusercontent.com/YvesCheung/TouchEventBus/master/img/touchOrder.png
  [4]: https://raw.githubusercontent.com/YvesCheung/TouchEventBus/master/img/TouchEventBus.png
  [5]: https://raw.githubusercontent.com/YvesCheung/TouchEventBus/master/img/TopoSort.png
  [6]: https://raw.githubusercontent.com/YvesCheung/TouchEventBus/master/img/dispatch.png
  [7]: https://raw.githubusercontent.com/YvesCheung/TouchEventBus/master/img/demoPreview.gif

TouchEventBus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README