Como usar overlay de toque e controle físico juntos no RetroArch para Android
Primeiro prove o controle físico com o overlay desligado; depois prove o overlay com o controle desconectado. Reative ambos e decida se o overlay fica visível, mostra entradas físicas ou é desativado por um override restrito ao núcleo ou jogo. Os dois alimentam a entrada do RetroArch, mas imagem, áreas de toque, autoconfiguração e remapeamento do núcleo são camadas diferentes.
Faça nesta ordem
- 01
Anote pacote e compilação do RetroArch, núcleo, nome e conexão do controle, preset do overlay, orientação e caminho da configuração ativa.
- 02
Desligue o overlay, reconecte o controle, confirme a mensagem de autoconfiguração e teste o menu e os comandos essenciais de um jogo autorizado.
- 03
Desconecte o controle, ligue o overlay e teste botões visíveis, áreas de toque, multitoque, rotação e retorno ao menu.
- 04
Reconecte o controle e confirme que um toque físico produz uma ação enquanto botões do overlay não tocados ficam inativos.
- 05
Escolha a apresentação: manter toque visível, ajustar opacidade, mostrar entradas físicas ou salvar override restrito que oculte o overlay.
- 06
Reinicie o mesmo jogo a frio e teste outro para provar que escopo, hotkeys, mapeamento e layout de toque não vazaram.
Tabela de diagnóstico
| Sintoma | Camada provável | Próximo teste |
|---|---|---|
| Controle funciona; toque não | Preset, área ou orientação | Testar apenas overlay |
| Toque funciona; controle não | Detecção Android ou autoconfiguração | Testar apenas controle |
| Um botão gera duas ações | Bind, hotkey ou remapeamento duplicado | Revisar RetroPad e remapeamento |
| Overlay volta ao reiniciar | Escopo ou caminho do override | Verificar configuração ativa |
Overlay é imagem e mapa de entrada
Overlays do Libretro combinam imagens com configuração de regiões tocáveis. Ver o PNG não prova áreas, multitoque, escala ou orientação.
Teste primeiro sem controle para separar geometria de toque da enumeração e dos perfis do Android.
O controle físico passa pelo RetroPad
O RetroArch mapeia o hardware para o RetroPad virtual por autoconfiguração ou binds manuais; depois um remapeamento de núcleo ou jogo altera o que a máquina recebe.
Não edite áreas de toque para consertar o controle nem troque um perfil válido para corrigir geometria. Registre a camada que falhou.
Salve a regra mais restrita
Se um gabinete sempre usa controle, um override de núcleo ou jogo pode ocultar o overlay sem apagar o toque global do celular.
Mantenha acesso ao menu e recuperação do proprietário: ocultar o overlay sem controle ou hotkey pode parecer travamento apesar da emulação ativa.
Configurar controles e overlays não autoriza conteúdo ou arte. Use apenas ROM, BIOS, CHD, imagens, sons e perfis que você pode usar e distribuir.