GeWuYou 899fbd76c3 feat(godot): 添加 Godot 场景管理和路径扩展功能
- 新增 Godot 场景行为基类和具体实现(Node2D、Node3D、Control、通用场景行为)
- 添加场景行为工厂类,支持根据节点类型自动创建合适的行为实例
- 实现 Godot 场景工厂类,用于创建场景实例并集成场景注册表
- 添加 Godot 路径扩展方法,支持判断用户数据路径和资源路径
- 优化数据仓库和设置事件类的初始化方法,添加 XML 文档注释
- 修改场景切换管道中的日志记录逻辑,避免空引用异常
- 更新 Godot 日志记录器和日志工厂的文档注释
- 为设置相关类添加数据对象和类型属性的文档说明
- 移除加载进度处理器类,精简场景切换流程
2026-02-15 16:59:09 +08:00

54 lines
2.0 KiB
C#

using GFramework.Core.Abstractions.logging;
using GFramework.Core.logging;
using Godot;
namespace GFramework.Godot.logging;
/// <summary>
/// Godot平台的日志记录器实现。
/// 该类继承自 <see cref="AbstractLogger"/>,用于在 Godot 引擎中输出日志信息。
/// 支持不同日志级别的输出,并根据级别调用 Godot 的相应方法。
/// </summary>
/// <param name="name">日志记录器的名称,默认为根日志记录器名称。</param>
/// <param name="minLevel">最低日志级别,默认为 <see cref="LogLevel.Info"/>。</param>
public sealed class GodotLogger(
string? name = null,
LogLevel minLevel = LogLevel.Info) : AbstractLogger(name ?? RootLoggerName, minLevel)
{
/// <summary>
/// 写入日志的核心方法。
/// 格式化日志消息并根据日志级别调用 Godot 的输出方法。
/// </summary>
/// <param name="level">日志级别。</param>
/// <param name="message">日志消息内容。</param>
/// <param name="exception">可选的异常信息。</param>
protected override void Write(LogLevel level, string message, Exception? exception)
{
// 构造时间戳和日志前缀
var timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff");
var levelStr = level.ToString().ToUpper().PadRight(7);
var logPrefix = $"[{timestamp}] {levelStr} [{Name()}]";
// 添加异常信息到日志消息中
if (exception != null) message += "\n" + exception;
var logMessage = $"{logPrefix} {message}";
// 根据日志级别选择 Godot 输出方法
switch (level)
{
case LogLevel.Fatal:
GD.PushError(logMessage);
break;
case LogLevel.Error:
GD.PrintErr(logMessage);
break;
case LogLevel.Warning:
GD.PushWarning(logMessage);
break;
default: // Trace / Debug / Info
GD.Print(logMessage);
break;
}
}
}