[增加]1. 增加组件代理的激活和反激活前后的函数调用

Author: AlianBlank

GameFrameX.Core/Abstractions/Agent/IComponentAgent.cs

@@ -38,6 +38,15 @@ public interface IComponentAgent : IWorker
     /// </remarks>
     void SetOwner(IComponent owner);
 
+    /// <summary>
+    /// 组件激活前的回调方法
+    /// </summary>
+    /// <returns>表示异步操作的任务</returns>
+    /// <remarks>
+    /// 在组件开始激活流程前执行，可以用于进行一些预处理操作
+    /// </remarks>
+    Task BeforeActivation();
+
     /// <summary>
     /// 激活组件代理
     /// <remarks>
@@ -46,6 +55,24 @@ public interface IComponentAgent : IWorker
     /// </summary>
     Task Active();
 
+    /// <summary>
+    /// 组件激活后的回调方法
+    /// </summary>
+    /// <returns>表示异步操作的任务</returns>
+    /// <remarks>
+    /// 在组件完成激活流程后执行，可以用于处理一些初始化后的逻辑
+    /// </remarks>
+    Task AfterActivation();
+
+    /// <summary>
+    /// 组件反激活前的回调方法
+    /// </summary>
+    /// <returns>表示异步操作的任务</returns>
+    /// <remarks>
+    /// 在组件开始反激活流程前执行，可以用于保存状态或清理资源
+    /// </remarks>
+    Task BeforeInActivation();
+
     /// <summary>
     /// 反激活组件代理
     /// </summary>
@@ -55,6 +82,15 @@ public interface IComponentAgent : IWorker
     /// </remarks>
     Task Inactive();
 
+    /// <summary>
+    /// 组件反激活后的回调方法
+    /// </summary>
+    /// <returns>表示异步操作的任务</returns>
+    /// <remarks>
+    /// 在组件完成反激活流程后执行，可以用于确认清理完成或执行最终操作
+    /// </remarks>
+    Task AfterInActivation();
+
     /// <summary>
     /// 根据代理类型获取代理组件
     /// </summary>

GameFrameX.Core/Actors/Actor.cs

@@ -149,7 +149,9 @@ async Task Worker()
 
                     try
                     {
+                        await agent.AfterActivation();
                         await agent.Active();
+                        await agent.BeforeActivation();
                     }
                     catch (Exception e)
                     {
@@ -184,7 +186,9 @@ async Task Worker()
 
                 try
                 {
+                    await agent.AfterActivation();
                     await agent.Active();
+                    await agent.BeforeActivation();
                 }
                 catch (Exception e)
                 {

GameFrameX.Core/Components/BaseComponent.cs

@@ -86,7 +86,9 @@ public virtual async Task Inactive()
         var agent = GetAgent();
         if (agent != null)
         {
+            await agent.AfterInActivation();
             await agent.Inactive();
+            await agent.BeforeInActivation();
         }
 
         IsActive = false;

GameFrameX.Core/Hotfix/Agent/BaseComponentAgent.cs

@@ -67,14 +67,33 @@ public void SetOwner(IComponent owner)
         Owner = owner;
     }
 
+    /// <summary>
+    /// 组件激活前的预处理操作
+    /// </summary>
+    /// <returns>一个已完成的任务</returns>
+    public virtual Task BeforeActivation() => Task.CompletedTask;
+
     /// <summary>
     /// 激活组件
     /// </summary>
+    /// <returns>一个已完成的任务</returns>
     public virtual Task Active()
     {
         return Task.CompletedTask;
     }
 
+    /// <summary>
+    /// 组件激活后的后处理操作
+    /// </summary>
+    /// <returns>一个已完成的任务</returns>
+    public virtual Task AfterActivation() => Task.CompletedTask;
+
+    /// <summary>
+    /// 组件反激活前的预处理操作
+    /// </summary>
+    /// <returns>一个已完成的任务</returns>
+    public virtual Task BeforeInActivation() => Task.CompletedTask;
+
     /// <summary>
     /// 反激活组件
     /// </summary>
@@ -84,6 +103,12 @@ public virtual Task Inactive()
         return Task.CompletedTask;
     }
 
+    /// <summary>
+    /// 组件反激活后的后处理操作
+    /// </summary>
+    /// <returns>一个已完成的任务</returns>
+    public virtual Task AfterInActivation() => Task.CompletedTask;
+
     /// <summary>
     /// 根据代理类型获取组件代理实例
     /// </summary>