NextATC Unicom

Guida di NextATCGuida utente di NextATC

12. Opzioni

Apri:

Plugins -> NextATC -> Options

12.1 Generale#

  • Autostart on X-Plane startup: avvia automaticamente l'ATC.
  • Schermata iniziale: mostra lo splash all'avvio del plugin.
  • Auto-tune COM1 for first flight-plan request: sintonizza la prima frequenza clearance valida quando inizi il primo filing.
  • Random flight on start: sceglie una partenza casuale e inserisce automaticamente un random flight allo startup.
  • Automatic update checks: controlla nuove versioni all'avvio.
  • Filtri regione: scegli quali regioni può usare il sistema random flight.
  • Export GeoJSON files: scrive file geometria rotta per ispezione.
  • Enable Debug: aggiunge dettagli di supporto nel log.
  • GUI animations: abilita o disabilita animazioni UI.
  • Suono avvisi: cicla il segnale riprodotto quando appare un'azione nel Registro radio; Off lo disabilita e il segnale scelto viene riprodotto subito in anteprima.

12.2 Monitor finestre NextATC#

Seleziona il monitor destinato a finestre e overlay del plugin. Usa Auto / Primary salvo necessità di forzare un monitor specifico.

12.3 Display a schermo#

  • OSD flash messages: mostra brevi messaggi stato.

12.4 Tema#

Cambia il tema accento UI. I temi attuali sono Yellow, Blue, Green e Cyan. Nella stessa area trovi il pulsante lingua, Scala interfaccia plugin e Stile testo: nessuno, outline, drop shadow, thick outline o combinazione shadow e outline. La scala ingrandisce insieme testo, finestre, controlli, aree cliccabili e spaziature; con poco spazio i contenuti si ridispongono o scorrono, mentre zoom e geometria geografica delle mappe restano invariati.

12.5 Sintesi vocale#

  • Read ATC messages (TTS): abilita voce ATC.
  • Speech engine: scegli Operating system, Microsoft Azure, Kokoro (offline) o Piper (offline).
  • Disable voice on readback: lascia silenziosi i readback pilota.

In Options -> Voice, usa Voice roles / Download... per il motore selezionato. Kokoro e Piper richiedono il download dei loro modelli vocali prima. Nel loro catalogo, seleziona Download, premi Download selected, poi scegli una voce pilota e il pool vocale ATC. Salva con Save voice roles; vedi Voce e Push-to-Talk. Per Azure, il pulsante Voice roles... nella sua sezione apre Azure Voice Roles. Su Windows, Windows voices... apre Windows Voice Roles.

Kokoro e Piper sintetizzano sulla CPU, quindi la scelta del modello incide sul simulatore. Entrambi i motori usano per impostazione predefinita modelli più leggeri. L'opzione Light models di Piper usa modelli di qualità media che richiedono circa otto volte meno CPU dei suoi modelli di alta qualità; sono le voci locali più leggere. Il Compact model (114 MB instead of 325 MB) di Kokoro richiede un po' meno CPU e disco del suo modello standard, con una qualità vocale leggermente inferiore. Il catalogo di Piper contrassegna ogni voce come light o heavier CPU. Deseleziona un'opzione per usare i modelli più grandi. Le voci sono le stesse; dopo aver cambiato un'opzione, scarica una volta i modelli selezionati con Download selected. Finché non sono installati, il motore continua a parlare con il modello già presente su disco. Su macOS e Windows, la sintesi vocale locale gira con priorità inferiore a quella del simulatore.

Per Azure TTS, usa Azure TTS setup in Options. Il wizard apre la pagina di creazione risorsa in Azure Portal, la pagina Microsoft costi/free tier e la guida Microsoft. Crea una risorsa Speech, copia KEY 1 da Resource Management -> Keys and Endpoint, seleziona nella lista di regioni NextATC la stessa Location/Region, poi premi Save and Test Azure. NextATC salva il segreto nel credentials.ini offuscato e richiede automaticamente il token Speech temporaneo.

NextATC offre anche un promemoria all'avvio per controllare gli eventuali costi generati da Azure. Quando non esiste ancora una preferenza salvata, parte attivo su Ogni 2 settimane e il primo avvio idoneo mostra subito il dialogo. Il dialogo indica sempre la periodicità configurata e ricorda che puoi modificarla o disabilitarla nelle Options. Controlla ora apre la pagina delle sottoscrizioni Azure; Non ora o la chiusura del dialogo registrano quel giorno e attendono l'intervallo selezionato; Non mostrare più disabilita il promemoria. Non appare mai con Azure TTS disabilitato o non configurato, e nelle Options puoi scegliere un intervallo giornaliero, settimanale, di due o tre settimane oppure mensile. Microsoft controlla prezzi e quote. NextATC non può garantire l'uso gratuito né leggere la tua fatturazione. Controlla il portale Azure e la stima d'uso locale descritta in Configurazione Azure.

