NextATC Unicom

Guida di NextATCNextATC Guida e FAQ

Voce e Push-to-Talk

TTS, riconoscimento vocale, modalità PTT

NextATC ha due funzioni vocali separate. Sono indipendenti e possono essere attivate o disattivate una alla volta:

  • TTS (text-to-speech): il controllore parla. Tu leggi o ascolti.
  • Riconoscimento vocale (STT): tu parli. Il controllore ascolta.

Puoi usarle entrambe, solo una, oppure nessuna. Il Radio Log funziona sempre anche quando entrambe sono spente. Il plugin è completamente giocabile in modalità testo. Se la voce ti dà qualsiasi problema, torna alla modalità testo (vedi l'ultima sezione) e il tuo volo continua normalmente.

TTS — far parlare il controllore#

Apri Plugins -> NextATC -> Options e attiva:

  • Read ATC messages (TTS) — il controllore parla invece di limitarsi a scrivere nel Radio Log.

In Options -> Voice scegli Speech engine: Operating system (il default), Microsoft Azure, Kokoro (offline) o Piper (offline). Azure richiede configurazione; vedi Configurazione Azure. Il percorso del sistema operativo usa le voci installate sul computer. Kokoro e Piper sintetizzano localmente dopo che i loro modelli sono stati scaricati.

Disable voice on readback mantiene silenziosa la tua voce del pilota e fa parlare solo l'ATC. La maggior parte dei piloti lascia questa opzione attiva.

Voci locali: Kokoro e Piper#

NextATC include i propri motori Kokoro e Piper. A differenza dell'integrazione di X-ATC-Chatter con VoiceBox, queste voci non richiedono che VoiceBox o un'altra app separata sia in esecuzione.

  1. Apri Options -> Voice e scegli Kokoro (offline) o Piper (offline) in Speech engine. Si aprirà il catalogo voci; riaprilo con Voice roles / Download... quando serve.
  2. Seleziona le voci contrassegnate con Download, poi premi Download selected. Le voci consigliate sono preselezionate. Il download richiede connessione internet; la sintesi vocale avviene poi in locale. Cancel download interrompe il download; chiudendo il catalogo il download continua in background.
  3. Una volta installate, clicca una voce per selezionarla e ascoltare l’anteprima della voce pilota. Le caselle ATC scelgono il pool di voci per controllore/traffico.
  4. Usa Test current ATC o Test random ATC, poi Save voice roles. Mantieni Read ATC messages (TTS) abilitato e salva le Options al termine.

Disable voice on readback si applica anche alla voce pilota selezionata. Il volume e l’effetto "radio voice" funzionano con Azure, Kokoro e Piper, e su Windows anche con la voce del sistema operativo; su macOS e Linux la sintesi del sistema operativo usa il suo percorso audio nativo.

Cali di frame rate mentre parlano Kokoro o Piper#

Le voci locali vengono generate sulla CPU, quindi ogni trasmissione compete brevemente con il simulatore; gli aeroporti trafficati con molte comunicazioni radio del traffico lo rendono più evidente. Su macOS e Windows il processo di sintesi vocale gira già con priorità inferiore a X-Plane. Le voci locali più leggere sono le voci Piper con Light models attivo nel catalogo Piper (impostazione predefinita): richiedono circa otto volte meno CPU dei modelli Piper di alta qualità e sono contrassegnate come light. Per Kokoro, mantieni attivo Compact model (114 MB instead of 325 MB) (impostazione predefinita): richiede un po' meno CPU e disco del modello standard, con una qualità vocale leggermente inferiore. Entrambi mantengono le stesse voci; assicurati che i modelli selezionati siano scaricati con Download selected. Finché non sono installati, il motore continua a usare il modello già presente su disco. La voce di Microsoft Azure viene generata nel cloud e non usa la CPU locale per la sintesi.

Cosa indicano i due LED di attività del Radio Box?#

I due piccoli LED accanto a ATC/Ground Services mostrano separatamente le due sorgenti audio radio. Il LED verde più vicino al pulsante si accende mentre NextATC occupa la radio per la riproduzione TTS. Il LED ambra alla sua sinistra si accende mentre X-ATC-Chatter segnala che sta riproducendo un clip. Un LED vuoto indica che quella sorgente è inattiva; se entrambi si accendono insieme, le due sorgenti audio si stanno sovrapponendo.

Riconoscimento vocale — parlare al controllore#

Il riconoscimento vocale legge ciò che dici e lo trasforma in un readback o in un'azione. È una funzione sperimentale assistita da AI, ma non è una chat libera. La pipeline attuale è volutamente stretta:

  • Un modello ASR/STT trascrive l'audio del microfono in testo.
  • Il plugin confronta quel testo con il readback, il messaggio pilota o l'azione che il flusso ATC sta aspettando in quel momento.
  • Il flusso ATC lo accetta solo quando il contenuto operativo importante coincide: callsign, pista, altitudine, frequenza, squawk, prua e dati simili.

Questo mantiene deterministico il flusso di volo. Significa anche che una frase può essere trascritta correttamente e venire comunque rifiutata se il contenuto operativo non corrisponde a ciò che l'ATC sta aspettando.

Ha bisogno di:

  1. Un modello di riconoscimento installato. Apri Options e clicca un modello mancante sotto Voice Models per scaricarlo.
  2. Un microfono funzionante selezionato in Options -> Speech.
  3. Un tasto o pulsante joystick assegnato a NextATC/voice_push_to_talk.

Assegna il tasto in Settings -> Keyboard in X-Plane. Cerca NextATC e assegna voice_push_to_talk a un tasto che puoi tenere premuto comodamente (molti utenti scelgono lo 0 del tastierino numerico, un pulsante in cima allo stick, oppure il tasto Tab).

Modelli di riconoscimento e aspettative#

La pagina Options elenca diversi modelli di riconoscimento vocale, così puoi scegliere quello più adatto a microfono, accento, hardware e lingua. Questa area è ancora sperimentale: un modello più grande può essere più lento, occupare più spazio su disco o comportarsi diversamente dal modello base.

Parti da Whisper Base English. È l'opzione più prevedibile per readback ATC in inglese. Prova Whisper Small English o Whisper Medium English solo se ti serve una migliore gestione degli accenti e accetti una trascrizione locale più lenta. Se un modello selezionato è troppo lento o produce testo meno utile, torna a Whisper Base English.

Di default il riconoscimento usa i modelli Whisper in inglese. Attiva Multilingual model support solo se ti serve una gestione migliore di nomi di aeroporti, città o pronunce locali non inglesi. Questa opzione scarica la variante multilingua corrispondente alla taglia del modello selezionato, separata dal modello inglese. Quando il modello selezionato finisce il download, il riconoscimento vocale viene abilitato automaticamente e viene mostrato l'avviso sul push-to-talk.

Se all'avvio manca la variante attiva selezionata, il riconoscimento viene disabilitato invece di lasciare selezionato un modello inesistente.

L'accelerazione GPU velocizza l'elaborazione dell'audio del microfono da parte di Whisper; non genera la voce TTS del controllore. A parità di modello di riconoscimento, abilitare CUDA o Metal non garantisce trascrizioni più accurate. Se il riconoscimento sembra migliorato, controlla anche il modello selezionato, il microfono e l'audio registrato.

Quando nelle Options è disponibile Use GPU acceleration, seleziona Metal sui Mac Apple silicon supportati oppure NVIDIA CUDA su Windows. Il pacchetto Windows include il modulo CUDA e richiede CUDA Toolkit 12.8 o 12.9 installato sul PC. Riavvia X-Plane dopo averlo installato; Steam e le installazioni standalone funzionano allo stesso modo. CUDA gira in un modulo opzionale caricato separatamente dal plugin, quindi GPU, driver o runtime mancanti non possono impedire l'avvio di NextATC. Disattiva l'opzione per forzare la CPU. Gli errori recuperabili di setup GPU, inizializzazione del modello o inferenza ritentano sulla CPU; gli errori fatali nel runtime GPU upstream non sono recuperabili nello stesso processo.

La modalità multilingua lascia a Whisper il rilevamento automatico della lingua parlata. Non trasforma NextATC in una conversazione ATC non inglese: i termini di readback attesi da NextATC restano inglesi.

Tratta il riconoscimento vocale come uno strato di comodità sopra il Radio Log normale. È utile per immersione, ma i pulsanti testuali rimangono sempre il fallback affidabile.

Le due modalità PTT#

Ci sono due modi di usare il tasto PTT. Scegline uno e mantienilo.

Modalità Hold (la modalità radio)#

  • Premi e tieni premuto il tasto PTT.
  • Parla mentre tieni premuto.
  • Rilascia il tasto quando hai finito.

È così che funziona una radio vera. È la modalità di default e la più affidabile per la maggior parte degli utenti.

Modalità Toggle (premi una volta / premi di nuovo)#

  • Premi il tasto PTT una volta per iniziare ad ascoltare.
  • Parla.
  • Premi il tasto PTT una seconda volta per smettere di ascoltare.

La modalità toggle è utile se il tuo tasto PTT è difficile da tenere premuto (per esempio un singolo pulsante dello stick che usi anche per altro). In modalità toggle il plugin può anche fermare automaticamente l'ascolto dopo qualche secondo di silenzio.

La modalità attiva è configurata in Options -> Speech. Se la cambi, prova una volta a terra prima di farci affidamento in volo.

Il flusso completo di readback, passo dopo passo#

Questa è la sequenza che il controllore si aspetta:

  1. L'ATC dice qualcosa. Appare nel Radio Log (e viene pronunciato se il TTS è attivo).
  2. Il Radio Log mostra i pulsanti Readback e Say Again.
  3. Premi e tieni premuto (o toggle) il tuo tasto PTT.
  4. Pronuncia il readback. Esempio: "Climbing flight level two zero zero, AAL67".
  5. Il Radio Log mostra un'anteprima grigia con le parole che ha riconosciuto.
  6. Rilascia il tasto PTT (o premilo una seconda volta in modalità toggle).
  7. L'anteprima viene inviata. Se il readback corrisponde, l'ATC lo accetta e il Radio Log evidenzia il prompt accettato.

Se il readback non viene accettato, il controllore chiederà Say again. Vedi la sezione successiva.

"Trascrive correttamente ma l'ATC dice comunque Say Again"#

Questa è la confusione più comune. L'anteprima grigia significa che le parole sono state riconosciute dal microfono. Non significa ancora che il controllore le abbia accettate.

Cause, in ordine di probabilità:

  • Hai rilasciato il tasto PTT troppo presto o troppo tardi. Il riconoscitore si ferma al rilascio. Riprova con una pausa netta tra la tua ultima parola e il rilascio.
  • Hai usato una frase diversa da quella che il pulsante readback si aspetta. La formulazione esatta richiesta è suggerita sotto il pulsante Readback come piccola guida vocale. Adeguati. Non devi essere perfetto al millesimo, ma i numeri chiave (callsign, altitudine, pista, frequenza) devono essere presenti.
  • La trascrizione ha perso un numero (per esempio flight level invece di FL200). Pronuncia le cifre chiaramente: "two zero zero", non "two hundred".
  • Hai parlato prima che la radio fosse pronta. Aspetta che appaia il pulsante Readback prima di premere PTT.
  • Rumore di fondo o audio del gioco. Il plugin usa il microfono scelto in Options -> Speech. Con alcune combinazioni di cuffie, sistema operativo e driver, l'apertura del microfono Bluetooth può selezionare un profilo audio diverso; in quel caso la qualità può cambiare o possono comparire dei click. NextATC non può prevedere il comportamento di ogni dispositivo. Se lo noti, prova un microfono cablato o quello integrato nel computer.

In caso di dubbio, puoi sempre cliccare Readback con il mouse e saltare la voce. Il volo continua esattamente allo stesso modo.

"Non riesco a far funzionare la voce. Come torno alla modalità testo?"#

È sicuro e veloce. Non perderai il tuo volo.

  1. Apri Plugins -> NextATC -> Options.
  2. Disattiva Riconoscimento vocale AI (il lato input — lo STT).
  3. Opzionalmente disattiva Read ATC messages (TTS) se non vuoi nemmeno che il controllore parli.
  4. Assicurati che Radio Log sia Enabled. Questo è il flusso testuale.
  5. Chiudi Options.

Il Radio Log ora mostra ogni messaggio ATC come testo, e premi Readback / Say Again con il mouse o con il comando NextATC/handoff. Tutto il resto (clearance, taxi, salite, atterraggi) funziona allo stesso modo.

"Ho disabilitato la voce e ora non vedo nessun messaggio"#

Di solito sono spente due cose:

  • Radio Log -> Enabled è stato disattivato in Options.
  • OSD flash messages è stato disattivato e il TTS è spento, quindi niente parla e niente lampeggia.

Soluzione:

  1. Apri Options.
  2. Imposta Radio Log -> Enabled su on.
  3. Imposta Max visible lines ad almeno 4.
  4. Salva e chiudi.

Il Radio Log riappare al successivo messaggio ATC. Puoi anche cliccare il piccolo puntino di ancoraggio se Show anchor dot when hidden è abilitato, per riportarlo manualmente.

Se il riconoscimento vocale continua a fallire#

Controlla, in quest'ordine:

  • Microfono: un'altra app (un registratore vocale) sente la tua voce.
  • Modello installato: il modello selezionato è scaricato. La pagina Options mostra lo stato del download.
  • Lingua: i modelli Whisper in inglese sono il default. Attiva il supporto ai modelli multilingua solo se nomi locali non inglesi causano problemi di riconoscimento; la variante multilingua corrispondente va scaricata separatamente.
  • Supporto runtime: se un modello sperimentale più grande non produce testo, torna a Whisper Base English.
  • Tasto PTT: il comando X-Plane NextATC/voice_push_to_talk è assegnato a un solo tasto.
  • Hold vs Toggle: stai usando la modalità che hai configurato, non l'altra.

Se nulla aiuta, passa alla modalità testo e segnala il problema con un breve estratto di X-Plane/Log.txt e l'aeroporto/frequenza.

Voci SAPI5 su Windows#

Su Windows il motore vocale Operating system usa l'API vocale WinRT e le voci che questa API riporta. NextATC non usa SAPI5. Per avere più voci locali senza account cloud seleziona Kokoro (offline) o Piper (offline): entrambi sintetizzano in locale una volta scaricati i modelli vocali.

Vedi anche#