SiYangUnityEventSystem,一个Unity中的事件系统

这是完全借助AI设计实现的一个Unity中的事件系统。

零、仓库

SiYangUnityEventSystem仓库

一、需求

  1. 方便的、统一的调用入口。
  2. 每个事件可以被写作一个Struct或者Class,事件的参数就在Struct或Class中声明。
  3. 基础的观察者模式事件相关功能。观察者订阅,被观察者发布事件,一个事件总线管理类负责管理。
  4. 事件系统的发布(Publish)过程 0GC,订阅阶段允许初始化 GC(反射扫描、创建订阅对象),过程中没有装箱拆箱。
  5. 通常的订阅和取消订阅的代码会卸载OnEnable和OnDisable中,但是这些代码是和业务逻辑无关的,占用书写类代码的空间让阅读代码不友好。让订阅、取消代码放在一个公共父类中或同GameObject的其他类中自动扫描。

二、具体设计

2.1 方便、统一的调用入口

cs 复制代码
/// <summary>
    /// 提供一个全局静态事件总线。
    /// 大多数情况下你可以直接用 SiYangEventBus.Global。
    /// </summary>
    public static class SiYangEventBus
    {
        /// <summary>
        /// 全局事件总线实例。
        /// </summary>
        public static readonly IEventBus Global = new EventBus();
    }

使用这个框架时候的代码都是类似:

SiYangEventBus.Global.XXX();

2.2 观察者模式实现事件管理

2.2.1 一个事件总线管理类负责管理

核心是:

复制代码
private readonly Dictionary<Type, ISubscriptionList> _subscriptions = new(32);

Key是Type,即事件Class或者Struct的Type,这样每个事件就对应了一组这个事件的观察者列表。

复制代码
/// <summary>
/// 某个具体事件类型 T 的订阅列表。
/// </summary>
private sealed class SubscriptionList<T> : ISubscriptionList

{

复制代码
        private readonly List<EventSubscription<T>> _list = new(32);

}

List<EventSubscription<T>> _list 是真正的观察者列表。

2.2.2 订阅、发布、清理

定义接口

cs 复制代码
public interface IEventBus
    {
        IDisposable Subscribe<T>(Action<T> handler, object owner = null, int priority = 0);

        void Publish<T>(T evt);

        /// <summary>
        /// 清除所有订阅。
        /// 通常只在切场景或重置系统时使用。
        /// </summary>
        void Clear();
    }

总线管理实现:

cs 复制代码
public sealed class EventBus : IEventBus
{
    private readonly Dictionary<Type, ISubscriptionList> _subscriptions = new(32);
    
    public IDisposable Subscribe<T>(Action<T> handler, object owner = null, int priority = 0)  {
        // 注册事件,向_subscriptions 添加 观察者,保存handler。
    }

    public void Publish<T>(T evt)
    {
        // 发布事件,从_subscriptions 拿 观察者list,执行观察者记录的Action handler
    }

    // 开发主动调用
    public void Clear()
    {
        
            _subscriptions.Clear();
        
    }
}

2.3 低GC,在订阅、发布流程中0GC

  1. 使用泛型,没有装箱拆箱。

  2. List只扩容不缩容。

  3. 不适用linq/Foreach,只用while或for。

2.4 不在类的Onenable和OnDisable中写

注册时间和取消注册时间都是业务逻辑无关代码,不写在类中。但是事件的逻辑要卸载类中。

最好达到下面的效果:

class A

{

一个标签代表这是个事件的观察者

private void SomeEventListener(SomeEvent event)

{

// 事件触发的逻辑

}

}

  1. 思路1 继承一个父类,父类收集子类的标签方法,然后将其注册到事件总线。

  2. 思路2 让A继承一个接口I,挂在A方法的物体上挂载一个脚本Host,Host脚本收集所有的component,如果是继承接口I的,收集标签方法然后注册到事件总线。

这样注册和停止注册的代码就转移到了其他地方。

相关推荐
曹牧1 小时前
C#:文本文件读取
服务器·前端·c#
2601_967338711 小时前
C#上位机开发零基础入门到精通全套视频
开发语言·c#
czhc11400756636 小时前
2026-09-03 博客:配置与密码 · 合并代码 · 超时排查
c#
格林威9 小时前
C#图像夜间识别率提升:使用OpenCvSharp和Halcon融合DeepSORT实现复杂场景下准确识别
开发语言·人工智能·数码相机·机器学习·计算机视觉·c#·视觉检测
郝学胜-神的一滴9 小时前
CMake 047:解锁安装阶段自定义操作,告别配置阶段提前执行坑
运维·服务器·c++·游戏引擎·图形渲染·opengl
曹牧10 小时前
C#:线程间操作无效,不是从创建控件线程访问
开发语言·c#
anlog19 小时前
ini文件读取,EXE同目录文件读取
c#·ini
rockey62719 小时前
AScript之编译递归函数
c#·.net·script·动态脚本
yue0081 天前
winform控件篇-按钮
c#
微三云生态系统架构师-彭丹1 天前
任务卷轴积分系统架构设计:从任务状态机到合规风控的完整实现
unity·系统架构·游戏引擎