Obsidian_Unity/项目学习/王国之梦制作/7.泛型事件框架(委托 事件 重难点).md

疑问

1.[TextArea]有什么作用?

[TextArea] 是一个用于 增强字符串字段编辑体验 的重要特性,他的作用是:

• 将普通的单行输入框变为 可伸缩的多行文本区域
• 支持 回车换行 和 文本滚动条
• 默认显示 3 行（可自定义最小/最大行数） 2.BaseEventSO当中为什么不使用UnityEvent而是用UnityAction. !

过程

Unity 事件系统框架解析（广播-监听模式）

系统架构图

[按钮对象] --广播--> [ObjectEventSO] --通知--> [门对象]
       ｜                  ｜
       ｜-- 触发按压动作    ｜-- 作为事件通道
                        ｜-- 连接监听器

一、核心组件说明

1. 广播系统 (EventSO)

1.1 BaseEventSO 基类

// 核心功能：管理事件订阅和广播机制
public class BaseEventSO<T> : ScriptableObject
{
    [TextArea] // 可视化描述字段
    public string description;
    
    // 事件订阅集合（使用object类型保持灵活性）
    public UnityAction<T> OnEventRaised; 
    
    // 调试信息字段
    public string lastSender;

    // 事件触发方法
    public void RaiseEvent(T value, object sender)
    {
        OnEventRaised?.Invoke(value);
        lastSender = sender.ToString(); // 记录最后发送者
    }
}

关键设计：

• 使用 ScriptableObject 实现全局事件通道
• 泛型设计支持多种参数类型
• lastSender 字段用于调试追踪

1.2 ObjectEventSO 具体实现

// 创建菜单项便于生成资产
[CreateAssetMenu(fileName = "ObjectEventSO", menuName = "Event/ObjectEventSO")]
public class ObjectEventSO : BaseEventSO<object> { }

使用场景：

• 需要传递任意类型参数时
• 通用对象交互场景
• 快速原型开发阶段

2. 监听系统 (EventListener)

2.1 BaseEventListener 基类

public class BaseEventListener<T> : MonoBehaviour
{
    [Header("事件配置")]
    public BaseEventSO<T> eventSO;  // 绑定的事件资产
    
    [Header("响应事件")]
    public UnityEvent<T> response; // 可视化配置的响应事件

    private void OnEnable()
    {
        if(eventSO != null)
            eventSO.OnEventRaised += OnEventRaised;
    }

    private void OnDisable()
    {
        if(eventSO != null)
            eventSO.OnEventRaised -= OnEventRaised;
    }

    private void OnEventRaised(T value)
    {
        response.Invoke(value); // 转发事件到UnityEvent
    }
}

生命周期管理：

• OnEnable：注册监听
• OnDisable：注销监听
• 自动化的订阅管理防止内存泄漏

2.2 ObjectEventListener 具体实现

public class ObjectEventListener : BaseEventListener<object> { }

扩展说明：

• 可创建特定类型的监听器（如IntEventListener）
• 保持基类的泛型灵活性

二、工作流程详解

1. 配置阶段

1. 创建 EventSO 资产

   • Assets右键 → Create → Event → ObjectEventSO

2. 配置广播者（按钮）

   • 添加事件触发脚本

   public class ButtonPressHandler : MonoBehaviour
   {
       public ObjectEventSO pressEvent;
   
       void OnMouseDown()
       {
           pressEvent.RaiseEvent(this, "DoorButton");
       }
   }
   

3. 配置监听者（门）

   • 添加 ObjectEventListener 组件
   • 绑定同一个 EventSO 资产
   • 配置 Response 事件链（示例）：
     • 添加 GameObject.SetActive(false)
     • 添加 Animator.Play("OpenDoor")