NextATC Unicom

Guida di NextATCNextATC Guida e FAQ

Configurazione Azure

Chiave, regione, voci, costi

Azure TTS è l'opzione vocale cloud ad alta qualità. La voce locale X-Plane/OS funziona senza configurazione; Azure può rendere le comunicazioni radio più naturali.

Azure è a pagamento ed è fornito da Microsoft, non da noi. Ti serve un account Microsoft Azure e una risorsa Cognitive Services Speech. Controlla prezzi e quote correnti di Microsoft prima di abilitarlo.

Checklist rapida#

  1. Crea un account Microsoft Azure con una sottoscrizione Azure attiva.
  2. In Azure Portal, crea una risorsa Speech: Create a resource -> AI + Machine Learning -> Speech service.
  3. Scegli sottoscrizione, resource group, nome risorsa, regione e pricing tier. Controlla costi correnti Microsoft, quota free tier e budget alert.
  4. Apri Plugins -> NextATC -> Options -> Voice.
  5. Premi Azure TTS setup per configurare la risorsa. Usa il selettore Speech engine per scegliere Microsoft Azure quando la procedura è pronta.
  6. La procedura guidata può aprire la pagina creazione risorsa Azure, la pagina costi/free tier e la guida Microsoft.
  7. Dopo la creazione della risorsa Azure, aprila e vai in Resource Management -> Keys and Endpoint.
  8. Incolla KEY 1, seleziona dalla lista NextATC la stessa Location/Region, poi premi Save and Test Azure.

Dovresti sentire la nuova voce al prossimo messaggio ATC.

Per cambiare una chiave o regione già salvata, riapri Azure TTS setup dalle Options. I valori segreti sono salvati in credentials.ini, offuscati come le altre credenziali del plugin. I vecchi valori in settings.ini sono ancora letti per migrazione, ma la procedura guidata è il percorso corrente. Se esistono credenziali salvate, il wizard testa prima la configurazione Azure attuale e mostra se ha passato il test prima di chiedere se riconfigurare.

Scelta delle voci#

Dopo la configurazione di Azure, scegli la voce del pilota e il gruppo di voci dei controllori in Options -> Voice: premi Voice roles... nella sezione Microsoft Azure TTS per aprire Azure Voice Roles. Con Microsoft Azure selezionato in Speech engine, Voice roles / Download... apre gli stessi controlli vocali.

Come ottengo key, region e token?#

Nel portale Azure:

  1. Clicca Create a resource.
  2. Apri AI + Machine Learning.
  3. Scegli Speech service.
  4. Compila sottoscrizione, resource group, nome risorsa, regione e pricing tier.
  5. Clicca Create.
  6. Quando il deployment è completato, apri la nuova risorsa Speech.
  7. Nel menu a sinistra, apri Resource Management -> Keys and Endpoint.
  8. Copia KEY 1.
  9. In NextATC, seleziona dalla lista la stessa Location/Region.

Non devi ottenere o incollare manualmente un access token. NextATC usa KEY 1 e la regione selezionata per richiedere un token Speech temporaneo durante Save and Test Azure. Il token è breve e non viene salvato come credenziale.

Quanto mi costerà?#

Prezzi, quote gratuite e disponibilità regionale sono controllati da Microsoft e possono cambiare. Il plugin non ti fattura e non vede la tua fatturazione; invia solo richieste TTS usando la chiave che fornisci.

L'utilizzo dipende dalle tue impostazioni e dall'attività di volo; una quota gratuita non è una garanzia di costo zero. NextATC include un promemoria all'avvio per revisionare l'utilizzo. Se non esiste una preferenza salvata, parte attivo ogni due settimane e il primo avviso idoneo appare subito. Check now apre le sottoscrizioni Azure; Not now o la chiusura del dialogo registra quel giorno e attende l'intervallo scelto; Do not show again lo disabilita. L'intervallo può essere modificato in Options, e nessun promemoria appare mentre Azure TTS è disabilitato o non configurato.

