NextATC Unicom

Guia do NextATCAjuda e FAQ do NextATC

Voz e Push-to-Talk

TTS, reconhecimento de voz, modos PTT

O NextATC tem duas funcionalidades de voz separadas. São independentes e podem ser activadas ou desactivadas uma de cada vez:

  • TTS (text-to-speech): o controlador fala. Você lê ou ouve.
  • Reconhecimento de voz (STT): você fala. O controlador ouve.

Pode usar as duas, apenas uma ou nenhuma. O Radio Log funciona sempre, mesmo com as duas desligadas. O plugin é totalmente jogável em modo texto. Se a voz lhe der problemas, volte ao modo texto (ver a última secção) e o voo continua normalmente.

TTS — fazer o controlador falar#

Abra Plugins -> NextATC -> Options e active:

  • Read ATC messages (TTS) — o controlador fala em vez de apenas escrever no Radio Log.

É só isto que precisa. Em Options -> Voice escolha **Speech engine**: Operating system (padrão), Microsoft Azure, Kokoro (offline) ou Piper (offline). Azure requer configuração; veja Configuração do Azure. O caminho do Operating system usa as vozes instaladas no sistema. Kokoro e Piper sintetizam localmente após os seus modelos serem baixados.

Disable voice on readback mantém a sua própria voz de piloto em silêncio e dá voz apenas ao ATC. A maioria dos pilotos deixa‑a activada.

Vozes locais: Kokoro e Piper#

O NextATC inclui os seus próprios motores Kokoro e Piper. Ao contrário da integração do X-ATC-Chatter com o VoiceBox, estas vozes não exigem que o VoiceBox ou outra aplicação separada esteja em execução.

  1. Abra Options -> Voice e escolha Kokoro (offline) ou Piper (offline) em Speech engine. O catálogo de vozes abre; reabra‑o com Voice roles / Download... sempre que precisar.
  2. Selecione as vozes marcadas Download e pressione Download selected. As vozes recomendadas já vêm pré‑selecionadas. O download requer acesso à internet; a síntese de fala depois é local. Cancel download interrompe o download; fechar o catálogo permite que ele continue em segundo plano.
  3. Quando instaladas, clique numa voz para selecionar e pré‑visualizar a voz do piloto. As caixas de verificação ATC escolhem o conjunto de vozes do controlador/tráfego.
  4. Use Test current ATC ou Test random ATC, depois Save voice roles. Mantenha Read ATC messages (TTS) ativado e guarde as Opções ao terminar.

Disable voice on readback também se aplica à voz do piloto selecionada. Volume e o efeito de rádio funcionam com Azure, Kokoro e Piper e, no Windows, também com a voz do sistema operativo; no macOS e no Linux, a fala do sistema operativo usa o caminho de áudio nativo.

Quedas na taxa de quadros enquanto o Kokoro ou o Piper fala#

As vozes locais são geradas na CPU, por isso cada transmissão compete brevemente com o simulador; aeroportos movimentados com muitas comunicações de tráfego tornam isto mais perceptível. No macOS e no Windows, o processo de fala já é executado com prioridade inferior à do X-Plane. As vozes locais mais leves são as vozes Piper com Light models ativado no catálogo do Piper (o padrão): precisam de cerca de oito vezes menos CPU do que os modelos Piper de alta qualidade e estão marcadas como light. Para o Kokoro, mantenha Compact model (114 MB instead of 325 MB) ativado (o padrão): requer um pouco menos de CPU e disco do que o modelo standard, com qualidade de voz ligeiramente inferior. Ambos mantêm as mesmas vozes; certifique-se de que foi feito o download dos modelos selecionados com Download selected. Até que estejam instalados, o motor continua a usar o modelo que já está no disco. A fala do Microsoft Azure é gerada na nuvem e não usa a CPU local para a síntese.

O que significam os dois LEDs de actividade da Radio Box?#

Os dois pequenos LEDs junto de ATC/Ground Services mostram separadamente as duas fontes de áudio do rádio. O LED verde mais próximo do botão acende enquanto o NextATC ocupa o rádio para reproduzir TTS. O LED âmbar à sua esquerda acende enquanto o X-ATC-Chatter indica que está a reproduzir um clip. Um LED vazio significa que essa fonte está inactiva; se ambos acenderem ao mesmo tempo, as duas fontes de áudio estão sobrepostas.

Reconhecimento de voz — falar com o controlador#

O reconhecimento de voz lê o que diz e converte‑o num readback ou numa acção. Esta funcionalidade é experimental e assistida por IA, mas não é um chatbot livre. A pipeline actual é deliberadamente estreita:

  • Um modelo ASR/STT transcreve o áudio do microfone para texto.
  • O plugin compara esse texto com o readback, a mensagem de piloto ou a escolha de acção que o fluxo ATC espera nesse momento.
  • O fluxo ATC aceita‑o apenas quando o conteúdo operacional importante coincide: indicativo, pista, altitude, frequência, squawk, rumo e itens semelhantes.

