Configure e solucione problemas de voz no FiveM: pma-voice e SaltyChat

Escolha um sistema de voz compatível com seus recursos de rádio e telefone, depois teste separadamente a proximidade, o rádio e as chamadas. O pma-voice usa o transporte Mumble integrado ao FiveM; o SaltyChat adiciona um fluxo com cliente e plugin do TeamSpeak. Nenhuma das opções garante uma latência ou qualidade de som específica no seu servidor.

A configuração e os exemplos de código aqui são voltados ao FiveM para GTA V Legacy. O Enhanced tem regras diferentes de runtime e de compatibilidade; verifique as alterações de Legacy para Enhanced do Cfx.re antes de aplicá-las a um servidor Enhanced.

Escolha por dependências

Liste a integração de voz exigida pelo seu telefone, rádio, HUD e framework. Para uma instalação mumble-voip existente, audite essas dependências antes de alterá-la. Para SaltyChat, inclua as instruções de configuração do cliente/plugin, servidor e jogador do TeamSpeak suportados na decisão.

Leia o README do pma-voice ou documentação do recurso SaltyChat FiveM para a versão que você instalar. Mantenha o recurso e a configuração antigos disponíveis para reversão.

Instale o pma-voice em um servidor de teste

Coloque o recurso completo em uma pasta chamada pma-voice. Desative o gerenciamento de voz concorrente, incluindo a voz do vMenu, se presente, e verifique se outros scripts não substituem seus nativos de proximidade. Preserve as integrações de telefone/rádio para revisão, em vez de presumir que seus exports correspondem.

Para uma configuração de áudio nativa, coloque as seguintes configurações antes da inicialização do recurso no arquivo ativo server.cfg. Não habilite simultaneamente um modo de áudio 2D ou 3D conflitante:

setr voice_useNativeAudio true
setr voice_useSendingRangeOnly true
setr voice_enableRadios 1
setr voice_enableCalls 1
setr voice_enableSubmix 1
ensure pma-voice

Compare essas opções com o README da sua versão. Integrações antigas podem usar opções anteriores com nomes relacionados a telefone; atualmente, o projeto original documenta voice_enableCalls e voice_defaultCallVolume. Habilitar um módulo não cria uma interface de usuário completa de telefone ou rádio.

Verifique os controles do jogador

Peça a dois jogadores de teste para escolherem seu microfone/dispositivo de saída real e verificarem a permissão do microfone no Windows. Nas ligações de teclas do FiveM, inspecione as entradas registradas pelo recurso de voz. Os padrões upstream do pma-voice incluem F11 para proximidade e Alt Esquerdo para rádio; a ligação salva de um jogador existente pode ser diferente.

Alterar a tecla padrão do servidor não sobrescreve as preferências já salvas pelos jogadores. Resolva conflitos de teclas nas configurações de cada jogador.

Se estiver usando SaltyChat

Instale o recurso do servidor e a combinação de plugin/cliente TeamSpeak suportada seguindo suas instruções de lançamento correspondentes. Configure a identidade do servidor TeamSpeak, o canal e quaisquer configurações de acesso necessárias de forma privada. Forneça aos jogadores as instruções corretas do servidor e do plugin.

Verifique primeiro a conexão do TeamSpeak e o carregamento do plugin, depois a proximidade do FiveM, depois o rádio/chamadas. Uma conversa funcional do TeamSpeak fora do jogo não estabelece que a integração do FiveM esteja funcionando.

Execute a matriz de teste de voz

1. Com duas contas de jogador comuns, teste a fala próxima e fora de cada alcance de proximidade configurado.
2. Junte-se ao mesmo canal de rádio autorizado e teste ambas as direções; depois, teste um jogador sem acesso.
3. Faça, atenda e encerre uma chamada telefônica. Confirme se o estado do áudio é limpo após desligar.
4. Reconecte e reinicie o servidor de teste. Verifique se o estado do rádio/chamada é restaurado ou limpo conforme o esperado.
5. Teste interiores, veículos e buckets de roteamento usados pelo seu servidor. Registre exatamente onde o comportamento do áudio difere.

Diagnostique uma camada por vez

Sem entrada de microfone: inspecione o dispositivo selecionado e a permissão do SO. A proximidade funciona, mas o rádio falha: inspecione a associação ao rádio, a lógica de item/permissão e os exports de integração. As chamadas falham após uma atualização: compare a integração do telefone com a API de voz instalada. Eco ou efeitos inesperados: inspecione gerentes de voz duplicados e modos de áudio.

Leia os logs do recurso antes de alterar as configurações. Use o Resmon do cliente apenas para o tempo do script; não é um teste de latência de áudio de ponta a ponta. Se estiver comparando a qualidade da voz, use os mesmos dispositivos, rede e cena e mantenha as observações reais.

Documentação de referência

Cfx.re — voz