mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 10:34:30 +08:00
899fbd76c3
- 新增 Godot 场景行为基类和具体实现（Node2D、Node3D、Control、通用场景行为） - 添加场景行为工厂类，支持根据节点类型自动创建合适的行为实例 - 实现 Godot 场景工厂类，用于创建场景实例并集成场景注册表 - 添加 Godot 路径扩展方法，支持判断用户数据路径和资源路径 - 优化数据仓库和设置事件类的初始化方法，添加 XML 文档注释 - 修改场景切换管道中的日志记录逻辑，避免空引用异常 - 更新 Godot 日志记录器和日志工厂的文档注释 - 为设置相关类添加数据对象和类型属性的文档说明 - 移除加载进度处理器类，精简场景切换流程
63 lines
2.0 KiB
C#
63 lines
2.0 KiB
C#
using GFramework.Core.Abstractions.logging;
|
||
using GFramework.Core.extensions;
|
||
using GFramework.Core.logging;
|
||
using GFramework.Core.utility;
|
||
using GFramework.Game.Abstractions.ui;
|
||
|
||
namespace GFramework.Godot.ui;
|
||
|
||
/// <summary>
|
||
/// Godot UI工厂类，用于创建UI页面实例。
|
||
/// 继承自AbstractContextUtility并实现IUiFactory接口。
|
||
/// </summary>
|
||
public class GodotUiFactory : AbstractContextUtility, IUiFactory
|
||
{
|
||
/// <summary>
|
||
/// 日志记录器，用于记录调试信息。
|
||
/// </summary>
|
||
private static readonly ILogger Log =
|
||
LoggerFactoryResolver.Provider.CreateLogger(nameof(GodotUiFactory));
|
||
|
||
/// <summary>
|
||
/// UI注册表，用于管理UI场景资源。
|
||
/// </summary>
|
||
private IGodotUiRegistry _registry = null!;
|
||
|
||
/// <summary>
|
||
/// 根据指定的UI键创建UI页面实例。
|
||
/// </summary>
|
||
/// <param name="uiKey">UI页面的唯一标识符。</param>
|
||
/// <returns>返回创建的UI页面行为实例。</returns>
|
||
/// <exception cref="InvalidCastException">
|
||
/// 当UI场景未实现IUiPageBehaviorProvider接口时抛出异常。
|
||
/// </exception>
|
||
public IUiPageBehavior Create(string uiKey)
|
||
{
|
||
// 从注册表中获取指定UI键对应的场景
|
||
var scene = _registry.Get(uiKey);
|
||
|
||
// 实例化场景节点
|
||
var node = scene.Instantiate();
|
||
|
||
// 检查节点是否实现了IUiPageBehaviorProvider接口
|
||
if (node is not IUiPageBehaviorProvider provider)
|
||
throw new InvalidCastException(
|
||
$"UI scene {uiKey} must implement IUiPageBehaviorProvider");
|
||
|
||
// 获取页面行为实例
|
||
var page = provider.GetPage();
|
||
|
||
// 记录调试日志
|
||
Log.Debug("Created UI instance: {0}", uiKey);
|
||
return page;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 初始化方法，在对象初始化时调用。
|
||
/// 获取并设置UI注册表实例。
|
||
/// </summary>
|
||
protected override void OnInit()
|
||
{
|
||
_registry = this.GetUtility<IGodotUiRegistry>()!;
|
||
}
|
||
} |