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 comscrcpy -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
- Preta em um app só? Ele é protegido. Teste essa tela no próprio celular.
- Tela inteira preta? Desbloqueie e acenda a tela do celular.
- Xiaomi? Ligue a Depuração USB (Configurações de segurança).
- Continua preta? Reduza a qualidade da transmissão ou troque o codec.
- Pare outros gravadores de tela e apps de transmissão.
Mais dicas de espelhamento em dicas de espelhamento de tela do Android.