EventModule¶

继承链: System.Object → UnityEngine.Object → UnityEngine.Component → UnityEngine.Behaviour → UnityEngine.MonoBehaviour → Sirenix.OdinInspector.SerializedMonoBehaviour → Runestone.AesirArchitecture.AesirMonoBehaviour → EventModule

实现接口: Sirenix.Serialization.ISupportsPrefabSerialization，UnityEngine.ISerializationCallbackReceiver

声明¶

[DisallowMultipleComponent]
[DefaultExecutionOrder]
[AddComponentMenu]
public class EventModule : Runestone.AesirArchitecture.AesirMonoBehaviour, 
Sirenix.Serialization.ISupportsPrefabSerialization, 
UnityEngine.ISerializationCallbackReceiver

事件模块（MonoBehaviour 单例）。 通过 [AesirListener] 特性实现 Attribute 订阅，通过 AddListener{TEventArgs}(object, Action{TEventArgs}) 实现 Script 订阅， 通过 InvokeEvent{TEventArgs} 分发事件。 支持 4 档优先级排序分发与双轨订阅共存。两种订阅分别存储于独立注册表， 分发时合并并按优先级排序。

分发期可靠性：自动检测并清理已销毁的 Unity 对象订阅者（死引用）； 支持 WithFilter 声明的订阅者过滤器实现精确投递； 可通过 executionMsLimit 开启分发耗时告警。

快照语义与重入安全：每趟分发基于注册表快照迭代——回调内退订/注册只影响后续分发， 不干扰本趟；回调内同步发布事件（重入）使用独立的迭代缓冲区与参数数组， 外层分发不受覆写影响。发布者同理按快照校正：内层分发覆写共享参数实例的 Sender 后，外层遍历会把 Sender 重新校正回本趟发布者， 过滤器判定与订阅者读取均不受内层污染。性能计时（executionMsLimit）仅对顶层分发生效。 排序为 Priority 主键 + 注册序号次键的稳定排序，同优先级按注册顺序执行。

作为 AesirModules 的子物体存在，由 GetOrAddChild{T} 懒加载创建。

构造方法¶

EventModule()¶

public EventModule()

属性¶

声明的属性

继承的属性

Instance¶

全局单例入口。 优先在已加载场景中查找预放置的实例；未找到时在 AesirModules（DDOL）下创建子物体。

public static EventModule Instance { get; }

方法¶

声明的方法

继承的方法

AddListener(object, AesirEventArgs, Action)¶

添加 Script 订阅（非泛型版）。通过事件参数实例推断类型，反射适配。 默认优先级 Medium。

public static AutoRemoveListenerHandle AddListener(object subscriber, AesirEventArgs eventArgs, Action<AesirEventArgs> callback)

参数

返回值

AddListener(object, AesirEventArgs, SubscriberPriority, Action)¶

添加 Script 订阅（非泛型版），指定优先级。

public static AutoRemoveListenerHandle AddListener(object subscriber, AesirEventArgs eventArgs, SubscriberPriority priority, Action<AesirEventArgs> callback)

参数

返回值

AddListener(object, Action)¶

添加 Script 订阅。通过 Lambda 委托监听指定事件类型，无需 [AesirListener] 特性。 返回自动移除句柄，Dispose 或 using 块结束时自动注销。 默认优先级 Medium。

public static AutoRemoveListenerHandle AddListener<TEventArgs>(object subscriber, Action<TEventArgs> callback)

参数

返回值

AddListener(object, Action, SubscriberPriority)¶

添加 Script 订阅，指定优先级。返回自动移除句柄。

public static AutoRemoveListenerHandle AddListener<TEventArgs>(object subscriber, Action<TEventArgs> callback, SubscriberPriority priority)

参数

返回值

AddListener(object)¶

添加 Attribute 订阅者。反射扫描对象上标有 [AesirListener] 的方法并注册。 通常在 OnEnable 中调用。

public static void AddListener(object subscriber)

参数

InvokeEvent(object, TEventArgs)¶

触发事件。合并两个注册表的订阅者，按优先级排序后依次调用。 走非创建式获取：订阅表是实例字段，因此"不存在实例"等价于"不存在任何订阅者"， 分发无事可做——若走 Instance 会在场景卸载等时机重建 DDOL 宿主 （详见 TryGetExisting 的说明）。

public static void InvokeEvent<TEventArgs>(object sender, TEventArgs eventArgs)

参数

RemoveListener(object)¶

移除订阅者。从两个注册表中移除该对象的所有绑定（含 Attribute 和 Script）。 通常在 OnDisable 中调用。

public static void RemoveListener(object subscriber)

参数

Additional Notes¶

首个 ## Additional Notes 是增量生成文档标识符，请勿修改标题级别和内容！本文档由 Script Doc Generator 辅助生成。