F6: audio con bus, volumi, effetti, ambienti e musica per era #48

Merged
Alby96 merged 2 commits from claude/f6-audio into main 2026-11-08 14:11:58 +01:00
Owner

Cosa cambia e perché

Il gioco ora ha l'audio (ADR 0022). Tutti i suoni si sintetizzano nel client all'avvio, su un thread a parte, con semi fissi: niente file audio con licenze incerte e niente download.

  • Bus: Master (con limitatore), Music, Ambience, Sfx e Ui, creati da codice. Volumi e muto si salvano in user://settings.cfg; si regolano dal menu e dall'altoparlante nella barra superiore, e il tasto M attiva il muto.
  • Interfaccia: clic, conferma ed errore sugli esiti dei comandi, tre suoni di notifica e uno per la costruzione completata.
  • Treni: fino a 3 treni in marcia vicino al centro dello schermo hanno il rumore di marcia, e secondo la trazione il ritmo del vapore, il diesel o l'elettrico. Il suono segue velocità, distanza e zoom e si ferma con la pausa o quando il moto non si aggiorna più.
  • Ambiente: vento, acqua, mare, città e uccelli, miscelati in base al terreno inquadrato e allo zoom.
  • Musica: un tema di 16 battute per ogni era, generato in modo deterministico, con dissolvenza al cambio d'era.
  • Il pilota automatico e l'avvio senza schermo non generano audio.
  • Il client non contiene logica di gioco e nulla fuori dal client è cambiato.

Due revisori hanno trovato 10 rilievi, tutti chiusi. Il fischio all'arrivo in stazione è stato tolto: all'arrivo il server smette di mandare il moto del treno (Projection.Motion restituisce null), quindi il client non può sapere quando suonarlo. Il limite è scritto nell'ADR 0022.

Closes #46

Fase

F6

Verifica

  • scripts/build.sh verde
  • scripts/test.sh --skip-slow verde: 175 su 175
  • Client: 0 avvisi, 0 errori
  • Classi di sintesi provate a parte: nessun NaN, picchi tra 0,42 e 0,6, cicli senza salti, temi identici a ogni generazione
  • docs/STATE.md e ARCHITECTURE.md aggiornati, ADR 0022
  • Ascolto in Godot: non possibile qui, i timbri andranno tarati all'ascolto

🤖 Generated with Claude Code

## Cosa cambia e perché Il gioco ora ha l'audio (ADR 0022). Tutti i suoni si sintetizzano nel client all'avvio, su un thread a parte, con semi fissi: niente file audio con licenze incerte e niente download. - **Bus:** Master (con limitatore), Music, Ambience, Sfx e Ui, creati da codice. Volumi e muto si salvano in `user://settings.cfg`; si regolano dal menu e dall'altoparlante nella barra superiore, e il tasto M attiva il muto. - **Interfaccia:** clic, conferma ed errore sugli esiti dei comandi, tre suoni di notifica e uno per la costruzione completata. - **Treni:** fino a 3 treni in marcia vicino al centro dello schermo hanno il rumore di marcia, e secondo la trazione il ritmo del vapore, il diesel o l'elettrico. Il suono segue velocità, distanza e zoom e si ferma con la pausa o quando il moto non si aggiorna più. - **Ambiente:** vento, acqua, mare, città e uccelli, miscelati in base al terreno inquadrato e allo zoom. - **Musica:** un tema di 16 battute per ogni era, generato in modo deterministico, con dissolvenza al cambio d'era. - Il pilota automatico e l'avvio senza schermo non generano audio. - Il client non contiene logica di gioco e nulla fuori dal client è cambiato. Due revisori hanno trovato 10 rilievi, tutti chiusi. Il fischio all'arrivo in stazione è stato tolto: all'arrivo il server smette di mandare il moto del treno (`Projection.Motion` restituisce null), quindi il client non può sapere quando suonarlo. Il limite è scritto nell'ADR 0022. Closes #46 ## Fase F6 ## Verifica - [x] `scripts/build.sh` verde - [x] `scripts/test.sh --skip-slow` verde: 175 su 175 - [x] Client: 0 avvisi, 0 errori - [x] Classi di sintesi provate a parte: nessun NaN, picchi tra 0,42 e 0,6, cicli senza salti, temi identici a ogni generazione - [x] `docs/STATE.md` e `ARCHITECTURE.md` aggiornati, ADR 0022 - [ ] Ascolto in Godot: non possibile qui, i timbri andranno tarati all'ascolto 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 added 2 commits 2026-11-08 14:06:56 +01:00
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>
F6: audio, correzioni della revisione
CI / Build e test (pull_request) Successful in 1m32s
CI / Immagine Docker (pull_request) Successful in 31s
e75c8e1586
I treni suonano solo se si sentono davvero e solo mentre il server li dà in
marcia; il fischio all'arrivo, che non poteva mai suonare, è tolto.

- Il client non riceve mai un moto Loading (all'arrivo il percorso si svuota e
  Projection.Motion non manda nulla): via fischio e tromba all'arrivo da
  AudioManager e documenti; tornerà con una modifica del protocollo decisa a
  parte. Synth.SteamWhistle e Synth.Horn restano pronti.
- Un treno suona solo con un moto ricevuto da meno di 500 ms
  (GameSession.MotionReceivedMs): fermo in stazione o fuori dalla zona
  sottoscritta tace invece di restare sull'ultimo moto Moving.
- I candidati oltre metà diagonale non prendono un canale: niente Play e Stop
  a ogni fotogramma.
- Clic dei pulsanti collegato una volta sola (IsConnected con un Callable
  preparato): MarketPanel riattacca il TradeBox a ogni resoconto.
- Volumi e muto si salvano all'uscita del pannello e di AudioManager se
  cambiati, anche chiudendo la finestra con il pannello aperto; lo sfondo
  chiude solo con il clic sinistro, non con rotella o tasto destro.
- Sbuffi da 1,2 a 10 al secondo fino a 30 m/s, in modo lineare: seguono la
  velocità su tutto l'esercizio; ADR corretto (non è il passo della ruota).
- Tabelle d'onda dei temi limitate alle armoniche sotto il 45 % della
  frequenza di campionamento per nota: niente ripiegamento oltre Nyquist.

Refs #46.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alby96 merged commit e1d47fff54 into main 2026-11-08 14:11:58 +01:00
Alby96 deleted branch claude/f6-audio 2026-11-08 14:12:01 +01:00
Sign in to join this conversation.