Solução de problemasPublicado em: 3 min de leitura

Tela preta no espelhamento de tela do Android: causas e soluções

Por que scrcpy, ADBKit e outras ferramentas ADB mostram tela preta em alguns apps ou no celular inteiro, de FLAG_SECURE e vídeo protegido a codecs e tela bloqueada.

Você espelha um celular Android no computador e recebe uma imagem preta, seja em um app ou em tudo. A causa define a solução, então primeiro repare quando a tela fica preta.

Preta só em alguns apps

Isso quase sempre é de propósito. Os apps podem marcar as janelas como seguras (FLAG_SECURE), e o Android as esconde de capturas de tela, gravação de tela e espelhamento. Você vê preto enquanto esse app está aberto, e a imagem volta quando você sai dele.

Exemplos típicos:

  • Apps de banco, pagamento e carteira digital
  • Gerenciadores de senhas e apps autenticadores
  • Netflix, Disney+, Prime Video e outros apps de streaming pagos (vídeo protegido)
  • Alguns apps de mensagens em conversas privadas ou anônimas
  • Telas onde você digita um PIN ou uma senha

Não existe nenhum ajuste no ADB ou na ferramenta de espelhamento que mude isso, e isso é bom. Teste essas telas direto no celular.

Preta na tela inteira

O celular está bloqueado ou com a tela apagada

Alguns celulares param de enviar quadros enquanto a tela está apagada ou a tela de bloqueio está aparecendo. Desbloqueie o celular e acenda a tela. Ligue Permanecer ativo (Stay awake) nas Opções do desenvolvedor enquanto trabalha.

Xiaomi, Redmi e POCO

Sem a Depuração USB (Configurações de segurança) (USB debugging (Security settings)), celulares Xiaomi podem mostrar a tela mas bloquear os comandos de toque, e alguns modelos também limitam a captura. Ligue a opção como explicado em depuração USB Xiaomi e configurações de segurança.

O codec de vídeo falhou

As ferramentas de espelhamento codificam a tela como vídeo no celular. Alguns celulares têm problemas com um codec ou uma resolução específica, o que aparece como uma imagem preta ou congelada.

  • scrcpy: tente scrcpy --video-codec=h265, ou reduza o tamanho com scrcpy -m 1024.
  • ADBKit: abra More tools › Stream quality e escolha 1080p ou 720p em vez da resolução nativa.

Outro app está gravando a tela

Normalmente só um gravador de tela funciona por vez. Pare outros apps de gravação ou transmissão no celular, e pare qualquer adb shell screenrecord que você tenha iniciado.

Um perfil de trabalho ou política do dispositivo

Celulares gerenciados pela empresa podem desativar a captura de tela por completo. Isso vale para todas as ferramentas de espelhamento.

Preta só no vídeo, não nos menus

Isso é vídeo protegido (DRM), como explicado acima. Os menus e o resto do app são capturados normalmente, e a área do vídeo fica preta. Capturas feitas com adb exec-out screencap -p se comportam do mesmo jeito.

Checklist rápido

  1. Preta em um app só? Ele é protegido. Teste essa tela no próprio celular.
  2. Tela inteira preta? Desbloqueie e acenda a tela do celular.
  3. Xiaomi? Ligue a Depuração USB (Configurações de segurança).
  4. Continua preta? Reduza a qualidade da transmissão ou troque o codec.
  5. Pare outros gravadores de tela e apps de transmissão.

Mais dicas de espelhamento em dicas de espelhamento de tela do Android.