[增加]1. 增加获取组件的是否新建的参数

Author: AlianBlank

GameFrameX.Core/Abstractions/Agent/IComponentAgent.cs

@@ -1,71 +1,79 @@
-namespace GameFrameX.Core.Abstractions.Agent;
-
-/// <summary>
-/// 组件代理接口
-/// </summary>
-public interface IComponentAgent : IWorker
-{
-    /// <summary>
-    /// 获取Actor的唯一标识
+namespace GameFrameX.Core.Abstractions.Agent;
+
+/// <summary>
+/// 组件代理接口
+/// </summary>
+public interface IComponentAgent : IWorker
+{
+    /// <summary>
+    /// 获取Actor的唯一标识
     /// <remarks>
     /// 用于唯一标识一个Actor实例的ID值
     /// </remarks>
-    /// </summary>
-    long ActorId { get; }
-
-    /// <summary>
-    /// 获取或设置组件的所有者
+    /// </summary>
+    long ActorId { get; }
+
+    /// <summary>
+    /// 获取或设置组件的所有者
     /// <remarks>
     /// 表示当前组件所属的父级组件实例
     /// </remarks>
-    /// </summary>
-    IComponent Owner { get; }
-
-    /// <summary>
-    /// 获取所有者的类型
+    /// </summary>
+    IComponent Owner { get; }
+
+    /// <summary>
+    /// 获取所有者的类型
     /// <remarks>
     /// 表示所有者组件的类型标识，使用ushort类型存储
     /// </remarks>
-    /// </summary>
-    ushort OwnerType { get; }
-
-    /// <summary>
-    /// 设置组件的所有者
-    /// </summary>
+    /// </summary>
+    ushort OwnerType { get; }
+
+    /// <summary>
+    /// 设置组件的所有者
+    /// </summary>
     /// <param name="owner">所有者组件实例</param>
     /// <remarks>
     /// 用于设置或更改当前组件的所有者，建立组件间的从属关系
     /// </remarks>
-    void SetOwner(IComponent owner);
-
-    /// <summary>
-    /// 激活组件代理
+    void SetOwner(IComponent owner);
+
+    /// <summary>
+    /// 激活组件代理
     /// <remarks>
     /// 用于初始化并启用组件代理的功能
     /// </remarks>
-    /// </summary>
-    void Active();
-
-    /// <summary>
-    /// 反激活组件代理
-    /// </summary>
-    /// <returns>一个表示异步操作的任务</returns>
+    /// </summary>
+    void Active();
+
+    /// <summary>
+    /// 反激活组件代理
+    /// </summary>
+    /// <returns>一个表示异步操作的任务</returns>
     /// <remarks>
     /// 用于停用组件代理并清理相关资源，这是一个异步操作
     /// </remarks>
-    Task Inactive();
-
-    /// <summary>
-    /// 根据代理类型获取代理组件
-    /// </summary>
-    /// <param name="agentType">代理类型</param>
-    /// <returns>代理组件</returns>
-    public Task<IComponentAgent> GetComponentAgent(Type agentType);
-
-    /// <summary>
-    /// 根据泛型代理类型获取代理组件
-    /// </summary>
-    /// <typeparam name="T">代理组件的类型</typeparam>
-    /// <returns>代理组件</returns>
-    public Task<T> GetComponentAgent<T>() where T : IComponentAgent;
+    Task Inactive();
+
+    /// <summary>
+    /// 根据代理类型获取代理组件
+    /// </summary>
+    /// <param name="agentType">代理类型</param>
+    /// <param name="isNew">是否创建新实例，默认为true</param>
+    /// <returns>代理组件实例</returns>
+    /// <remarks>
+    /// 通过Type类型参数获取或创建对应的组件代理实例
+    /// </remarks>
+    public Task<IComponentAgent> GetComponentAgent(Type agentType, bool isNew = true);
+
+    /// <summary>
+    /// 根据泛型代理类型获取代理组件
+    /// </summary>
+    /// <typeparam name="T">代理组件的类型</typeparam>
+    /// <param name="isNew">是否创建新实例，默认为true</param>
+    /// <returns>指定类型的代理组件实例</returns>
+    /// <remarks>
+    /// 泛型方法版本，用于获取或创建指定类型的组件代理实例
+    /// </remarks>
+    public Task<T> GetComponentAgent<T>(bool isNew = true) where T : IComponentAgent;
 }

GameFrameX.Core/Hotfix/Agent/BaseComponentAgent.cs

@@ -84,23 +84,25 @@ public virtual Task Inactive()
     }
 
     /// <summary>
-    /// 根据代理类型获取组件
+    /// 根据代理类型获取组件代理实例
     /// </summary>
-    /// <param name="agentType">代理类型</param>
-    /// <returns>一个任务，返回组件代理实例</returns>
-    public Task<IComponentAgent> GetComponentAgent(Type agentType)
+    /// <param name="agentType">要获取的代理类型</param>
+    /// <param name="isNew">是否创建新的实例，true表示创建新实例，false表示获取已存在的实例</param>
+    /// <returns>返回一个异步任务，该任务完成时将返回指定类型的组件代理实例</returns>
+    public Task<IComponentAgent> GetComponentAgent(Type agentType, bool isNew = true)
     {
-        return Actor.GetComponentAgent(agentType);
+        return Actor.GetComponentAgent(agentType, isNew);
     }
 
     /// <summary>
-    /// 根据代理类型获取组件代理
+    /// 获取指定泛型类型的组件代理实例
     /// </summary>
-    /// <typeparam name="T">代理类型</typeparam>
-    /// <returns>一个任务，返回指定类型的组件代理实例</returns>
-    public Task<T> GetComponentAgent<T>() where T : IComponentAgent
+    /// <typeparam name="T">要获取的组件代理类型，必须实现IComponentAgent接口</typeparam>
+    /// <param name="isNew">是否创建新的实例，true表示创建新实例，false表示获取已存在的实例</param>
+    /// <returns>返回一个异步任务，该任务完成时将返回指定泛型类型的组件代理实例</returns>
+    public Task<T> GetComponentAgent<T>(bool isNew = true) where T : IComponentAgent
     {
-        return Actor.GetComponentAgent<T>();
+        return Actor.GetComponentAgent<T>(isNew);
     }
 
     /// <summary>