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

100 lines
3.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.Extensions;
using GFramework.Core.System;
using GFramework.Game.Abstractions.Setting;
using GFramework.Game.Setting.Events;
namespace GFramework.Game.Setting;
/// <summary>
/// 设置系统,负责管理和应用各种设置配置
/// </summary>
public class SettingsSystem : AbstractSystem, ISettingsSystem
{
private ISettingsModel _model = null!;
/// <summary>
/// 应用所有设置配置
/// </summary>
/// <returns>完成的任务</returns>
public async Task ApplyAll()
{
// 遍历所有设置应用器并尝试应用
foreach (var applicator in _model.AllApplicators()) await TryApplyAsync(applicator);
}
/// <summary>
/// 应用指定类型的设置配置
/// </summary>
/// <typeparam name="T">设置配置类型必须是类且实现IResetApplyAbleSettings接口</typeparam>
/// <returns>完成的任务</returns>
public Task Apply<T>() where T : class, IResetApplyAbleSettings
{
var applicator = _model.GetApplicator<T>();
return applicator != null
? TryApplyAsync(applicator)
: Task.CompletedTask;
}
/// <summary>
/// 保存所有设置数据到存储库
/// </summary>
/// <returns>完成的任务</returns>
public async Task SaveAll()
{
await _model.SaveAllAsync();
}
/// <summary>
/// 重置所有设置并应用更改
/// </summary>
/// <returns>异步任务</returns>
public async Task ResetAll()
{
_model.ResetAll();
await ApplyAll();
}
/// <summary>
/// 重置指定类型的设置并应用更改
/// </summary>
/// <typeparam name="T">设置类型必须实现IPersistentApplyAbleSettings接口且具有无参构造函数</typeparam>
/// <returns>异步任务</returns>
public async Task Reset<T>() where T : class, ISettingsData, IResetApplyAbleSettings, new()
{
_model.Reset<T>();
await Apply<T>();
}
/// <summary>
/// 初始化设置系统,获取设置模型实例
/// </summary>
protected override void OnInit()
{
_model = this.GetModel<ISettingsModel>()!;
}
/// <summary>
/// 尝试应用可应用的设置配置
/// </summary>
/// <param name="section">设置配置对象</param>
private async Task TryApplyAsync(ISettingsSection section)
{
if (section is not IApplyAbleSettings applyAbleSettings) return;
// 发送设置应用中事件
this.SendEvent(new SettingsApplyingEvent<ISettingsSection>(section));
try
{
await applyAbleSettings.Apply();
// 发送设置应用成功事件
this.SendEvent(new SettingsAppliedEvent<ISettingsSection>(section, true));
}
catch (Exception ex)
{
// 发送设置应用失败事件
this.SendEvent(new SettingsAppliedEvent<ISettingsSection>(section, false, ex));
}
}
}