7.事件-Event

GameFramework事件管理

类图

    classDiagram

    EventComponent --> EventManager
    EventManager --> EventPool~GameEventArgs~
    EventPool~GameEventArgs~ o--> EventHandler~GameEventArgs~
    EventPool~GameEventArgs~ o--> Event~GameEventArgs~
    EventHandler~GameEventArgs~ <|-- YourEventHandler

    EventComponent : 入口
    EventManager : 事件管理器 
    EventPool~GameEventArgs~ ：事件池，真实管理事件的地方
    EventHandler~GameEventArgs~ : 事件监听器
    YourEventHandler : 你的事件监听器
    Event~GameEventArgs~ : 事件对象

使用

    //  定义你的事件参数
    public sealed class ShowEntitySuccessEventArgs : GameEventArgs
    {
        //  定义一个唯一编号
        public static readonly int EventId = typeof(ShowEntitySuccessEventArgs).GetHashCode();

        //  必须重载 Id
        public override int Id
        {
            get
            {
                return EventId;
            }
        }
        
        //  增加你的事件参数
        public float Duration;
    }

    class Test : MonoBehaviour
    {
        void Start()
        {
            //  注册监听器
            GameEntry.GetComponent<EventComponent>().Subscribe(ShowEntitySuccessEventArgs.EventId, OnShowEntitySuccess);
        }

        void OnDestroy()
        {
            //  取消监听
            GameEntry.GetComponent<EventComponent>().Unsubscribe(ShowEntitySuccessEventArgs.EventId, OnShowEntitySuccess);
        }

        void OnShowEntitySuccess(object sender, GameEventArgs e)
        {
            //  处理事件
            ShowEntitySuccessEventArgs args = (ShowEntitySuccessEventArgs)e;
        }

        void DoSomething()
        {
            //  派发事件
            GameEntry.GetComponent<EventComponent>().Fire(this, new ShowEntitySuccessEventArgs{Duration=5});
        }
    }
    

代码分析

    //  注册监听器
    EventManager.Subscribe(int id, EventHandler<GameEventArgs> handler)
    {
        m_EventPool.Subscribe(id, handler)  //  EventPool<GameEventArgs>.Subscribe
        {
            m_EventHandlers.Add(id, handler);
        }
    }

    //  派发事件
    EventManager.Update(float elapseSeconds, float realElapseSeconds)
    {
        m_EventPool.Update(elapseSeconds, realElapseSeconds)    //  EventPool<GameEventArgs>.Update
        {
            Event eventNode = m_Events.Dequeue();
            HandleEvent(eventNode.Sender, eventNode.EventArgs)  //  EventPool<GameEventArgs>.HandleEvent
            {
                if (m_EventHandlers.TryGetValue(e.Id, out range))
                {
                    foreach ( var eventHandler in m_EventHandlers )
                        eventHandler(sender, args);
                }
            }
        }
    }