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

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

相关推荐
向上的车轮8 小时前
为什么.NET(C#)转 Java 开发时常常在“吐槽”Java:checked exception
java·c#·.net
心疼你的一切9 小时前
Unity异步编程神器:Unitask库深度解析(功能+实战案例+API全指南)
深度学习·unity·c#·游戏引擎·unitask
呆呆敲代码的小Y11 小时前
【Unity 实用工具篇】 | Book Page Curl 快速实现翻书效果
游戏·unity·游戏引擎·u3d·免费游戏·翻书插件
.房东的猫20 小时前
ERP(金蝶云星空)开发【安装篇】
c#
AC梦1 天前
unity中如何将UI上的字高清显示
ui·unity
fie88891 天前
基于C#的推箱子小游戏实现
开发语言·c#
.房东的猫1 天前
ERP(金蝶云星空)开发【业务数据中心创建和注册】
c#
bugcome_com1 天前
C# 进阶核心知识点汇总|多项目开发 + 委托 + Lambda + 事件一次吃透
c#
SunflowerCoder1 天前
基于插件化 + Scriban 模板引擎的高效 HTTP 协议中心设计
http·c#
青云计划1 天前
知光项目用户关系模块
c#·linq