Files
Alby96andClaude Opus 5.5 b1ee6879a7 F6: audio con bus, volumi, effetti, ambienti e musica per era
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>
2026-11-08 13:50:07 +01:00

92 lines
3.2 KiB
C#
Raw Permalink 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 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);
}
}