#XuruVoip
Traduções:
English •
Français •
Deutsch •
Español •
Português (Brasil) •
Português (Portugal) •
日本語 •
简体中文
XuruVoip é um conjunto de **comunicação de voz 3D (VoIP)** de alto desempenho, seguro e dinamicamente espacializado, projetado especificamente para integrações de jogos personalizadas com **Star Citizen**. Ele consiste em um servidor backend baseado em Go e um cliente C# WPF moderno com um aplicativo Companion integrado (interface web) e integração Elgato Stream Deck.
### 🎯 Meta do Projeto
O objetivo do XuruVoip é fornecer aos eventos de jogos Star Citizen, organizações de roleplay e esquadrões táticos um **nível sem precedentes de imersão de áudio e conveniência operacional**. Ao ler coordenadas em tempo real, visor e estados do veículo no cliente do jogo, o XuruVoip molda dinamicamente as vozes dos jogadores no espaço 3D, simula atmosferas planetárias/de vácuo e roteia comunicações táticas automaticamente sem exigir configurações manuais do cliente.
---
### 🗺️ Diretório de navegação
| Seção | Descrição |
| :--- | :--- |
| [📖 Guia detalhado de recursos](../doc/functionnalities.md) | Explicação técnica e do usuário de todos os mais de 40 recursos implementados. |
| [📖 Guias de usuário não técnicos](#-guias-do-usuário-não-técnicos) | Guides passo a passo fáceis de entender para cliente, servidor e stream deck. |
| [📸 Capturas de tela e IU](#-capturas-de-tela-e-interface-do-usuário) | Vitrine visual de telas de clientes, portal de administração e configurações. |
| [🗂️ Estrutura do Projeto](#️-project-structure) | Layout do repositório e divisão de pastas. |
| [⚙️ Arquitetura do Sistema](#️-system-architecture) | O diagrama de fluxo de trabalho real completo do cliente WPF, servidor Go e dispositivos externos. |
| [💡 Visão geral dos principais recursos](#-visão-geral-dos-principais-recursos) | Análise detalhada dos mais de 19 recursos espaciais e de rede implementados. |
| [🖥️ Servidor Go (Go)](#️-xuruvoip-server-go) | Instruções de construção, execução, implantação e configuração do servidor. |
| [🎛️Ponte de voz do Discord](#️-discord-voice-bridge-setup-guide) | Conectando canais de rádio do servidor Go a um canal de voz Discord. |
| [📱 Aplicativo complementar e plataforma de transmissão](#-integração-de-aplicativo-complementar-e-stream-deck) | Controle remoto de dispositivos e configuração de chaves físicas do Stream Deck. |
| [🛠️ Cliente WPF (C#)](#-building--running-the-client) | Requisitos do cliente, compilação e guias de instalação MSI/Portátil. |
---
## 📖 Guias do usuário não técnicos
Se você não tem experiência em ciência da computação, escrevemos guias simples e passo a passo para ajudá-lo a configurar e executar tudo facilmente:
* 📖 **[Guia detalhado de recursos](../doc/functionnalities.md)**: Explicação detalhada de cada recurso implementado, como funcionam, como usá-los e por que são úteis.
* 🎮 **[Guia do usuário do cliente](doc/client_guide.md)**: Guia amigável sobre como escolher microfones/alto-falantes, configurar Push-to-Talk, usar capacetes de trajes espaciais e ativar efeitos de voz de esforço.
* 🖥️ **[Guia de configuração do servidor](doc/server_guide.md)**: Explica como hospedar um servidor, ajustar senhas/configurações no arquivo de configurações `.env` e configurar o Discord Voice Bridge.
* 🎛️ **[Guia de plug-in do Stream Deck](doc/streamdeck_guide.md)**: Passo a passo sobre como instalar botões físicos para silenciar, alternar o visor e exibir canais de rádio ativos.
---
## 📸 Capturas de tela e interface do usuário
📸 Clique para ver as capturas de tela
### 1. Janela principal do cliente
### 2. Guia Configurações de áudio (controle de áudio espacial 3D)
### 3. Guia Configurações Gerais (Seleção de Idioma e Game.log)
### 4. Guia Configurações de conexão
### 5. Guia de configurações de teclas de atalho
### 6. Guia Configurações de sobreposição (Vulkan e DirectX HUD)
### 7. Guia Configurações de OCR (Tesseract OCR)
### 8. Página de login do portal da web de administração
### 9. Painel do Portal de Administração da Web
### 10. Jogadores do portal da Web de administração
### 11. Lista de administradores do portal da Web de administração
### 12. Lista de banimentos do portal de administração
---
## 🗂️ Estrutura do Projeto
- **/servidor**: back-end Go de alto desempenho que hospeda os serviços de posição, áudio e administração.
- **/client**: cliente C# WPF moderno utilizando NAudio, WebRtcVad e Tesseract OCR ou Game.log tail para rastreamento automatizado de localização e análise de log. O aplicativo complementar também está incluído neste projeto.
- **/streamdeck**: Plug-in Stream Deck para cliente XuruVoIP.
---
## ⚙️ Arquitetura do Sistema
Abaixo está a arquitetura real completa do sistema XuruVoip, ilustrando os loops de captura, posicionamento, reprodução e renderização de HUD dentro do cliente WPF, os hubs de websocket do servidor Go e as integrações externas:```mermaid
graph TB
subgraph STIM ["Ambiente de jogo (Star Citizen)"]
SC["Cliente Star Citizen"]
LOGS["Game.log (arquivo de registro)"]
SCREEN["Saída gráfica (Vulkan/DX)"]
end
subgraph WPF ["Cliente XuruVOIP WPF"]
direction TB
subgraph CAPT ["Captura de microfone e DSP"]
MIC["Entrada de microfone"] --> VAD["WebRTC VAD"]
VAD -->|Speech Detected| VC["Trocador de voz (alienígena/ciborgue/robô)"]
VC -->|Modulated PCM| GF_FIL["Injeção de pitch e tremolo / esforço ofegante G-Force"]
GF_FIL --> HELM_OSC["Sobreposição de respiração e zumbido do capacete"]
HELM_OSC --> OPUS_ENC["Codificador Opus"]
end
subgraph POS_TRACK ["Posicionamento e rastreamento de estado"]
LOGS -->|Tail Scanner| LOG_PAR["Analisador Game.log"]
SCREEN -->|showlocations Capture| OCR["Mecanismo de OCR Tesseract"]
LOG_PAR -->|Equip/Visor Events| HELM_DET["Sincronização automática do estado da viseira"]
LOG_PAR -->|G-Force & Stamina Values| GF_DET["Rastreador de força G e esforço"]
OCR -->|Coords| POS_SEL{"Seletor de Fonte"}
LOG_PAR -->|Coords & ContainerID| POS_SEL
end
subgraph PLAY ["Reprodução Espacial e DSP"]
OPUS_DEC["Decodificador Opus"] --> PKT_TYPE{"Tipo de pacote?"}
PKT_TYPE -->|PA 0x03| PA_FIL["Megafone DSP (HP/LP, distorção tanh, reverberação de navio)"]
PKT_TYPE -->|Proximity/Radio| OCC_FIL["Convés de Carraca/Hércules e Oclusão de Sala"]
OCC_FIL --> REV_FIL["Reverberação com reconhecimento de localização (cavernas/bunkers/hangares)"]
REV_FIL --> RAD_FIL["Passagem de banda de rádio e roteamento multi-hop de longo alcance (Dijkstra)"]
RAD_FIL --> CHIMES["PTT Mic Chirps e gerador de cauda silenciadora"]
CHIMES --> PAN["Matemática panorâmica 3D espacial"]
PAN --> VOL["Atenuação de distância espacial"]
VOL --> MIXER["Mixer de áudio"]
PA_FIL --> MIXER
MIXER --> SPK["Dispositivos de saída de áudio"]
end
subgraph HUD ["Sobreposição de HUD (clique em Win32)"]
T_RAD["Mini-radar tático 2D"]
STT["Whisper.net conversão de fala em texto"]
OPUS_DEC -.->|Incoming Voice| STT
STT -->|Subtitles| SUB["Legendas HUD em tempo real"]
end
subgraph COMP ["Servidor Web complementar"]
HTTP_SRV["Ouvinte HTTP local (porta personalizada)"]
DASH["Painel HTML/JS Glassmorphic"]
end
POS_SEL -->|Coordinates & Zone| POS_WS["Posição do cliente WS"]
HELM_DET -->|Visor State| POS_WS
GF_DET -->|G-Force / Exertion| GF_FIL
OPUS_ENC -->|Audio Packets| AUD_WS["Cliente WS de áudio"]
end
subgraph SERVER ["Servidor XuruVOIP Go"]
direction TB
WS_HUB["Hub de conexão Websocket"]
POS_HUB["Posicionamento Espacial e Zona Hub"]
DB["Banco de dados SQLite e canais persistentes"]
DISC_BRIDGE["Ponte de Voz Discord"]
ADM_PORT["Portal da Web de administração (Canvas Live Radar)"]
WS_HUB <--> POS_HUB
POS_HUB <--> DB
DISC_BRIDGE <--> WS_HUB
end
subgraph EXT ["Interfaces Externas"]
DISC["Canal de voz de discórdia"] <-->|Bidirectional Voice Bridge| DISC_BRIDGE
SD["Aplicativo Stream Deck"] <-->|WebSocket Actions / Port Setting| HTTP_SRV
MOB["Controlador móvel"] <-->|REST API Status & Toggles| HTTP_SRV
end
POS_WS <-->|WS Port 8888| WS_HUB
AUD_WS <-->|WS Port 8889| WS_HUB
```
---
## 💡 Visão geral dos principais recursos
### 1. Áudio espacial 3D em tempo real
* **Panorâmica Estéreo Dinâmica:** PROJETA as coordenadas do alto-falante remoto nos vetores de direção Direita e Direita do ouvinte para calcular a panorâmica esquerda/direita exata usando uma fórmula de potência constante.
* **Resolução de ambiguidade frente-trás:** Atenua o volume do áudio em 25% se um alto-falante estiver atrás do ouvinte, resolvendo as limitações de panorâmica de áudio 2D padrão.
* **Distance Roll-Off:** Desvanece as vozes de proximidade linearmente com base na distância, garantindo níveis de volume naturais (desvanece completamente até zero a 50 metros, ou 5 metros para sussurros).
### 2. Acústica com reconhecimento de localização e oclusão de navio/bunker
* **Oclusão de deck e parede:** Detecta limites internos dentro de espaços. Se os jogadores estiverem em decks diferentes (por exemplo, Carrack, Hercules) ou salas (por exemplo, Bunkers), a filtragem passa-baixa (frequências de corte de 300 Hz a 900 Hz) e o amortecimento de volume são aplicados dinamicamente.
* **Reverberação Ambiental:** Lê a zona hierárquica do player e aplica automaticamente parâmetros personalizados de mixagem molhada, atraso e reverberação de feedback para **Caves**, **Bunkers** e **Hangares**.
### 3. Simulação atmosférica de capacete e EVA
* **EVA Muting:** Silencia automaticamente as comunicações de voz de proximidade em zonas espaciais ou de vácuo (EVA), forçando os jogadores a usar canais de rádio para se comunicar.
* **Sobreposição do respirador da viseira:** Simula a pressão do ar quando a viseira está abaixada. Sintetiza um ruído respiratório de baixa frequência e um zumbido do ventilador de ventilação de dupla frequência (50 Hz + 100 Hz) na alimentação do microfone capturada.
* **Sincronização automática da viseira:** Lê registros de anexos em `Game.log` para detectar automaticamente quando um capacete é equipado/removido e atualiza o estado da viseira em tempo real. Um utilitário de **deteção automática** nas configurações gerais resolve automaticamente o diretório de instalação e registo do Star Citizen.
### 4. Trocador de voz de ficção científica e moduladores de terno
* **Filtros DSP em tempo real:** Mudança de pitch no domínio do tempo, flangeamento, modulação em anel, saturação soft-tanh e bitcrushing de 8 bits.
* **Predefinições atmosféricas:** Carregue instantaneamente perfis de voz predefinidos, incluindo **Alien**, **Cyborg**, **Robotic** ou **Custom Pitch Shift** (0,5x a 2,0x).
* **Sliders de modulador personalizados:** Ajuste com precisão a mudança de tom, frequência/mixagem do modulador em anel, profundidade/taxa/feedback do flanger e configurações de bitcrush por meio dos sliders de parâmetros.
### 5. Degradação imersiva de rádio e sinos
* **Filtragem passa-banda:** Modela filtros de rádio com cortes baixos/altos ao usar canais de rádio ou quando os visores do traje estão abaixados.
* **Degradação do sinal de rádio:** Faixas de corte estreitas e misturas de ruído estático filtrado por passagem de banda conforme a distância entre os jogadores se aproxima do limite do transmissor de rádio.
* **Sinos de rádio acústicos:** Toca sinos mecânicos ao pressionar e liberar a tecla de transmissão nos canais de rádio. Suporta quatro perfis matemáticos distintos selecionáveis nas configurações ou no aplicativo Companion: Militar (varreduras senoidais), Industrial (cliques mecânicos pesados), Alienígena (varreduras moduladas em anel) e Vintage (cliques de relé analógico).
* **Atraso de rádio baseado na distância planetária:** Simula o atraso de propagação do sinal usando a velocidade da luz ($\approx 3,3\text{ ms}$ por quilômetro, até 3000 ms no máximo) para uma latência de comunicação realista.
* **Chimes PTT personalizados:** Carrega e resampleia arquivos WAV/MP3 personalizados (`radio_key_down` e `radio_key_up`) da pasta `Resources/` para servirem como chimes fornecidos pelo usuário.
### 6. Sistema de intercomunicação automática de navio
* **Canais de intercomunicação de veículos:** Embarcar em um veículo inscreve automaticamente os jogadores em um canal de rádio dinâmico `Intercom_`.
* **Redução de prioridade do piloto:** Quando um jogador na cabine ou no assento do motorista transmite no intercomunicador, o áudio de proximidade de todos os outros jogadores é reduzido em 85% para garantir a clareza do comando de vôo.
* **Degradação Dinâmica do Intercomunicador:** Os canais de intercomunicador degradam-se automaticamente com base no status da nave:
* **Impactos no Escudo (Shield Hits):** Injeta temporariamente rajadas de estática e estalos de volume (dura 2,5 segundos).
* **Energia Crítica (Critical Power):** Zumbido elétrico de corrente alternada de baixa tensão, distorção de saturação (soft-clipping) e queda de tom de voz (resampling).
* **Viagem Quântica (Quantum Travel):** Varredura de filtro comb (flanger/phaser) e zumbido de alta frequência.
* *Todos os subefeitos podem ser alternados individualmente nas Configurações Gerais e vêm desativados por padrão.*
* **Recarga de limpeza:** Faz uma contagem regressiva de 5 minutos após o último jogador deixar a nave antes de excluir o canal de intercomunicação, maximizando o desempenho do servidor.
### 7. Sobreposição de HUD compatível com Vulkan e radar tático 2D
* **Sobreposição Click-Through do Win32:** Uma sobreposição de HUD sem bordas que mostra conexões VoIP, frequências e estados de fala. Compatível com Vulkan e DirectX (executando em modo de janela sem borda).
* **Personalizador de HUD interativo:** Permite personalização em tempo real do tema (Aegis, Anvil, Drake, RSI, Origin), posicionamento (cantos/centro) e visibilidade dos componentes (mini-radar, lista de alto-falantes, cabeçalho de conexão) via configurações ou pelo aplicativo Companion.
* **Indicador de Status do Intercomunicador:** Exibe avisos como `⚡ INTERCOM: DEGRADED` (com detalhes de substatus como `[Power Loss]`, `[Quantum]` ou `[Static Pop]`) na sobreposição do HUD quando a degradação do intercomunicador está ativa.
* **Mini-Radar Tático:** Apresenta um radar HUD 2D alinhado ao rumo que exibe jogadores que falam relativamente, desenhando anéis sonoros pulsantes ao redor deles.
* **Indicadores de elevação 3D:** Adiciona setas de direção vertical e deltas de altura do deck (ex: `Bob (▲ 12m)`) ao lado dos ícones do radar quando a separação vertical excede 2 metros.
* **Legendas de fala para texto:** Transcreve áudio de rádio/proximidade recebido para legendas localizadas do HUD usando um modelo Whisper leve e off-line (`ggml-tiny.bin`).
### 8. Comandos de voz PTT viva-voz
* **Comandos de voz PTT viva-voz:** Manter pressionada a tecla dedicada de comando de voz silencia temporariamente as transmissões de voz de proximidade/rádio de saída e armazena o áudio do microfone em buffer. Ao soltá-la, a voz é transcrita localmente via modelo Whisper para acionar ações da nave:
* **Comandos suportados:** Alternar visor/capacete, silenciar/ativar microfone (proximidade/rádio/perfil/todos), seleção de canal de rádio ativo e predefinições do modulador de voz.
* **Correspondência de palavras-chave multilíngue:** Suportado em 8 idiomas (inglês, francês, alemão, espanhol, português, japonês e chinês).
* **Filtro de limite de confiança:** Um controle deslizante configurável filtra correspondências de baixa confiança ou falas irrelevantes.
* *Desabilitado por padrão; a ativação fará o download em segundo plano do modelo de transcrição off-line Whisper (~140 MB) se ainda não estiver presente.*
* **Lista de referência de comandos de voz:**
Abaixo está a lista de todos os comandos de voz PTT viva-voz suportados, divididos em controles de aplicativo XuruVOIP e mapeamentos de teclas de Star Citizen:
#### Controles do Aplicativo XuruVOIP (Exclusivos do XuruVOIP)
Esses comandos controlam o estado do capacete/viseira, silenciamento de canais, frequências de rádio ou modulações de voz diretamente no XuruVOIP:
* **Alternar capacete/viseira:** `visera`, `capacete`, `alternar visera`, `alternar capacete`
* **Silenciar canal de proximidade:** `silenciar proximidade`, `mutear proximidade`
* **Ativar canal de proximidade:** `ativar proximidade`, `desmutear proximidade`
* **Silenciar canal de rádio:** `silenciar radio`, `mutear radio`
* **Ativar canal de rádio:** `ativar rádio`, `desmutear rádio`
* **Silenciar canal de perfil:** `silenciar perfil`, `mutear perfil`
* **Ativar canal de perfil:** `ativar perfil`, `desmutear perfil`
* **Silenciar microfone (Global):** `silenciar tudo`, `mutear tudo`, `silenciar microfone`, `mutear micro`
* **Ativar microfone (Global):** `ativar tudo`, `desmutear tudo`, `ativar microfone`, `desmutear micro`
* **Mudar canal de rádio:** `mudar canal`, `canal para`, `definir canal`, `canal` seguido do nome do canal (por exemplo, *"mudar canal Alpha"*)
* **Definir perfil do modulador de voz:** `modulador de voz`, `perfil de voz`, `voz` seguido de um perfil: `alien` (ou `alienígena`), `cyborg` (ou `ciborg`), `robotic` (ou `robot`), `pitchshift` (ou `pitch shift`, `tono`, `pitch`), `none` (ou `off`, `normal`, `desativado`)
#### Controles simulados da nave (Relacionados ao Star Citizen)
Esses comandos simulam pressionamentos de teclas físicas no seu PC para acionar controles de Star Citizen:
* **Alternar energia da nave:** `energia`, `alternar energia`, `sistemas ligados`, `sistemas desligados`
* **Alternar motores da nave:** `motores`, `alternar motores`, `ligar motores`, `desligar motores`
* **Alternar armas:** `armas`, `alternar armas`, `ligar armas`, `desligar armas`
* **Alternar escudos (ON/OFF):** `alternar escudos`
* **Equilibrar escudos:** `restaurar escudos`, `equilibrar escudos`
* **Alternar modo VTOL:** `vtol`, `alternar vtol`
* **Ativar salto quântico (Quantum):** `quântico`, `salto quântico`, `motor quântico`
* **Alternar piloto automático (Cruise Control):** `cruzeiro`, `piloto automático`, `alternar cruzeiro`
* **Solicitar pouso / Abrir hangar:** `solicitar pouso`, `pedir pouso`, `abrir hangar`, `chamar atc`
* **Alternar portas/rampas da nave:** `portas`, `exterior`, `abrir portas`, `fechar portas`, `abrir exterior`, `fechar exterior`
* **Desviar escudos para a frente:** `escudos`, `escudos na frente`, `escudos para frente`, `desviar escudos`
* **Alternar trem de pouso:** `trem de pouso`, `desdobrar trem`, `recolher trem`
* **Modo de voo (SCM/NAV):** `modo de voo`, `modo voo`, `modo navegacao`
* **Modo escaneamento:** `modo de varredura`, `modo escaneamento`, `escaner`, `ativar escaner`
* **Modo mineração:** `modo mineracao`, `iniciar mineracao`, `mineracao`
* **Modo reciclagem:** `modo de reciclagem`, `modo salvamento`, `reciclagem`
* **Energia máxima para armas:** `energia para armas`, `armas no maximo`, `maximo armas`
* **Energia máxima para escudos:** `energia para escudos`, `escudos no maximo`, `maximo escudos`
* **Energia máxima para motores:** `energia para motores`, `motores no maximo`, `maximo motores`
* **Restabelecer/Equilibrar energia:** `restabelecer energia`, `equilibrar energia`, `energia reset`
* **Lançar chamariz/isca:** `isca`, `lancar isca`, `lancar chamariz`
* **Lançar ruído/chaff:** `ruido`, `lancar ruido`, `chaff`, `lancar chaff`
* **Alternar luzes da nave:** `luzes`, `farois`, `ligar luzes`, `desligar luzes`
* **Mirar Inimigo mais Próximo:** `mirar inimigo`, `inimigo mais proximo`, `travar inimigo`
* **Ciclar Subsistemas:** `ciclar subsistemas`, `mirar subsistema`, `mirar motores`, `mirar escudos`
* **Alternar Modo Cardan:** `modo cardan`, `alternar cardan`, `gimbal`
* **Fixar Alvo:** `fixar alvo`, `salvar alvo`
* **Alternar Modo Desacoplado:** `modo desacoplado`, `desacoplar`
* **Alternar G-Safe:** `seguranca g`, `alternar gsafe`, `gsafe`
* **Alternar Limitador de Velocidade:** `limitador de velocidade`, `alternar limitador`
* **Aumentar Rajada de Iscas:** `aumentar iscas`, `mais iscas`
* **Restabelecer Rajada de Iscas:** `restabelecer iscas`
* **Limpar Viseira:** `limpar visera`, `limpar capacete`
* **Chamar Alvo:** `chamar alvo`, `chamar nave`
### 9. Aplicativo complementar e API REST
* **Servidor Web HTTP local:** Hospeda um painel local em uma porta configurável (padrão: `8891`, desabilitado por padrão).
* **Controlador Glassmorphic:** Conecta-se a telefones ou telas secundárias para alternar mudos, ciclos de canal, capacetes ou trocadores de voz.
* **API REST:** Expõe endpoints `GET /api/status` e `POST /api/action` para integrações externas (incluindo o status do intercomunicador e simulação de estados).
### 10. Plug-in de plataforma de streaming
* **Stream Deck Action Pack:** Expõe 26 ações para controlar silenciamentos de microfone, silenciamentos de áudio, viseiras de capacete e ciclos de radiofrequência.
* **Ícones de teclas dinâmicas:** Gráficos de botão de atualização contínua de WebSockets (ciano ativo versus âmbar silenciado) para refletir o estado atual do cliente.
* **Título de frequência ao vivo:** Exibe os nomes dos canais de rádio ativos diretamente nos botões físicos do Stream Deck.
### 11. Ponte de Voz Discord
* **Retransmissão de áudio bidirecional:** Retransmite as comunicações entre um canal de rádio do servidor Go e um canal de voz do Discord.
* **Mapeamento de apelidos:** Captura a fala do Discord e mapeia IDs SSRC para apelidos de servidor.
* **Rastreamento dinâmico de frequência:** Move automaticamente a conexão de voz da ponte do Discord para seguir e espelhar o canal ativo do líder configurado ou dos perfis Command/Leader.
### 12. Segurança, rotação de log e radar de tela de administração
* **Rotação diária de logs:** Arquivador de logs de inicialização que retém apenas os 5 logs mais recentes.
* **Painel de administração:** Painel de administração da Web em tempo real com segurança de bloqueio, limitação de taxa e um mapa interativo de radar ao vivo em tela HTML5 2D que permite aos administradores ampliar, deslocar e rastrear trilhas históricas de jogadores.
### 13. Distorção de voz por força G e esforço físico
* **Tremolo e mudança de tom:** Sob altas forças G, o áudio de saída do microfone é modulado dinamicamente com um tremolo LFO (4-10 Hz, até 40% de profundidade) e afinado (fator: 1,0 até 0,85) para simular tensão física, blecaute ou estados de redout.
* **Sobreposição de respiração pesada:** Sobrepõe automaticamente ruídos aleatórios de respiração ofegante/respiratória, aumentando a velocidade do ciclo respiratório com base nos níveis de resistência do jogador analisados em tempo real no `Game.log`.
* **Controles manuais/API:** Alternáveis por meio das configurações do cliente e dos controles deslizantes da interface da Web do aplicativo complementar para roleplay ou testes simulados.
### 14. Relé de rádio tático e sinalizadores repetidores multi-hop
* **Roteamento de sinal multi-hop:** Os jogadores podem alternar o "Modo Beacon" para atuar como um farol repetidor de rádio. Se dois jogadores estiverem fora do alcance direto do rádio (além de 1.500 m), o cliente receptor executa o algoritmo de caminho mais curto de Dijkstra em todos os repetidores ativos na zona.
* **Degradação da qualidade do pior salto:** Se existir um caminho de vários saltos abaixo do limite de salto único de 8.000 m, o sistema roteia a comunicação e aplica o fator de degradação do pior salto (qualidade do sinal) em vez da distância total em linha reta, permitindo redes de rádio planetárias/orbitais de longo alcance.
* **Estado WebSocket dinâmico:** Os estados do repetidor ativo são sincronizados em tempo real por meio do canal de controle WebSocket do servidor.
### 15. Sistema de transmissão de endereço público (PA) do navio
* **Transmissão de áudio para todo o navio:** Pilotos ou capitães de navios com tripulação múltipla podem transmitir anúncios de voz para todos os membros da tripulação que compartilham o mesmo `ContainerID` (navio) na mesma Zona.
* **PA DSP & Klaxon Chime:** As transmissões de PA ignoram os silenciamentos de proximidade e rádio locais (exceto volume mestre/mudo), reproduzem em mono com pan centralizado, precedem um alerta de chime/klaxon de dois tons de ficção científica e aplicam um filtro de megafone passa-banda e reverberação simulando a acústica de interiores vazios de naves.
### 16. Telemetria de hardware externa (Sim-Pit UDP Sync)
* **Sincronização UDP em tempo real:** O cliente transmite os estados de VoIP e capacete em formato JSON para `127.0.0.1:8895` a cada 100ms.
* **Integração de hardware:** Permite que construtores de cockpits integrem LEDs físicos ou indicadores que reajam às comunicações.
### 17. Simulação de densidade atmosférica planetária
* **Alcance da voz:** O alcance da voz por proximidade se adapta à densidade atmosférica do planeta ou lusa (ex: decaimento de volume 3,5x mais rápido em Cellin).
* **Abafamento de som:** Aplica filtros passa-baixa a vozes externas sob atmosferas rarefeitas, ignorado em interiores pressurizados.
### 18. Gravador de voz pós-operação e portal AAR
* **Contêiner Ogg/Opus sem sobrecarga:** Salva pacotes Opus diretamente em arquivos `.ogg` sem transcodificação no servidor.
* **Linha do tempo interativa:** Permite que administradores visualizem, reproduzam e excluam gravações de voz de missões no painel de administração.
### 19. Sistema de chamadas e hailing de nave para nave
* **Chamadas de cockpit a cockpit:** Estabelece loops de comunicação privada entre naves dentro de um limite de 5.000m.
* **Transmissão mãos-livres:** Ativa a transmissão de voz via VAD durante a chamada, ignorando teclas PTT padrão.
* **Sinalização sonora realista:** Sintetiza tons de discagem, chamada e conexão/desconexão realistas via NAudio.
### 20. Legendas traduzidas em tempo real no HUD do visor
* **Tradutor dinâmico:** Traduz transmissões de voz estrangeiras em tempo real usando dicionários de voo/militares para 7 idiomas.
* **Prefixo de legenda no HUD:** Exibe o texto traduzido no HUD do visor, com o prefixo `[DE -> PARA]`.
* **Carregamento de modelo Whisper:** Baixa o modelo Whisper (~75MB) em segundo plano ao ativar o recurso, se necessário.
### 21. Áudio espacial HRTF binaural
* **Simulação física do ouvido:** Simula o formato do ouvido humano e os efeitos de sombra da cabeça usando ITD (Diferença de tempo interaural) e atenuação passa-baixa ILD (Diferença de nível interaural).
* **Compatibilidade estéreo:** Oferece dicas de áudio 3D de alta fidelidade em fones de ouvido estéreo padrão, sem a necessidade de hardware de som surround.
### 22. Espectrograma 3D no HUD do visor
* **Sobreposição de telemetria FFT:** Calcula transformadas rápidas de Fourier (FFT) Radix-2 de 64 pontos em tempo real nos fluxos de voz dos alto-falantes recebidos.
* **Visualização dinâmica do HUD:** Agrupa frequências de áudio em 8 bandas espectrais ao lado de alto-falantes ativos no HUD Vulkan/DX, com decaimento suave.
### 23. Controles de nave ativados por voz
* **Tradução de comando de voz para atalho:** Ouve comandos de voz (por exemplo, "open doors") e os compara com dicionários localizados em 8 idiomas.
* **Pressionamentos de teclas físicos diretos:** Simula pressionamentos de teclas físicos com a API Win32 de baixo nível `keybd_event` (teclas mantidas pressionadas por 50 ms para captura confiável do jogo, com suporte a teclas modificadoras).
### 24. Reprodução AAR 3D no servidor
* **Registro de coordenadas:** O servidor registra coordenadas e zonas dos jogadores em um arquivo `_positions.jsonl` a cada 500 ms.
* **Reprodução WebGL 3D Sincronizada:** Visualiza a trajetória 3D do jogador e os anéis de fala concêntricos em um mapa interativo Three.js WebGL 3D com rotação, pan e zoom pelo mouse, totalmente sincronizado com o áudio Ogg/Opus gravado.
### 25. Visualizador de histórico de legendas de voz no aplicativo
* **Console WPF TabControl:** Substitui o painel do console estático do aplicativo por um controle de abas elegante com estilo de ficção científica.
* **Histórico de legendas:** Exibe uma lista cronológica das últimas 30 legendas de transcrição de voz e comandos de voz offline com carimbos de data/hora e metadados do remetente.
### 26. Assistente de Calibração de Comando de Voz do Whisper
* **Simulação Supressa:** A ativação do modo de calibração bloqueia pressionamentos de teclas simulados de baixo nível e ações do ViewModel C#, garantindo que você possa testar comandos de voz com segurança.
* **Correspondências em Tempo Real:** Exibe o texto transcrito, a porcentagem de confiança de similaridade e a ação do jogo correspondente diretamente na guia de configurações enquanto você fala.
### 27. Modo sussurro (Stealth Comms) com limite de proximidade de 10m
* **Alcance de 10m:** Limita a proximidade dinamicamente no cliente e servidor para **10,0m** para sussurrar.
* **DSP de sussurro otimizado:** Força o VAD no modo `HighQuality`, amplifica o ganho em **+6dB (2,0x)** e aplica um **filtro passa-alta de 400Hz** para remover ruídos.
* **Alerta de HUD:** Mostra `(Sussurrar)` ao lado do microfone no HUD. Ativado pelo atalho **Alt + W**.
### 28. Capturador de tela por comando de voz em jogo
* **Comando mãos livres:** Reconhece comandos de voz localizados (ex: `"capturar tela"`, `"tirar print"`) usando o Whisper offline.
* **Captura de janela ativa:** Captura a janela ativa do Star Citizen via GDI+ `CopyFromScreen`.
* **Salvamento e flash HUD:** Salva como PNG na pasta `/Screenshots` e pisca uma borda verde a 2Hz por 3 segundos no HUD.
### 29. Indicador de saturação do microfone no HUD
* **Verificação em tempo real:** Monitora amostras de áudio antes do corte de ganho na thread de captura.
* **Retenção de pico de 800ms:** Mantém o alerta ativo por 800ms após detectar amostra estourando os limites de 16 bits (>32767 ou <-32768).
* **Alerta no HUD:** Pisca uma borda vermelha com `🎙️ OVERGAIN / CLIPPING` a 2Hz no HUD.
### 30. Silenciador de rádio (Squelch) e gerador de tons personalizado
* **Menu suspenso restaurado:** Restaura a escolha dos perfis de bips PTT (Military, Industrial, Alien, Vintage).
* **Parâmetros personalizáveis:** Adiciona controles para frequência do tom (Hz), duração do tom (ms) e duração do squelch (ms).
### 31. Modo de diagnóstico de loopback de voz local
* **Teste de latência:** Redireciona os pacotes capturados do microfone de volta para o buffer de produção.
* **Atraso de 200ms:** Aplica um atraso de 200ms para simular a latence de rede e evitar eco imediato.
### 32. Tema OLED de alto contraste para o aplicativo companheiro
* **Preto absoluto:** Adiciona opção de tema preto puro (#000000) plano no cabeçalho do app companheiro.
* **Persistência de tema:** Salva a escolha do usuário no `localStorage` do navegador.
---
### 33. DSP de porta de ruído (Noise Gate)
* **Limite RMS de silenciamento:** Analisa a amplitude RMS das tramas de captura. Zera as tramas de áudio que caem abaixo do limite configurável (ex: -45 dB) antes da transmissão para suprimir ruídos de fundo.
### 34. Modo PTT alternado (PTT Latch)
* **Alternar transmissão de voz:** Alterna a transmissão ao pressionar a tecla PTT e ignora a libertação da tecla, mantendo o canal aberto até que seja pressionada novamente.
### 35. Relé de acessibilidade de texto para voz (TTS)
* **Síntese de voz local:** Lê legendas, alertas do sistema e chats de texto locais usando a síntese de voz do Windows, preservando a privacidade do usuário.
### 36. Executor de sequências macro de voz
* **Simulador de teclas complexas:** Traduz comandos falados (ex: "Prepare for Landing") em sequências precisas de teclas de Star Citizen simuladas com atrasos configuráveis.
### 37. Perfis de toque por fabricante
* **Aeroacústica de Hailing:** Gera toques de chamada personalizados representando os fabricantes de naves (Aegis, Anvil, Drake, Origin, RSI) usando síntese de onda NAudio.
### 38. Assistente de calibração de áudio interativo
* **Búfer de diagnóstico local:** Grava 5 segundos de áudio do microfone e reproduz localmente com os moduladores e efeitos de voz aplicados para teste.
### 39. Gráfico RSSI na aplicação companheira
* **Métricas em tempo real:** Hub de diagnóstico ativo: plota métricas de latência, jitter, perda e RSSI em tempo real, com botão que desenha linhas de varredura na tela web.
### 40. Motor de palavra de ativação por voz
* **Ativação mãos-livres:** Utiliza Whisper offline para capturar e executar comandos de voz ao detectar palavras de ativação (ex: "computer") no áudio capturado.
---
## 🎮 Detalhamento da guia de configurações do cliente XuruVoip
A janela de configurações do WPF está estruturada em seis categorias de configuração:
1. **Geral**: Configure idiomas, acompanhe os arquivos `Game.log`, alterne o registro geral de arquivos e habilite/configure o **Servidor HTTP do aplicativo Companion** local e a porta.
2. **Conexão**: Edite o IP do servidor de destino, as portas de posição e áudio, o nome de usuário, a senha do usuário e a senha do servidor.
3. **Posição**: alterne a fonte de localização ("OCR Screen Scanner" vs "Game.log Reader (GRTPR)"), configure índices de monitor, regiões de corte, intervalos de OCR e visualize texto de coordenadas ao vivo.
4. **Áudio**: escolha o hardware de entrada/saída, ajuste os ganhos de dB, selecione o modo de transmissão (PTT vs VAD), configure os limites do VAD, alterne **Ativar áudio espacial 3D**, configure a degradação do rádio, sinos locais sintetizados, modulador do visor e selecione as predefinições do **Trocador de voz**.
5. **Teclas de atalho**: Vincule teclas ao PTT de proximidade, PTT de rádio, PTT de perfil, viseira de capacete, ciclo de canal de rádio e interruptores individuais de mudo de microfone e canal de áudio.
6. **Sobreposição**: alterne a sobreposição do HUD, defina posicionamentos nos cantos, ative o **Mini-radar tático** (com alcance máximo configurável) e alterne **Legendas de fala para texto** em tempo real.
---
## 🖥️ Servidor XuruVoip (Go)
O servidor coordena as posições dos jogadores, lida com autenticação segura e roteia pacotes de áudio dinamicamente com base na distância espacial e nos canais de rádio.
### Principais recursos
* **Controle de proximidade do lado do servidor**: retransmite dinamicamente o áudio de proximidade apenas para jogadores dentro do alcance (padrão de 50m ou sussurro de 5m).
* **Configuração Espacial**: Opção alternável do lado do servidor (`XURUVOIP_SPATIAL_AUDIO` em `.env`) que determina se as coordenadas ou apenas a distância devem ser enviadas aos clientes.
* **Roteamento de rádio multicanal**: permite que os jogadores ouçam vários canais de rádio simultaneamente enquanto transmitem em seu canal ativo.
* **Sistema de perfil de áudio**: atribui efeitos de áudio (por exemplo, filtro de rádio, eco) aos players.
* **Persistência SQLite**: Armazena preferências de canal do jogador e mapeamentos de perfil nas reinicializações do servidor.
* **Segurança anti-bypass**: Bane criadores de problemas por nome de usuário, IP e impressão digital de hardware (HWID/MachineGuid) para evitar evasão de banimentos.
* **Portal de administração da Web**: Interface da Web segura (HTTPS/WebSockets) para painéis em tempo real, streaming de logs, configuração de canal/perfil e gerenciamento de banimentos.
* **Mapa de radar de administração do servidor**: Radar de jogador em tempo real do HTML5 Canvas 2D integrado ao painel de administração, com suporte para movimento panorâmico de clicar e arrastar, zoom da roda do mouse, filtragem de zona ativa, trilhas históricas de caminhada do jogador (trilhas de navegação) e anéis de ondas sonoras concêntricas pulsantes ao vivo em torno de jogadores falantes.
* **Rotação do Log de Inicialização**: Verifica o log do servidor (`xuruvoip.log`) na inicialização. Se o arquivo de log contiver entradas de um dia anterior, ele será rotacionado para `xuruvoip.YYYY-MM-DD.log`. O servidor retém apenas os 5 arquivos rotacionados mais recentes e exclui os mais antigos para evitar o uso excessivo do disco.
### Configuração do servidor (`.env`)
Na primeira inicialização, o servidor gera automaticamente um arquivo `.env` contendo estes valores padrão:```env
# BIND IP address and server ports
# Leave IP empty to listen on all interfaces (0.0.0.0)
XURUVOIP_SERVER_IP=
XURUVOIP_PORT=8888
XURUVOIP_AUDIO_PORT=8889
XURUVOIP_DATA_DIR=.
# Maximum Server Capacity (can be higher, depends on server performances)
XURUVOIP_MAX_PLAYERS=500
# Spatial Audio (1 = enabled and transmits coordinates, 0 = disabled and transmits distance only)
XURUVOIP_SPATIAL_AUDIO=1
# Public Server Settings (1 = players will not need to enter the server password to connect, 0 = required)
XURUVOIP_PUBLIC_SERVER=0
# Server Password / Token for player connections (only if public server is disabled)
XURUVOIP_SERVER_PASSWORD=auto_generated_32_chars_token
# Admin Server Password / Token for the admin portal page (https://[XURUVOIP_SERVER_IP]:[XURUVOIP_PORT]/admin)
XURUVOIP_ADMIN_SERVER_PASSWORD=auto_generated_32_chars_token
# Verbose logging level (0 = none, 1 = default, 2 = global frames per type, 3 = detailed channels/profiles)
XURUVOIP_VERBOSE_LOGS=1
# Security Settings (Rate Limiting and IP Lockout)
XURUVOIP_LIMIT_RATE_POS=50.0
XURUVOIP_LIMIT_BURST_POS=100
XURUVOIP_LIMIT_RATE_AUDIO=60.0
XURUVOIP_LIMIT_BURST_AUDIO=120
XURUVOIP_LOCKOUT_ATTEMPTS=5
XURUVOIP_LOCKOUT_WINDOW=60
XURUVOIP_LOCKOUT_DURATION=600
# Dynamic Intercom and Immersion features (1 = enabled, 0 = disabled)
XURUVOIP_ENABLE_INTERCOM=1
XURUVOIP_ENABLE_EVA_MUTING=1
XURUVOIP_ENABLE_RADIO_REPEATERS=1
XURUVOIP_ENABLE_SHIP_PA=1
# Discord Voice Bridge Settings (1 = enabled, 0 = disabled)
XURUVOIP_ENABLE_DISCORD_BRIDGE=1
XURUVOIP_DISCORD_TOKEN=your_discord_bot_token
XURUVOIP_DISCORD_GUILD_ID=your_discord_guild_id
XURUVOIP_DISCORD_CHANNEL_ID=your_discord_channel_id
XURUVOIP_DISCORD_BRIDGE_CHANNEL=General
```
### 🎛️ Guia de configuração do Discord Voice Bridge
Para conectar um canal de rádio do servidor Go local a um canal de voz Discord, siga estas etapas de configuração:
1. **Crie um aplicativo Discord Bot:**
* Visite o [Portal do Desenvolvedor Discord](https://discord.com/developers/applications) e faça login.
* Clique em **Novo Aplicativo**, dê um nome a ele (por exemplo, `XuruVOIP Bridge`) e clique em **Criar**.
* Navegue até a guia **Bot** na barra lateral esquerda, clique em **Reset Token** e copie o **Bot Token** gerado. Cole isto como `XURUVOIP_DISCORD_TOKEN` no arquivo `.env` do seu servidor.
* Em **Privileged Gateway Intents** na mesma página do bot, habilite **Message Content Intent** (necessário para ler comandos específicos).
2. **Convide o bot para o seu servidor Discord:**
* Vá para a guia **OAuth2** e selecione **Gerador de URL**.
* Em **Escopos**, marque `bot` e `applications.commands`.
* Em **Permissões do bot**, selecione os seguintes privilégios:
* *Permissões Gerais:* `Ver Canais`
* *Permissões de texto:* `Enviar mensagens`
* *Permissões de voz:* `Conectar`, `Falar`, `Usar atividade de voz`
* Copie o URL gerado na parte inferior da página, cole-o em um navegador da web, selecione o servidor Discord de destino (Guilda) e clique em **Autorizar**.
3. **Obter IDs de servidor (guilda) e canal de voz:**
* Abra o Discord, vá para **Configurações do usuário** -> **Avançado** e ative o **Modo de desenvolvedor**.
* Clique com o botão direito no ícone do servidor Discord na lista de servidores e selecione **Copiar ID do servidor** (este é o seu ID da guilda). Cole-o como `XURUVOIP_DISCORD_GUILD_ID` em `.env`.
* Clique com o botão direito no canal de voz do Discord de destino onde deseja que o bot entre e selecione **Copiar ID do canal**. Cole-o como `XURUVOIP_DISCORD_CHANNEL_ID` em `.env`.
4. **Canal de rádio do servidor Map Go:**
* Configure `XURUVOIP_DISCORD_BRIDGE_CHANNEL` para o nome exato do canal de rádio que você deseja fazer a ponte (por exemplo, `General`, `Bravo`, `Alpha`, etc.). Qualquer áudio transmitido nesta frequência de rádio do servidor Go será transmitido bidirecionalmente para o Discord Voice Channel!
### Construindo o servidor a partir da fonte
####Linux```bash
cd server
GOOS="linux" GOARCH="amd64" go build .
# a "server" linux binary will be created in the current directory
```
####Janelas```powershell
cd server
$env:GOOS="windows"
$env:GOARCH="amd64"
go build .
# a "server.exe" windows binary will be created in the current directory
```
### Executando o Servidor
#### Da fonte:```bash
cd server
go run .
```
#### Do binário:
#####Janelas```powershell
.\server.exe
```
#####Linux```bash
./server
```
### 🖥️ Configuração e implantação de servidor sem cabeça
Para instalações headless permanentes e prontas para produção, o servidor deve ser executado como um daemon/serviço de sistema em segundo plano que inicia automaticamente na inicialização e reinicia em caso de falha.
#### 1. Configuração de rede e firewall
Certifique-se de que as portas TCP de entrada definidas em seu arquivo `.env` (os padrões são `8888` para posições/portal de administração e `8889` para áudio espacial) estão abertas no firewall do host:
* **Linux (UFW):** ```bash
sudo ufw allow 8888/tcp
sudo ufw allow 8889/tcp
sudo ufw reload
```
* **Linux (firewall):** ```bash
sudo firewall-cmd --zone=public --add-port=8888/tcp --permanent
sudo firewall-cmd --zone=public --add-port=8889/tcp --permanent
sudo firewall-cmd --reload
```
---
#### 2. Implantação do Linux (systemd)
Siga estas etapas para implantar o servidor Go como um serviço systemd:
##### Etapa A: Diretório de configuração e permissões
Crie um usuário de sistema dedicado e um diretório de trabalho para isolamento de segurança:```bash
# Create a system user without login privileges
sudo useradd -r -s /bin/false xuruvoip
# Create installation directory and copy the binary
sudo mkdir -p /opt/xuruvoip
sudo cp xuruvoip-server-linux-x64 /opt/xuruvoip/xuruvoip-server
sudo chmod +x /opt/xuruvoip/xuruvoip-server
# Set ownership to the system user
sudo chown -R xuruvoip:xuruvoip /opt/xuruvoip
```
##### Etapa B: Gerar e configurar `.env`
Execute o servidor uma vez sob o usuário do sistema para gerar o arquivo de configuração e banco de dados `.env` padrão:```bash
sudo -u xuruvoip /opt/xuruvoip/xuruvoip-server -port 8888 -audio-port 8889
```
*Pressione `Ctrl+C` depois que o console imprimir as senhas geradas.* Em seguida, edite o arquivo `.env` gerado para personalizar as configurações (por exemplo, senhas, IP de ligação, alternância de áudio espacial):```bash
sudo nano /opt/xuruvoip/.env
```
##### Etapa C: Crie o arquivo de serviço systemd
Copie o arquivo de serviço do repositório `server/xuruvoip.service` para `/etc/systemd/system/xuruvoip-server.service` ou crie um novo arquivo de configuração de serviço `/etc/systemd/system/xuruvoip-server.service` com o seguinte conteúdo:```ini
[Unit]
Description=XuruVoip Star Citizen Spatial VOIP Server
After=network.target
[Service]
Type=simple
User=xuruvoip
Group=xuruvoip
WorkingDirectory=/opt/xuruvoip
ExecStart=/opt/xuruvoip/xuruvoip-server
Restart=always
RestartSec=5
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
```
##### Etapa D: ativar e iniciar o serviço```bash
# Reload systemd daemon to pick up the new unit file
sudo systemctl daemon-reload
# Enable the service to run on startup
sudo systemctl enable xuruvoip-server
# Start the service immediately
sudo systemctl start xuruvoip-server
```
##### Etapa E: Monitorar e registrar
Para verificar o status do serviço e os logs de streaming:```bash
# Check status
sudo systemctl status xuruvoip-server
# Stream log files in real-time
journalctl -u xuruvoip-server -f -n 100
```
---
#### 3. Implantação do Windows (NSSM)
Para executar o servidor como um serviço nativo do Windows no modo headless, é recomendado usar o **Non-Sucking Service Manager (NSSM)**:
##### Etapa A: Diretórios de configuração
Extraia/copie `xuruvoip-server-windows-x64.exe` para uma pasta de servidor dedicada (por exemplo, `C:\XuruVoipServer`).
##### Etapa B: inicializar a configuração
Abra um terminal PowerShell como administrador e execute o binário uma vez para gerar arquivos:```powershell
cd C:\XuruVoipServer
.\xuruvoip-server-windows-x64.exe
```
*Pressione `Ctrl+C` quando a inicialização terminar.* Personalize o arquivo `.env` gerado conforme necessário.
##### Etapa C: Instale o serviço via NSSM
Baixe o NSSM e instale o serviço executando:```powershell
# Open NSSM GUI installer
.\nssm.exe install XuruVoipServer "C:\XuruVoipServer\xuruvoip-server-windows-x64.exe"
```
No pop-up NSSM, configure:
* **Caminho:** `C:\XuruVoipServer\xuruvoip-server-windows-x64.exe`
* **Diretório de inicialização:** `C:\XuruVoipServer`
* Clique em **Instalar serviço**.
##### Etapa D: iniciar o serviço
Inicie o serviço usando PowerShell ou Services Manager (`services.msc`):```powershell
Start-Service -Name XuruVoipServer
```
---
### Construindo e executando o cliente
#### Requisitos
-Janelas 10/11
- SDK do .NET 9.0 (suporte WPF)
#### Compilar e executar:```powershell
cd client
dotnet run
```
### Instalando o pacote de lançamento
Como o instalador e os executáveis não são assinados digitalmente, o Windows SmartScreen pode bloqueá-los inicialmente. Você pode desbloqueá-los facilmente usando o menu de propriedades.
* **Opção A: Gerenciador de Pacotes do Windows (winget) - (Recomendado)**
1. Abra um terminal (PowerShell ou Prompt de Comando).
2. Execute o seguinte comando para instalar o cliente:
```powershell
winget install XuruDragon.XuruVOIPClient
```
* **Opção B: Instalador MSI**
1. Baixe `XuruVoipClient-win-x64.msi` da [página de lançamentos](https://github.com/XuruDragon/XuruVOIP/releases).
2. Para evitar que o Windows SmartScreen bloqueie a instalação:
- Clique com o botão direito no arquivo `XuruVoipClient-win-x64.msi` baixado e selecione **Propriedades**.
- Na janela de propriedades na guia *Geral*, marque a caixa de seleção **Desbloquear** na parte inferior.
- Clique em **Aplicar** e feche a janela Propriedades.
3. Clique duas vezes no arquivo para executar o instalador e siga as instruções solicitadas.
*(Observação: você verá um prompt padrão do Controle de Conta de Usuário do Windows "Editor Desconhecido"; basta clicar em **Sim** ou **Executar** para continuar.)*
* **Opção C: Versão ZIP portátil**
1. Baixe `XuruVoipClient-win-x64.zip` da [página de lançamentos](https://github.com/XuruDragon/XuruVOIP/releases).
2. Extraia os arquivos do pacote ZIP para qualquer pasta de sua preferência (por exemplo, `C:\Games\XuruVoip`):
3. Em seguida, clique com o botão direito no arquivo `XuruVoipClient.exe` extraído e selecione **Propriedades**.
- Na janela de propriedades na guia *Geral*, marque a caixa de seleção **Desbloquear** na parte inferior.
- Clique em **Aplicar** e feche a janela Propriedades.
4. Clique duas vezes em `XuruVoipClient.exe` para executar o cliente diretamente sem instalá-lo.
## 📱 Integração de aplicativo complementar e stream deck
O XuruVOIP inclui um serviço web integrado do Companion App e um plugin oficial do Stream Deck que permite monitorar e acionar ações de voz diretamente de dispositivos secundários ou chaves físicas.
### 1. Habilitando o aplicativo complementar e o MFD do mapa tático
Por padrão, o servidor HTTP local do Companion App e o modo do mapa tático estão desabilitados para economizar recursos do sistema. Para habilitá-los:
1. Abra o cliente XuruVOIP e clique no ícone **Configurações**.
2. Na guia **Geral**, marque a caixa **Habilitar servidor HTTP Companion** (porta padrão: `8891`).
3. Para habilitar a exibição do radar, marque a caixa de seleção aninhada **Habilitar mapa tático do copiloto (MFD)**.
4. Clique em **Salvar e Fechar** para aplicar.
5. Acesse o painel: Você pode abrir `http://localhost:8891` em qualquer navegador em seu PC, tablet ou celular. Se o modo de mapa estiver habilitado, uma nova guia **🗺️ Mapa Tático** estará disponível, exibindo uma tela de radar HUD baseada em Canvas que rastreia a posição em tempo real do seu personagem, rumo, contatos da tripulação na mesma zona e indicadores de fala ativa. Pode clicar no botão **Mostrar QR** ao lado do campo da porta companion nas definições para gerar um código QR de ligação e copiar a hiperligação de ligação, permitindo-lhe digitalizar e ligar-se facilmente a partir dos seus dispositivos móveis na mesma rede local. A guia de controlos também inclui uma secção de **Misturador de Áudio** para ajustar os níveis de volume individuais de Proximidade, Rádio e Perfil em tempo real. A guia de controlos também inclui uma secção de **Misturador de Áudio** para ajustar os níveis de volume individuais de Proximidade, Rádio e Perfil em tempo real.
---
### 2. Instalação do plug-in Stream Deck
O pacote de lançamento inclui o arquivo `.streamDeckPlugin` pré-empacotado.
1. Baixe `com.xuru.voip.streamDeckPlugin` da [página de lançamentos](https://github.com/XuruDragon/XuruVOIP/releases).
2. Clique duas vezes no arquivo para instalá-lo diretamente no software Elgato Stream Deck.
*(Como alternativa, você pode extrair e copiar manualmente a pasta `com.xuru.voip.sdPlugin` para `%appdata%\Elgato\StreamDeck\Plugins\`)*
3. Depois de instalada, uma nova categoria de ação chamada **XuruVOIP** aparecerá na lista do lado direito do seu aplicativo de desktop Stream Deck.
---
### 3. Adicionando e configurando ações
Você pode arrastar e soltar qualquer uma das 26 ações a seguir nas teclas do Stream Deck:
* 🎤 **Silenciar proximidade**: Alterna o silenciamento do microfone de proximidade de saída.
* 📻 **Rádio Mudo**: Alterna o silenciamento do microfone do rádio de saída.
* 👤 **Perfil mudo**: Alterna o silenciamento do microfone do perfil de saída.
* 🤫 **Toggle Whisper**: Alterna o modo de sussurro furtivo (limite de proximidade de 10 m).
* 🔊 **Audio Proximity Mute**: Alterna o silenciamento da reprodução de proximidade de entrada.
* 🔊 **Audio Radio Mute**: Alterna o silenciamento da reprodução do rádio recebido.
* 🔊 **Desativar perfil de áudio**: alterna o silenciamento da reprodução do perfil de entrada.
* 🪖 **Alternar capacete**: alterna a viseira do capacete do traje espacial para baixo ou para cima.
* 🔄 **Cycle Radio**: percorre os canais de rádio disponíveis.
* 📢 **PA Broadcast**: Tecla Push-to-Talk para transmitir no sistema de alto-falantes públicos (PA) da nave.
* 📡 **Beacon Mode**: Alterna o modo repetidor de rádio / baliza.
* 🎙️ **Voice Command Macro**: Aciona uma macro de comando de voz personalizada simulada em segundo plano (configurável nas configurações).
* 🎧 **Toggle Loopback**: Alterna o diagnóstico de retorno de microfone local.
* 📸 **Capture Screenshot**: Captura uma imagem do jogo Star Citizen imediatamente.
* 💬 **Intercom Status**: Exibe o status do interfone da nave (`NORMAL`, `SHIELD HIT`, `CRIT PWR`, `QUANTUM`) e percorre os estados de simulação ao ser pessoalmente pressionado.
* 🗺️ **Location Telemetry**: Exibe a zona atual do sistema e a telemetria das coordenadas $(X, Y, Z)$ na tecla.
* 📞 **Initiate Hail**: Inicia uma chamada de nave para nave para o jogador mais próximo.
* 📞 **Accept/Answer Hail**: Aceita uma chamada de hailing recebida.
* 📞 **Decline/End Hail**: Recusa uma chamada recebida ou encerra uma chamada ativa.
* 🔤 **Toggle Translation**: Ativa/desativa as legendas de tradução do HUD em tempo real.
* 🎧 **Toggle HRTF**: Alterna a renderização de áudio espacial HRTF em tempo real.
* 📊 **Toggle Spectrogram**: Alterna o espectrograma 3D no HUD do visor em tempo real.
#### Configuração (Inspetor de Propriedades):
Para cada ação arrastada para uma tecla, clique nela e configure as opções no painel **Property Inspector** na parte inferior:
* **Companion Port**: Defina para corresponder à porta configurada nas configurações do cliente WPF (padrão: `8891`).
* **Voice Command** (Apenas para Voice Command Macro): Insira o comando de texto a ser executado (ex: `"close visor"`, `"open hangar"`).
* **Feedback dinâmico**: As ações atualizam seus ícones e estados em tempo real. Os alternadores mostram ciano/vermelho, o Intercom Status percorre 4 estados e a telemetria de localização mostra as coordenadas.
* **Exibição de frequência ao vivo**: A tecla **Cycle Radio** exibirá dinamicamente o nome da frequência atualmente ativa (por exemplo, `120.5` ou `General`) diretamente no botão físico em tempo real!
---
## 👥 Créditos
Desenvolvido por **[@XuruDragon](https://github.com/XuruDragon)** em colaboração com **Antigravity IDE**.