Este desenho mantém o fluxo de voo determinístico. Também significa que uma frase pode ser transcrita correctamente e ainda assim ser rejeitada se o conteúdo operacional não corresponder ao que o ATC está à espera.

Precisa de:

  1. Um modelo de reconhecimento instalado. Abra Options e clique num modelo em falta em Voice Models para o transferir.
  2. Um microfone operacional seleccionado em Options -> Speech.
  3. Uma tecla ou um botão de joystick associado a NextATC/voice_push_to_talk.

Associe a tecla em Settings -> Keyboard no X-Plane. Procure por NextATC e atribua voice_push_to_talk a uma tecla que consiga manter carregada confortavelmente (muitos utilizadores escolhem o 0 do teclado numérico, um botão superior do manche ou a tecla Tab).

Modelos de reconhecimento e expectativas#

A página Options lista várias opções de reconhecimento de voz para que possa escolher a melhor para o seu microfone, sotaque, hardware e idioma. Esta área continua experimental: um modelo maior pode ser mais lento, ocupar mais espaço em disco ou comportar‑se de forma diferente do modelo base.

Comece com Whisper Base English. É a opção mais previsível para readbacks ATC em inglês. Experimente Whisper Small English ou Whisper Medium English apenas se precisar de melhor tratamento de sotaque e aceitar uma transcrição local mais lenta. Se um modelo seleccionado não devolver texto utilizável, volte para Whisper Base English.

Por predefinição, o reconhecimento usa modelos Whisper em inglês. Ative Multilingual model support apenas se precisar de melhor reconhecimento de nomes de aeroportos, cidades ou pronúncias locais que não sejam em inglês. Isto descarrega a variante multilingue correspondente ao tamanho do modelo selecionado, separada do modelo inglês. Quando o modelo selecionado termina a transferência, o reconhecimento vocal é ativado automaticamente e é mostrado o aviso de push-to-talk.

Se a variante ativa selecionada estiver ausente quando o plugin iniciar, o reconhecimento é desativado em vez de manter selecionado um modelo inexistente.

A aceleração por GPU torna mais rápido o processamento do áudio do microfone pelo Whisper; não gera a voz TTS do controlador. Com o mesmo modelo de reconhecimento, ativar CUDA ou Metal não garante uma transcrição mais precisa. Se o reconhecimento parecer melhor, verifique também o modelo selecionado, o microfone e o áudio gravado.

Quando Usar aceleração por GPU está disponível em Options, seleciona Metal em Macs Apple silicon suportados ou NVIDIA CUDA no Windows. O pacote Windows inclui o módulo CUDA e requer o CUDA Toolkit 12.8 ou 12.9 instalado no PC. Reinicie o X-Plane após a instalação; o Steam e as instalações independentes funcionam da mesma forma. O CUDA é carregado num módulo opcional separado, por isso a falta de GPU, driver ou runtime não impede o arranque do NextATC. Desative a opção para forçar o CPU. Erros recuperáveis de configuração da GPU, inicialização do modelo ou inferência são repetidos no CPU; erros fatais no runtime GPU upstream não podem ser recuperados no mesmo processo.

O modo multilingue deixa o Whisper detetar automaticamente a língua falada. Não transforma o NextATC numa conversa ATC não inglesa: os termos de readback esperados pelo NextATC continuam a ser em inglês.

O reconhecimento de voz deve ser visto como uma camada de conveniência sobre o Radio Log normal. É útil para imersão, mas os botões de texto são sempre o fallback fiável.

Os dois modos PTT#

Há duas formas de utilizar a tecla PTT. Escolha uma e mantenha‑a.

Modo Hold (modo rádio)#

  • Carregue e mantenha carregada a tecla PTT.
  • Fale enquanto a mantém carregada.
  • Largue a tecla quando terminar.

É assim que funciona um rádio real. É o modo padrão e o mais fiável para a maioria dos utilizadores.

Modo Toggle (carregar uma vez / carregar de novo)#

  • Carregue uma vez na tecla PTT para começar a ouvir.
  • Fale.
  • Carregue na tecla PTT uma segunda vez para parar de ouvir.

O modo Toggle é útil se a sua tecla PTT for difícil de manter carregada (por exemplo, um único botão do manche que usa para outra coisa). O plugin também pode parar automaticamente de ouvir após alguns segundos de silêncio no modo toggle.

O modo activo é configurado em Options -> Speech. Se o alterar, teste uma vez no solo antes de confiar nele em voo.

O fluxo completo do readback, passo a passo#

