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的,收集标签方法然后注册到事件总线。

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

相关推荐
零度@15 小时前
Java消息中间件-Kafka全解(2026精简版)
java·kafka·c#·linq
2501_9418824816 小时前
在开普敦跨区域部署环境中构建高可靠分布式配置中心的设计思路与实现实践
开发语言·c#
神米米16 小时前
Maya快速安装UE4 布料权重绘制插件PhysX导出apx
游戏引擎·ue4·maya
WarPigs17 小时前
Unity阴影
unity·游戏引擎
zxy284722530117 小时前
利用C#的BotSharp本地部署第一个大模型AI Agent示例(1)
人工智能·c#·对话·ai agent·botsharp
刘975317 小时前
【第25天】25c#今日小结
java·开发语言·c#
一只一只17 小时前
Unity之Invoke
unity·游戏引擎·invoke
玩泥巴的18 小时前
基于.NET操作Excel COM组件生成数据透视报表
c#·.net·excel·二次开发·com互操作
马达加斯加D19 小时前
分布式系统开发核心问题总结
c#
钰fly19 小时前
DataGridView 与 DataTable 与csv 序列
前端·c#