NextATC Unicom

Guia do NextATCAjuda e FAQ do NextATC

Configuração do Azure

Chave, região, vozes, custo

Azure TTS é a opção de voz na nuvem de alta qualidade. A voz local do X-Plane/sistema operativo funciona sem configuração; o Azure pode tornar as comunicações rádio mais naturais.

Azure é pago e fornecido pela Microsoft, não por nós. Precisa de uma conta Microsoft Azure e de um recurso Cognitive Services Speech. Verifique os preços e quotas atuais da Microsoft antes de o activar.

Lista rápida#

  1. Crie uma conta Microsoft Azure com uma subscrição Azure ativa.
  2. No Azure Portal, crie um recurso Speech: Create a resource -> AI + Machine Learning -> Speech service.
  3. Escolha subscrição, grupo de recursos, nome do recurso, região e pricing tier. Verifique custos atuais Microsoft, quota free tier e alertas de orçamento.
  4. Abra Plugins -> NextATC -> Options -> Voice.
  5. Carregue em Azure TTS setup para configurar o recurso. Use o selector Speech engine para escolher Microsoft Azure quando a configuração estiver pronta.
  6. O assistente pode abrir a página do recurso Azure, a página de preços e a documentação de configuração da Microsoft.
  7. Depois de criar o recurso Azure, abra-o e vá para Resource Management -> Keys and Endpoint.
  8. Cole KEY 1, selecione a mesma Location/Region na lista do NextATC e carregue em Save and Test Azure.

Deverá ouvir a nova voz na próxima mensagem ATC.

Para alterar uma chave ou região já guardada, reabra Azure TTS setup em Options. Os valores secretos são guardados em credentials.ini, ofuscados como as outras credenciais do plugin. Os valores antigos em settings.ini ainda são lidos para migração, mas o assistente é o caminho atual. Quando existirem credenciais guardadas, o assistente testa primeiro a configuração Azure atual e mostra se passou antes de perguntar se deseja reconfigurar.

Escolher vozes#

Depois de configurar o Azure, abra Options -> Voice, pressione Voice roles... na secção Microsoft Azure TTS para abrir Azure Voice Roles. Certifique‑se de que Microsoft Azure está selecionado em Speech engine; com isso, Voice roles / Download... abre os mesmos controlos de voz.

Como obtenho chave, região e token?#

No portal Azure:

  1. Clique em Create a resource.
  2. Abra AI + Machine Learning.
  3. Escolha Speech service.
  4. Preencha subscrição, grupo de recursos, nome do recurso, região e pricing tier.
  5. Clique em Create.
  6. Quando o deployment terminar, abra o novo recurso Speech.
  7. No menu esquerdo, abra Resource Management -> Keys and Endpoint.
  8. Copie KEY 1.
  9. No NextATC, selecione a mesma Location/Region na lista.

Não precisa obter nem colar manualmente um token. O NextATC usa KEY 1 e a região selecionada para pedir um token Speech temporário durante Save and Test Azure. Esse token dura pouco e não é guardado como credencial.

Quanto vai custar?#

Preços, quotas gratuitas e disponibilidade regional são controlados pela Microsoft e podem mudar. O plugin não o cobra e não vê a sua facturação; apenas envia pedidos TTS usando a chave que fornece.

A utilização depende das suas definições e atividade de voo; uma quota gratuita não é garantia de custo zero. O NextATC inclui um lembrete no arranque para rever a utilização. Se não existir uma preferência guardada, ativa‑se a cada duas semanas e o primeiro aviso elegível é imediato. Check now abre as subscrições do Azure; Not now ou fechar o diálogo regista esse dia e aguarda o intervalo selecionado; Do not show again desativa‑o. O intervalo pode ser alterado nas Opções, e nenhum lembrete aparece enquanto o Azure TTS estiver desativado ou não configurado.

Estatísticas locais e limite de segurança#

Options -> Voice -> Microsoft Azure TTS Stats mostra pedidos enviados, pedidos concluídos e caracteres faturáveis estimados para o mês civil UTC atual e anterior. O NextATC conta apenas POST reais de síntese Azure; pedidos de token, TTS local e geração de texto AI ficam excluídos. Os caracteres só são adicionados após síntese com sucesso. Os contadores ficam em X-Plane/Resources/plugins/NextATC/NextATC.azure-usage.ini.

O plugin utiliza 500.000 caracteres neurais de Text-to-Speech por mês civil como a sua referência mensal do Speech Free Tier F0, reiniciando no início de cada mês em UTC. Consulte Microsoft Speech pricing para a quota atual. Esta referência local não é um limite de faturação: o NextATC não consegue detetar se o seu recurso é Free Tier F0, S0 ou outro plano, e os períodos de faturação de subscrições pagas podem diferir.

A proteção Auto-disable Azure at safety limit (optional) vem ativa a 90%. A opção e o limite de 10–99% são guardados. Ao atingir o limite, o NextATC termina o pedido que o cruzou, desativa Azure TTS e bloqueia novas sínteses. Uma tentativa de reativação explica o motivo. Aumente o limite, desative a proteção ou aguarde o próximo mês civil UTC.

Estes valores são estimativas, não dados de faturação Azure. Verifique sempre o Azure Portal; os dados de utilização e custos podem atrasar 24 horas ou mais conforme a subscrição.

"Azure TTS não fala"#

Percorra esta lista:

  • Speech engine está definido para Microsoft Azure em Options -> Voice.
  • Read ATC messages (TTS) também está ligado.
  • A chave é a string da chave, não o nome do recurso.
  • A região é um código curto como westeurope, não um URL completo.
  • Tem acesso à internet a partir da máquina que executa o X‑Plane.
  • O recurso Azure continua activo no seu portal Azure (não foi eliminado nem suspenso).
  • Azure Voice Roles inclui pelo menos uma voz selecionada.

Se o Azure não estiver configurado no arranque, o plugin desactiva o Azure e usa o caminho de voz local. Falhas de pedidos Azure em runtime são registadas e podem deixar essa mensagem em silêncio. Consulte X-Plane/Log.txt para o erro Azure devolvido pela Microsoft.

"A voz está errada / robótica"#

Provavelmente ainda está na voz nativa do sistema operativo. Ou o Azure falhou (ver acima) ou Speech engine está definido para outro valor. A página Options mostra o estado actual da voz.

Posso escolher uma voz Azure separada para o piloto?#

Sim. Abra Options -> Voice, pressione Voice roles... na secção Microsoft Azure TTS para selecionar a voz do piloto e o conjunto de vozes de controlador ativado. A fala de readback do piloto permanece silenciosa enquanto Disable voice on readback estiver ativo; desative essa opção para ouvir a voz do piloto selecionada.

Voltar à voz gratuita do sistema operativo#

Escolha Operating system em Options -> Voice -> Speech engine e guarde as Opções. As mensagens subsequentes usarão a voz do sistema operativo. Não é necessário reiniciar.

Nota sobre privacidade#

Quando o Azure TTS está activado, o texto ATC é enviado para o Microsoft Azure para síntese. Nenhum dado de voo para além do texto da mensagem é enviado. Se prefere voz apenas local, utilize a voz nativa do sistema operativo.

Veja também#