mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 19:03:29 +08:00
899fbd76c3
- 新增 Godot 场景行为基类和具体实现（Node2D、Node3D、Control、通用场景行为） - 添加场景行为工厂类，支持根据节点类型自动创建合适的行为实例 - 实现 Godot 场景工厂类，用于创建场景实例并集成场景注册表 - 添加 Godot 路径扩展方法，支持判断用户数据路径和资源路径 - 优化数据仓库和设置事件类的初始化方法，添加 XML 文档注释 - 修改场景切换管道中的日志记录逻辑，避免空引用异常 - 更新 Godot 日志记录器和日志工厂的文档注释 - 为设置相关类添加数据对象和类型属性的文档说明 - 移除加载进度处理器类，精简场景切换流程
70 lines
2.3 KiB
C#
70 lines
2.3 KiB
C#
using GFramework.Game.Abstractions.setting;
|
||
using GFramework.Game.Abstractions.setting.data;
|
||
using GFramework.Godot.setting.data;
|
||
using Godot;
|
||
|
||
namespace GFramework.Godot.setting;
|
||
|
||
/// <summary>
|
||
/// Godot音频设置实现类，用于应用音频配置到Godot音频系统
|
||
/// </summary>
|
||
/// <param name="model">设置模型对象，提供音频设置数据访问</param>
|
||
/// <param name="audioBusMap">音频总线映射对象，定义了不同音频类型的总线名称</param>
|
||
public class GodotAudioSettings(ISettingsModel model, AudioBusMap audioBusMap)
|
||
: IResetApplyAbleSettings
|
||
{
|
||
/// <summary>
|
||
/// 应用音频设置到Godot音频系统
|
||
/// </summary>
|
||
/// <returns>表示异步操作的任务</returns>
|
||
public Task Apply()
|
||
{
|
||
var settings = model.GetData<AudioSettings>();
|
||
SetBus(audioBusMap.Master, settings.MasterVolume);
|
||
SetBus(audioBusMap.Bgm, settings.BgmVolume);
|
||
SetBus(audioBusMap.Sfx, settings.SfxVolume);
|
||
return Task.CompletedTask;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 重置音频设置为默认值
|
||
/// </summary>
|
||
public void Reset()
|
||
{
|
||
model.GetData<AudioSettings>().Reset();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 获取音频设置的数据对象。
|
||
/// 该属性提供对音频设置数据的只读访问。
|
||
/// </summary>
|
||
public ISettingsData Data { get; } = model.GetData<AudioSettings>();
|
||
|
||
/// <summary>
|
||
/// 获取音频设置数据的类型。
|
||
/// 该属性返回音频设置数据的具体类型信息。
|
||
/// </summary>
|
||
public Type DataType { get; } = typeof(AudioSettings);
|
||
|
||
/// <summary>
|
||
/// 设置指定音频总线的音量
|
||
/// </summary>
|
||
/// <param name="busName">音频总线名称</param>
|
||
/// <param name="linear">线性音量值（0-1之间）</param>
|
||
private static void SetBus(string busName, float linear)
|
||
{
|
||
// 获取音频总线索引
|
||
var idx = AudioServer.GetBusIndex(busName);
|
||
if (idx < 0)
|
||
{
|
||
GD.PushWarning($"Audio bus not found: {busName}");
|
||
return;
|
||
}
|
||
|
||
// 将线性音量转换为分贝并设置到音频总线
|
||
AudioServer.SetBusVolumeDb(
|
||
idx,
|
||
Mathf.LinearToDb(Mathf.Clamp(linear, 0.0001f, 1f))
|
||
);
|
||
}
|
||
} |