Statistiche locali e soglia di sicurezza#

Options -> Voice -> Microsoft Azure TTS Stats mostra richieste inviate, richieste riuscite e caratteri fatturabili stimati per il mese solare UTC corrente e quello precedente. NextATC conta solo i veri tentativi POST di sintesi Azure; richieste token, TTS locale/nativo e generazione di testo AI sono esclusi. I caratteri si sommano solo dopo una sintesi riuscita. I contatori sono salvati in X-Plane/Resources/plugins/NextATC/NextATC.azure-usage.ini.

Il plugin usa 500.000 caratteri neural Text-to-Speech per mese solare come suo riferimento mensile Speech Free Tier F0, con azzeramento all'inizio di ogni mese in UTC. Controlla Microsoft Speech pricing per la quota corrente. Questo riferimento locale non è un limite di fatturazione: NextATC non può rilevare se la tua risorsa è Free Tier F0, S0 o un altro piano, e i periodi di fatturazione degli abbonamenti a pagamento possono differire.

La protezione Auto-disable Azure at safety limit (optional) è attiva per impostazione predefinita al 90%. Sia il flag sia la soglia modificabile da 10 a 99% vengono salvati nelle Options. Quando la stima del mese corrente raggiunge la soglia, NextATC completa la richiesta che l'ha superata, disattiva Azure TTS, salva lo stato e blocca le richieste successive. Un tentativo di riattivazione mostra il motivo. Per riutilizzare Azure bisogna alzare la soglia sopra il consumo corrente, disattivare la protezione o attendere il nuovo mese solare UTC.

Questi dati sono stime, non dati di fatturazione Azure. Verifica sempre sul portale Azure. Costi e consumi nel portale possono arrivare con 24 ore di ritardo o più, a seconda del tipo di abbonamento, quindi temporanee differenze sono normali.

"Azure TTS non parla"#

Scorri questa lista:

  • Speech engine è impostato su Microsoft Azure in Options -> Voice.
  • Read ATC messages (TTS) è attivo.
  • La key è la stringa della chiave, non il nome della risorsa.
  • La region è un codice breve come westeurope, non un URL completo.
  • Hai accesso a internet dalla macchina che esegue X-Plane.
  • La risorsa Azure è ancora attiva nel tuo portale Azure (non eliminata, non sospesa).
  • Azure Voice Roles include almeno una voce selezionata.

Se Azure non è configurato allo startup, il plugin disabilita Azure e usa il percorso voce locale. Gli errori runtime delle richieste Azure sono loggati e possono rendere silenzioso quel messaggio. Controlla X-Plane/Log.txt per l'errore Azure restituito da Microsoft.

"La voce è sbagliata / robotica"#

Probabilmente sei ancora sulla voce integrata dell'OS. O Azure ha fallito (vedi sopra) o è selezionato un diverso Speech engine in Options. La pagina Options mostra lo stato corrente della voce.

Posso scegliere una voce pilota Azure separata?#

Sì. In Options -> Voice, premi Voice roles... nella sezione Microsoft Azure TTS per aprire Azure Voice Roles e selezionare la voce del pilota e il pool di voci dei controllori abilitate. La voce del readback del pilota rimane silenziosa mentre Disable voice on readback è attivo; disattiva l'opzione per ascoltare la voce del pilota selezionata.

Tornare alla voce gratuita dell'OS#

Scegli Operating system in Options -> Voice -> Speech engine e salva le Options. I messaggi successivi utilizzeranno la voce del sistema operativo. Nessun riavvio è necessario.

Nota sulla privacy#

Quando Azure TTS è abilitato, il testo ATC viene inviato a Microsoft Azure per la sintesi. Nessun dato di volo oltre al testo del messaggio viene inviato. Se preferisci una voce solo locale, usa la voce integrata dell'OS.

Vedi anche#