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 日志记录器和日志工厂的文档注释 - 为设置相关类添加数据对象和类型属性的文档说明 - 移除加载进度处理器类，精简场景切换流程
115 lines
4.0 KiB
C#
115 lines
4.0 KiB
C#
// Copyright (c) 2026 GeWuYou
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
//
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
using GFramework.Game.Abstractions.enums;
|
||
|
||
namespace GFramework.Game.Abstractions.scene;
|
||
|
||
/// <summary>
|
||
/// 场景过渡事件，封装了场景切换过程中的上下文信息。
|
||
/// 提供了场景切换的元数据和自定义上下文数据的存储能力。
|
||
/// </summary>
|
||
public sealed class SceneTransitionEvent
|
||
{
|
||
private readonly Dictionary<string, object> _context = new(StringComparer.Ordinal);
|
||
|
||
/// <summary>
|
||
/// 获取或初始化源场景的唯一标识符。
|
||
/// 表示切换前的场景，如果是首次加载场景则为 null。
|
||
/// </summary>
|
||
public string? FromSceneKey { get; init; }
|
||
|
||
/// <summary>
|
||
/// 获取或初始化目标场景的唯一标识符。
|
||
/// 表示切换后的场景，如果是清空操作则为 null。
|
||
/// </summary>
|
||
public string? ToSceneKey { get; init; }
|
||
|
||
/// <summary>
|
||
/// 获取或初始化场景过渡类型。
|
||
/// 指示当前执行的是哪种场景切换操作（Push/Pop/Replace/Clear）。
|
||
/// </summary>
|
||
public SceneTransitionType TransitionType { get; init; }
|
||
|
||
/// <summary>
|
||
/// 获取或初始化场景进入参数。
|
||
/// 包含传递给新场景的初始化数据或上下文信息。
|
||
/// </summary>
|
||
public ISceneEnterParam? EnterParam { get; init; }
|
||
|
||
/// <summary>
|
||
/// 从上下文中获取指定键的值。
|
||
/// </summary>
|
||
/// <typeparam name="T">值的类型。</typeparam>
|
||
/// <param name="key">上下文键。</param>
|
||
/// <param name="defaultValue">如果键不存在时返回的默认值。</param>
|
||
/// <returns>上下文中存储的值，如果键不存在则返回默认值。</returns>
|
||
public T Get<T>(string key, T defaultValue = default!)
|
||
{
|
||
if (_context.TryGetValue(key, out var value) && value is T typedValue)
|
||
return typedValue;
|
||
return defaultValue;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 设置上下文中指定键的值。
|
||
/// </summary>
|
||
/// <typeparam name="T">值的类型。</typeparam>
|
||
/// <param name="key">上下文键。</param>
|
||
/// <param name="value">要存储的值。</param>
|
||
public void Set<T>(string key, T value)
|
||
{
|
||
if (key == null)
|
||
throw new ArgumentNullException(nameof(key));
|
||
_context[key] = value!;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 尝试从上下文中获取指定键的值。
|
||
/// </summary>
|
||
/// <typeparam name="T">值的类型。</typeparam>
|
||
/// <param name="key">上下文键。</param>
|
||
/// <param name="value">输出参数，如果键存在则包含对应的值。</param>
|
||
/// <returns>如果键存在且类型匹配则返回 true，否则返回 false。</returns>
|
||
public bool TryGet<T>(string key, out T value)
|
||
{
|
||
if (_context.TryGetValue(key, out var obj) && obj is T typedValue)
|
||
{
|
||
value = typedValue;
|
||
return true;
|
||
}
|
||
|
||
value = default!;
|
||
return false;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 检查上下文中是否存在指定的键。
|
||
/// </summary>
|
||
/// <param name="key">上下文键。</param>
|
||
/// <returns>如果键存在则返回 true，否则返回 false。</returns>
|
||
public bool Has(string key)
|
||
{
|
||
return _context.ContainsKey(key);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 从上下文中移除指定的键。
|
||
/// </summary>
|
||
/// <param name="key">上下文键。</param>
|
||
/// <returns>如果键存在并成功移除则返回 true，否则返回 false。</returns>
|
||
public bool Remove(string key)
|
||
{
|
||
return _context.Remove(key);
|
||
}
|
||
} |