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

62 lines
1.8 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.

namespace GFramework.Game.Abstractions.setting.data;
/// <summary>
/// 音频设置类,用于管理游戏中的音频配置
/// </summary>
public class AudioSettings : ISettingsData
{
/// <summary>
/// 获取或设置主音量,控制所有音频的总体音量
/// </summary>
public float MasterVolume { get; set; } = 1.0f;
/// <summary>
/// 获取或设置背景音乐音量控制BGM的播放音量
/// </summary>
public float BgmVolume { get; set; } = 0.8f;
/// <summary>
/// 获取或设置音效音量控制SFX的播放音量
/// </summary>
public float SfxVolume { get; set; } = 0.8f;
/// <summary>
/// 重置音频设置为默认值
/// </summary>
public void Reset()
{
// 重置所有音量设置为默认值
MasterVolume = 1.0f;
BgmVolume = 0.8f;
SfxVolume = 0.8f;
}
/// <summary>
/// 获取或设置设置数据的版本号
/// </summary>
public int Version { get; private set; } = 1;
/// <summary>
/// 获取设置数据最后修改的时间
/// </summary>
public DateTime LastModified { get; } = DateTime.Now;
/// <summary>
/// 从指定的数据源加载音频设置
/// </summary>
/// <param name="source">包含设置数据的源对象</param>
public void LoadFrom(ISettingsData source)
{
// 检查数据源是否为音频设置类型
if (source is not AudioSettings audioSettings)
{
return;
}
// 将源数据中的各个音量设置复制到当前对象
MasterVolume = audioSettings.MasterVolume;
BgmVolume = audioSettings.BgmVolume;
SfxVolume = audioSettings.SfxVolume;
Version = audioSettings.Version;
}
}