GFramework/GFramework.Godot/UI/GodotUiFactory.cs
GeWuYou fb14d7122c docs(style): 更新文档中的命名空间导入格式
- 将所有小写的命名空间导入更正为首字母大写格式
- 统一 GFramework 框架的命名空间引用规范
- 修复 core、ecs、godot 等模块的命名空间导入错误
- 标准化文档示例代码中的 using 语句格式
- 确保所有文档中的命名空间引用保持一致性
- 更新 global using 语句以匹配正确的命名空间格式
2026-03-10 07:18:49 +08:00

63 lines
2.0 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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>()!;
}
}