Il client ora ha l'audio della F6 senza file esterni né download: effetti, anelli d'ambiente e temi musicali si sintetizzano in memoria all'avvio, su un altro thread, con classi senza dipendenze da Godot (Synth, MusicComposer, AudioMix) e semi fissi. - Bus Master, Music, Ambience, Sfx, Ui creati da codice in modo idempotente, limitatore sul Master; volumi per bus e muto in user://settings.cfg; pannello «Audio» dal menu e dall'altoparlante della barra superiore, tasto M. - AudioManager (figlio di Main) reagisce solo a ciò che il client riceve: clic dei pulsanti, esiti dei comandi, notifiche per gravità, cantieri completati dal DailyDigest, fischio o tromba all'arrivo in stazione, fino a 3 treni vicini al centro con rotolamento, motore e sbuffi modulati dalla velocità, ambiente dal terreno visibile e dallo zoom, tema per era con dissolvenza. - Nessuna allocazione nel ciclo per fotogramma; audio spento nel pilota automatico e senza schermo. - ADR 0022, STATE e ARCHITECTURE aggiornati; testi in strings.csv. Non ascoltato: Godot non è eseguibile qui. Funzioni pure provate a parte. Refs #46. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
92 lines
3.2 KiB
C#
92 lines
3.2 KiB
C#
using Godot;
|
||
|
||
namespace RailEnterprise.Client.Audio;
|
||
|
||
/// <summary>Bus audio del client: Master e quattro bus che vi confluiscono.</summary>
|
||
public static class AudioBuses
|
||
{
|
||
public const string Master = "Master";
|
||
public const string Music = "Music";
|
||
public const string Ambience = "Ambience";
|
||
public const string Sfx = "Sfx";
|
||
public const string Ui = "Ui";
|
||
|
||
/// <summary>Nell'ordine dei cursori delle impostazioni.</summary>
|
||
public static readonly string[] All = [Master, Music, Ambience, Sfx, Ui];
|
||
|
||
/// <summary>
|
||
/// Crea i bus che mancano (idempotente: chiamarla più volte non ne aggiunge altri) e un
|
||
/// limitatore sul Master, così la somma di musica, ambiente ed effetti non satura.
|
||
/// </summary>
|
||
public static void Ensure()
|
||
{
|
||
foreach (string name in All)
|
||
{
|
||
if (name == Master || AudioServer.GetBusIndex(name) >= 0) continue;
|
||
int index = AudioServer.BusCount;
|
||
AudioServer.AddBus(index);
|
||
AudioServer.SetBusName(index, name);
|
||
AudioServer.SetBusSend(index, Master);
|
||
}
|
||
bool limited = false;
|
||
for (int i = 0; i < AudioServer.GetBusEffectCount(0); i++)
|
||
{
|
||
if (AudioServer.GetBusEffect(0, i) is AudioEffectHardLimiter) limited = true;
|
||
}
|
||
if (!limited) AudioServer.AddBusEffect(0, new AudioEffectHardLimiter { CeilingDb = -0.5f });
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Volumi per bus (0–1) e muto generale, salvati nella sezione «audio» di
|
||
/// <c>user://settings.cfg</c> (lo stesso file della lingua e del server).
|
||
/// </summary>
|
||
public sealed class AudioSettings
|
||
{
|
||
public const string Path = "user://settings.cfg";
|
||
private const string Section = "audio";
|
||
|
||
private static readonly float[] Defaults = [0.8f, 0.55f, 0.7f, 0.8f, 0.7f];
|
||
|
||
/// <summary>Volumi nell'ordine di <see cref="AudioBuses.All"/>.</summary>
|
||
public float[] Volumes { get; } = (float[])Defaults.Clone();
|
||
|
||
public bool Muted { get; set; }
|
||
|
||
public static AudioSettings Load()
|
||
{
|
||
var s = new AudioSettings();
|
||
var cfg = new ConfigFile();
|
||
if (cfg.Load(Path) != Error.Ok) return s;
|
||
for (int i = 0; i < AudioBuses.All.Length; i++)
|
||
{
|
||
float v = (float)(double)cfg.GetValue(Section, Key(i), Defaults[i]);
|
||
s.Volumes[i] = Math.Clamp(v, 0, 1);
|
||
}
|
||
s.Muted = (bool)cfg.GetValue(Section, "muted", false);
|
||
return s;
|
||
}
|
||
|
||
public void Save()
|
||
{
|
||
var cfg = new ConfigFile();
|
||
cfg.Load(Path);
|
||
for (int i = 0; i < AudioBuses.All.Length; i++) cfg.SetValue(Section, Key(i), Volumes[i]);
|
||
cfg.SetValue(Section, "muted", Muted);
|
||
cfg.Save(Path);
|
||
}
|
||
|
||
private static string Key(int i) => AudioBuses.All[i].ToLowerInvariant();
|
||
|
||
/// <summary>Applica volumi e muto ai bus (il cursore segue il volume percepito: guadagno = valore²).</summary>
|
||
public void Apply()
|
||
{
|
||
for (int i = 0; i < AudioBuses.All.Length; i++)
|
||
{
|
||
int bus = AudioServer.GetBusIndex(AudioBuses.All[i]);
|
||
if (bus >= 0) AudioServer.SetBusVolumeDb(bus, AudioMix.LinearToDb(Volumes[i] * Volumes[i]));
|
||
}
|
||
AudioServer.SetBusMute(0, Muted);
|
||
}
|
||
}
|