GeWuYou 7d581f07ca feat(settings): 重构设置系统架构以支持数据仓库模式
- 为 ILoadableFrom 接口添加 XML 文档注释
- 重命名 UnifiedSettingsRepository 为 UnifiedSettingsDataRepository
- 将仓库基类从 IDataRepository 替换为更具体的 ISettingsDataRepository
- 为 UnifiedSettingsDataRepository 添加完整的 XML 文档注释
- 在 SettingsModel 中使用 ISettingsDataRepository 替代 IDataRepository
- 修改 SettingsModel 中的应用器存储结构从 ConcurrentBag 到 ConcurrentDictionary
- 添加 LoadAllAsync 方法以支持批量加载所有设置数据
- 优化 SettingsModel 初始化逻辑以使用批量加载提高性能
- 为 AudioSettings、GraphicsSettings 和 LocalizationSettings 添加 LoadFrom 实现
- 将设置数据版本属性改为私有只读以防止外部修改
- 更新 SettingsSystem 接口约束以匹配新的抽象层设计
- 添加 GetApplicator 泛型方法以支持获取特定类型的应用器
- 实现 Reset 泛型方法以支持重置指定类型的设置数据
- [release ci]
2026-01-30 21:16:31 +08:00

41 lines
1.3 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.system;
namespace GFramework.Game.Abstractions.setting;
/// <summary>
/// 定义设置系统的接口,提供应用各种设置的方法
/// </summary>
public interface ISettingsSystem : ISystem
{
/// <summary>
/// 应用所有可应用的设置
/// </summary>
/// <returns>表示异步操作的任务</returns>
Task ApplyAll();
/// <summary>
/// 应用指定类型的设置(泛型版本)
/// </summary>
/// <typeparam name="T">设置类型必须是class且实现IResetApplyAbleSettings接口</typeparam>
/// <returns>表示异步操作的任务</returns>
Task Apply<T>() where T : class, IResetApplyAbleSettings;
/// <summary>
/// 保存所有设置
/// </summary>
/// <returns>表示异步操作的任务</returns>
Task SaveAll();
/// <summary>
/// 重置指定类型的设置
/// </summary>
/// <typeparam name="T">设置类型必须继承自class并实现IPersistentApplyAbleSettings接口</typeparam>
/// <returns>表示异步操作的任务</returns>
Task Reset<T>() where T : class, ISettingsData, IResetApplyAbleSettings, new();
/// <summary>
/// 重置所有设置
/// </summary>
/// <returns>表示异步操作的任务</returns>
Task ResetAll();
}