Effetto voce radio#

Radio voice effect (Azure / Kokoro / Piper) in Options -> Voice si applica a questi tre motori. Modifica solo l’audio, non la fraseologia o la logica dei readback. Su Windows la sezione si chiama Radio voice effect ed elabora anche la voce del sistema operativo, insieme al volume TTS; su macOS e Linux la voce del sistema operativo è pronunciata da X-Plane e mantiene i propri controlli audio.

  • Off / On: disattiva o attiva il filtro radio post‑process per il motore supportato selezionato.
  • Filter Intensity: Light conserva più chiarezza, Medium è il riferimento, Strong restringe la banda e aggiunge più compressione, fruscio e crepitio. Il bottone mostra anche la banda Hz effettiva per l'intensità selezionata.
  • Buzz: buzz/static radio opzionale, con livelli Off, Light, Medium e Strong. Usalo se vuoi un ricevitore più sporco.
  • Buzz Type: cambia il carattere del buzz tra Static, Electrical e Hash.
  • Test: anteprima delle impostazioni audio pendenti con il motore supportato selezionato. Azure scarica un campione cloud; Kokoro e Piper sintetizzano localmente dopo l'installazione dei modelli vocali.

Il default per nuove installazioni è On, Strong Filter Intensity, Light Buzz e Hash Buzz Type.

12.6 Riconoscimento Push-to-Talk#

  • AI Voice Recognition (Experimental): abilita il microfono per le letture (readbacks) e la scelta delle azioni.
  • Pulsante Talk Mode: passa tra hold-to-talk e toggle-talk.
  • Auto-toggle guided prompts: avvia l'ascolto automaticamente per prompt guidati.
  • Auto-submit after no new words [sec]: invia dopo silenzio in modalità toggle.
  • Pulsante Microphone: scegli il dispositivo di input.
  • Voice Models: installa, aggiorna e seleziona i modelli di riconoscimento.
  • Multilingual model support (default: English): passa la taglia del modello selezionata alla corrispondente variante multilingua, che si scarica a parte. Migliora il riconoscimento di nomi o pronunce locali non inglesi, ma il readback ATC atteso resta in inglese.
  • Use GPU acceleration: usa Metal sui Mac Apple silicon supportati oppure NVIDIA CUDA su Windows quando il modulo CUDA è installato. Il pacchetto Windows include il modulo CUDA ma sul PC deve essere installato NVIDIA CUDA Toolkit 12.8 o 12.9; installalo una volta e riavvia X-Plane. È compatibile sia con l'installazione standalone sia con Steam. Quando abiliti il riconoscimento, l'opzione viene selezionata automaticamente se l'acceleratore è disponibile; senza un backend utilizzabile resta visibile ma disabilitata e grigia, con il motivo preciso relativo a driver, Toolkit o runtime mostrato subito sotto. Entrambe le versioni supportate del Toolkit supportano le GPU Blackwell / GeForce RTX 50. Per gli errori recuperabili di caricamento GPU, inizializzazione del modello o inferenza, NextATC ritenta sulla CPU. Gli errori fatali generati nel runtime GPU upstream non sono recuperabili nello stesso processo.

Le varianti Whisper in inglese sono il default. Selezionare un modello già installato, o completarne il download, abilita automaticamente il riconoscimento vocale e mostra l'avviso sul push-to-talk.

Se all'avvio del plugin manca la variante attiva selezionata, il riconoscimento resta disabilitato finché non selezioni o scarichi una variante disponibile.

Il riconoscimento vocale è un livello di comodità sopra il Radio Log. I pulsanti del Radio Log restano il fallback affidabile.

Mentre parli, la Radio Box mostra la trascrizione in tempo reale accanto ai controlli vocali e tiene visibili le ultime parole quando lo spazio finisce.

12.7 Generazione dialoghi e AI#

Il plugin può usare fraseologia integrata o variazioni opzionali generate da AI.

Le scelte disponibili dipendono dall'installazione e dai file modello presenti:

  • NextATC: fraseologia integrata.
  • AI - Gemini: variazione fraseologica cloud, richiede API key. Usa il pulsante Modello nelle Opzioni per scegliere tra Gemini Flash e Gemini Flash-Lite; NextATC usa sempre l'ultima versione del modello scelto pubblicata da Google.
  • AI - <model> (Local paused): i modelli locali vengono elencati ma non sono selezionabili mentre la generazione locale è in pausa.
  • Test AI ATC: esegue un messaggio rapido di validazione sul backend scelto.

