Ir para o conteúdo

Solução de problemas

O celular não encontra o PC ou não conecta

O selo de status no topo do deck mostra a conexão: Conectado a e o nome do seu PC (verde), Reconectando… ou Sem conexão. Toque nele para ver o que fazer. Se ele não ficar verde:

  1. Mesma rede: celular e PC precisam estar na mesma rede local. Redes Wi-Fi de convidados e o "isolamento de AP" impedem que os dispositivos se enxerguem.
  2. Firewall: use Liberar no firewall (rede local) no menu da bandeja, ou libere TCP 4787 e UDP 7573 à mão (veja Instalação) e confira se o Windows marca sua rede como Privada.
  3. O DroidDeck está rodando: procure o ícone na bandeja. No PC, http://localhost:4787/api/ping deve retornar {"ok":true,...}.
  4. IP errado: em PCs com vários adaptadores de rede, VPNs ou adaptadores virtuais (Hyper-V, WSL, VirtualBox), o QR pode trazer o endereço errado. Descubra o certo com ipconfig e digite-o manualmente em IP do Servidor.
  5. "Servidor não encontrado" na pesquisa: a descoberta usa broadcast, que alguns roteadores bloqueiam. Digite o IP manualmente.
  6. Ainda nada? Conecte pelo cabo USB: ele não depende da rede nem do firewall.

A conexão USB não conecta

  • O item da bandeja precisa estar marcado e dizer aguardando celular ou celular conectado.
  • A Depuração USB precisa estar ligada, e o celular precisa ter aceitado o aviso Permitir depuração USB?. Se você fechou o aviso, tire e ligue o cabo de novo. Alguns cabos só carregam: tente outro.
  • O celular precisa estar pareado com este PC antes, pelo QR code; o cabo não leva a chave.
  • Se o download do adb falhou, confira a internet e clique de novo no item da bandeja.

"Falha de autenticação… Refaça o pareamento"

A chave do celular não confere com a do PC (por exemplo, depois que o arquivo apikey foi apagado). Leia o QR code de novo pelo menu da bandeja.

O configurador mostra erros 401

O configurador só entra automaticamente no próprio PC. Abra-o em http://localhost:4787/ na máquina onde o DroidDeck está rodando.

Um atalho de teclado não faz nada

  • As teclas vão para a janela em foco — confira se o app certo está na frente.
  • Apps rodando como administrador ignoram entradas de um DroidDeck sem privilégios de administrador.
  • Jogos com anti-cheat podem ignorar teclas simuladas.
  • Confira a sintaxe em Atalhos de teclado.

Os botões de mídia não fazem nada

Verifique se o app aparece no overlay de mídia do Windows (aperte uma tecla de mídia no teclado). Se o log mencionar o media broker travado, espere um minuto ou reinicie o app que está tocando.

Integrações

Logs

O DroidDeck grava um log em %LocalAppData%\DroidDeck.log (ao lado da pasta DroidDeck, não dentro dela). Anexe-o ao abrir uma issue — ele nunca contém sua chave de API.