Esta é a sequência que o controlador espera:

  1. O ATC diz qualquer coisa. Aparece no Radio Log (e é falada se o TTS estiver activado).
  2. O Radio Log mostra os botões Readback e Say Again.
  3. Carregue e mantenha (ou alterne) a sua tecla PTT.
  4. Fale o readback. Exemplo: "Climbing flight level two zero zero, AAL67".
  5. O Radio Log mostra um preview cinzento com as palavras reconhecidas.
  6. Largue a tecla PTT (ou carregue uma segunda vez no modo toggle).
  7. O preview é submetido. Se o readback corresponder, o ATC aceita‑o e o Radio Log destaca o prompt aceite.

Se o readback não for aceite, o controlador irá pedir Say again. Ver a próxima secção.

"Transcreve bem mas o ATC continua a dizer Say Again"#

Esta é a confusão mais frequente. O preview cinzento significa que as palavras foram reconhecidas pelo microfone. Não significa ainda que o controlador as aceitou.

Causas, por ordem de probabilidade:

  • Largou a tecla PTT cedo demais ou tarde demais. O reconhecedor pára ao largar. Tente outra vez com uma pausa clara entre a última palavra e a libertação.
  • Usou uma frase diferente da que o botão de readback espera. A formulação exacta exigida está sugerida debaixo do botão Readback como um pequeno guia de voz. Combine com ela. Não precisa de ser perfeito palavra a palavra, mas os números-chave (indicativo, altitude, pista, frequência) têm de estar presentes.
  • A transcrição saltou um número (por exemplo, flight level em vez de FL200). Articule os dígitos: "two zero zero", não "two hundred".
  • Falou antes de o rádio estar pronto. Espere que o botão Readback apareça antes de carregar no PTT.
  • Ruído de fundo ou áudio do jogo. O plugin utiliza o microfone escolhido nas Opções. Em algumas combinações de auscultadores, sistema operativo e controlador, abrir o microfone Bluetooth pode selecionar outro perfil de áudio; a qualidade pode mudar ou podem surgir cliques. O NextATC não pode prever este comportamento em todos os dispositivos. Se o notar, experimente um microfone com fio ou o microfone integrado do computador.

Na dúvida, pode sempre carregar em Readback com o rato e saltar a voz. O voo prossegue exactamente da mesma forma.

"Não consigo fazer a voz funcionar. Como volto ao modo texto?"#

É seguro e rápido. Não perderá o seu voo.

  1. Abra Plugins -> NextATC -> Options.
  2. Em Options -> Speech, desligue o reconhecimento de voz (o lado de entrada — o STT).
  3. Opcionalmente, desligue Read ATC messages (TTS) se também não quiser que o controlador fale.
  4. Confirme que Radio Log está Enabled. Este é o feed de texto.
  5. Feche o Options.

O Radio Log mostra agora cada mensagem ATC como texto, e carrega em Readback / Say Again com o rato ou com o comando NextATC/handoff. Tudo o resto (autorizações, táxi, subidas, aterragens) funciona da mesma forma.

"Desactivei a voz e agora não vejo nenhuma mensagem"#

Normalmente há duas coisas desligadas:

  • Radio Log -> Enabled foi desligado em Options.
  • OSD flash messages foi desligado e o TTS está desligado, portanto nada fala e nada pisca.

Solução:

  1. Abra Options.
  2. Coloque Radio Log -> Enabled em ligado.
  3. Coloque Max visible lines em pelo menos 4.
  4. Guarde e feche.

O Radio Log reaparece na próxima mensagem ATC. Também pode carregar no pequeno ponto âncora, se Show anchor dot when hidden estiver activado, para o trazer de volta manualmente.

Se o reconhecimento de voz continuar a falhar#

Verifique, por esta ordem:

  • Microfone: outra aplicação (um gravador de voz) capta a sua voz.
  • Modelo instalado: o modelo de reconhecimento seleccionado está descarregado. A página Options mostra o estado da descarga.
  • Idioma: os modelos Whisper em inglês são usados por predefinição. Ative o suporte multilingue apenas se nomes locais não ingleses causarem problemas de reconhecimento; a variante multilingue correspondente deve ser descarregada separadamente.
  • Suporte de runtime: se um modelo experimental maior não produzir texto, volte para Whisper Base English.
  • Tecla PTT: o comando NextATC/voice_push_to_talk do X-Plane está associado a uma só tecla.
  • Hold vs Toggle: está a usar o modo que configurou, e não o outro.

Se nada ajudar, mude para o modo texto e reporte o aeroporto e a frequência. Use o reportador integrado ou anexe o ficheiro X-Plane/Log.txt a um relatório de erro web; veja Relatórios de erros e pedidos de funcionalidade.

Vozes SAPI5 no Windows#

No Windows o motor de voz Operating system usa a API de voz WinRT e as vozes que essa API indica. O NextATC não usa SAPI5. Para ter mais vozes locais sem conta na nuvem selecione Kokoro (offline) ou Piper (offline): ambos sintetizam localmente depois de descarregados os modelos de voz.

Veja também#