L'output AI è vincolato: clearance, frequenze, runway, heading, altitudini, callsign, elementi readback e marker TTS devono restare invariati. Se la validazione fallisce, il plugin torna alla frase integrata.

12.8 Fraseologia e radio#

  • Regione delle procedure radio: Europa o Stati Uniti. Seleziona la fraseologia radio regionale e il codice squawk VFR predefinito (Europa 7000, Stati Uniti 1200). L'Europa usa "climb to", "descend to" e "cleared ILS approach runway 17L". Gli Stati Uniti usano "climb and maintain", "descend and maintain" e "maintain 3,000 until established on the localizer, cleared ILS runway 4L approach", senza annunciare il livello di transizione.
  • Allow non-standard phraseology: consente variazioni fraseologiche meno strette.
  • ATC radio static effect: disponibile solo dove l'effetto statico nativo è presente.
  • Release radio between dialogs: libera la radio tra gruppi di messaggi.
  • Point instead decimal in radio comms: usa "point" invece di decimal.
  • Check Squawk Code: avvisa se il transponder non corrisponde allo squawk assegnato.

12.9 Registro radio#

  • Enabled: mostra il Radio Log.
  • Max visible lines (1-8): limita lo storico visibile.
  • Auto-hide: nasconde il log dopo inattività.
  • Auto-hide timeout [sec]: ritardo prima di nascondere.
  • Show anchor dot when hidden: mostra un piccolo target hover/click.
  • Use sim time for timestamps: mostra ora simulatore invece dell'ora reale.

12.10 SimBrief#

Imposta il tuo SimBrief Pilot ID numerico. Viene usato dal dialogo del piano di volo per scaricare il tuo piano SimBrief più recente.

12.11 Dati Navigraph#

  • Connect Navigraph: autorizza il plugin con il tuo account Navigraph.
  • Download Now: scarica e installa navdata nella cartella Dati di navigazione del plugin.
  • Reset Navigraph Login: rimuove il token locale salvato.
  • Download navdata at startup: mantiene i navdata aggiornati automaticamente dopo il primo login riuscito.

12.12 Programmazione FMS#

Scegli il modo FMS nel dialogo del piano di volo per ogni deposito:

  • Program NextATC route into X-Plane FMS: scrivi la rotta generata dove il dataref di X‑Plane lo consente.
  • Read route, SID and STAR from X-Plane FMS: usa la rotta, il SID e lo STAR già presenti nell’FMS.
  • Do not read or write X-Plane FMS: tieni la rotta esclusivamente all’interno di NextATC.

L’impostazione separata delle Opzioni è:

  • Insert Approximation points in FMS: include nella rotta FMS i punti vettore Approximation generati da NextATC. Questi punti permettono una curva più fluida verso il finale; disattiva l’opzione se preferisci mantenere solo la rotta pubblicata più il riferimento finale.

12.13 Vettoramento#

  • Reduce heading vector calls: riduce correzioni heading ripetute.
  • Precise heading: usa gestione heading più stretta.
  • Calculate wind correction angle: considera il vento nelle istruzioni heading.

12.14 Altitudine#

  • Automatic local pressure phraseology and units: seleziona hPa o inHg dalla politica nazionale dell’aeroporto conosciuta quando abilitato.
  • Manual preference / automatic fallback: QNH and hPa: seleziona la convenzione di pressione manuale, usata anche quando la politica automatica non è disponibile.
  • Altimeter [inHg] with decimal: pronuncia inHg come valore decimale.
  • Low altitude speed restriction: avvisa per velocità eccessiva a bassa quota.
  • Check ground elevation: include controlli elevazione terreno.
  • Respect SIDs and STARs restrictions: usa restrizioni quota procedurali quando costruisce e autorizza la rotta.

12.15 Assistenza al volo#

  • Indicatore prua: mostra un overlay di guida prua.
  • Draw taxi guide on ground: disegna la guida taxi durante il taxi.

12.16 Traffico#

  • Traffic Options...: apre la finestra impostazioni traffico.
  • Traffic engine: abilita o disabilita il traffico sintetico integrato.
  • Enable Traffic at startup: ricorda lo stato del traffic engine.
  • Publish to X-Plane TCAS/map: esporta aeromobili sintetici ai dataref TCAS di X-Plane quando disponibili.
  • Draw 3D aircraft: disegna aeromobili sintetici nel mondo simulatore.
  • Traffic amount: alterna Low, Medium, High, Ultra High e Nuts per il budget totale del traffico a terra e in volo; profilo aeroporto e ora locale regolano il numero effettivo. Vedi Traffico per gli intervalli esatti.
  • Controlli Traffic 3D label: etichette, colore, impulso opacità, distanza massima e content mode.