Português

O controle não funciona no OpenEmu em um Mac

Quando o OpenEmu ignora um controle que o próprio Mac enxerga, a causa quase sempre é uma de duas permissões do macOS, Input Monitoring e Bluetooth, ou um controle conectado mas não escolhido na tela Controls do OpenEmu. As duas levam um minuto para conferir. O OpenEmu lê controles diretamente, então não precisa de um mapeador, e vou mostrar abaixo exatamente onde um ajuda e onde não.

O InputConfig é grátis na Mac App Store. macOS 14 ou posterior, sem conta, sem rastreamento, código aberto.

Passos

Confira se o controle acende em System Settings, Game Controllers.
Ative o OpenEmu em Privacidade e Segurança, Input Monitoring e Bluetooth.
Feche o OpenEmu por completo e abra de novo.
Em Controls do OpenEmu, escolha o console, o seu controle e o jogador.
Feche o Steam e qualquer app que altere entradas, e teste de novo.

Prove que o Mac enxerga o controle

Você: Abra System Settings, clique em Game Controllers na barra lateral e pressione alguns botões.
macOS: Lista o controle e acende cada botão.
Confira: Se acender, o problema está dentro do OpenEmu. Se não estiver na lista, resolva primeiro a conexão: como conectar um controle a um Mac, ou o teste de controle se você quiser ver cada botão ao vivo.

Ative as duas permissões de que o OpenEmu precisa

O OpenEmu lê dispositivos de entrada diretamente, e o macOS coloca isso atrás de permissões. A própria página de solução de problemas do OpenEmu lista as duas:

Input Monitoring. Necessária para o teclado, e a resposta de costume quando o teclado não funciona no OpenEmu. System Settings, Privacidade e Segurança, Input Monitoring, ative o OpenEmu.
Bluetooth. Desde o macOS Monterey, controles sem fio precisam dela. System Settings, Privacidade e Segurança, Bluetooth, ative o OpenEmu.

Feche o OpenEmu por completo e abra de novo depois de mudar qualquer uma das duas. Se o OpenEmu já está na lista e continua sem receber nada, desative e ative de novo. Uma permissão concedida a uma cópia mais antiga do app pode deixar de valer depois de uma atualização.

Escolha o controle em Controls

Você: Abra os ajustes do OpenEmu e vá para Controls. Escolha o console no topo, depois o seu controle no menu de entrada embaixo da imagem do controle, e o número do jogador.
OpenEmu: Preenche sozinho um controle que reconhece.
Confira: Se não preencher, clique em cada botão da imagem e pressione o botão correspondente do controle.

Os mapeamentos são por console, então um controle configurado para o SNES ainda precisa ser configurado para o Genesis. Se os analógicos têm drift ou parecem sensíveis demais, o guia do OpenEmu diz para girar cada analógico em um círculo completo antes de começar a jogar, o que deixa a calibração automática dele encontrar as bordas.

Confira o seu controle: PS5, PS4, Xbox, Switch Pro e 8BitDo

O banco de dados de controles do OpenEmu, na versão mais recente (2.4.1, de dezembro de 2023), tem layouts automáticos para o DualSense, o DualShock 4, os controles sem fio Xbox One S e Xbox Series X|S, o Switch Pro Controller, o 8BitDo Pro 2 e o Wii Remote. Então um controle de PS5 ou Xbox que não funciona quase nunca é falta de suporte. Volte para as permissões.

Controle de PS3. O DualShock 3 também está no banco de dados, mas no macOS atual ele é muito mais confiável por USB do que por Bluetooth.
Controle de Xbox 360. O macOS não tem suporte ao controle de Xbox 360 com fio, então nem o OpenEmu nem qualquer mapeador consegue lê-lo. Um controle de Xbox mais novo ou qualquer controle Bluetooth resolve.
8BitDo. Se o Mac não o lista em Game Controllers, tente outro modo na chave do controle. A página do 8BitDo diz qual.

Feche os apps que disputam a entrada

A página de solução de problemas do OpenEmu cita apps que interferem na entrada dele: Chrome, Steam, DOSBox e Terminal, e apps que alteram entradas, como Karabiner, USB Overdrive e ControllerMate.

Steam. O mais comum: com o Steam aberto, a camada de controle dele pode enviar teclas próprias ao mesmo tempo. Feche-o e teste de novo.
InputConfig. Enquanto um preset que mapeia o seu controle está ativo, o OpenEmu recebe o controle e as teclas. Desative o preset, ou dê ao OpenEmu um preset próprio com a troca automática.

Onde um mapeador ajuda

Se o OpenEmu lê o seu controle depois de corrigir a permissão, você não precisa de um mapeador para isso. Três casos em que o InputConfig, grátis para o macOS 14 ou posterior, ajuda:

Um controle que o OpenEmu não aceita. O InputConfig muitas vezes ainda consegue lê-lo, porque também abre controles como dispositivos HID brutos. Defina a entrada do OpenEmu para esse jogador como o teclado, atribua as teclas que preferir e mapeie o controle para essas teclas. O código-fonte do OpenEmu aceita teclas enviadas por outros apps, então isso funciona enquanto o OpenEmu é a janela da frente. O layout Emulator / Arcade é um ponto de partida: setas, Z, X, A, S, Q, W, Enter e Shift.
Comandos de menu em botões sobrando. Os comandos na barra de menus do OpenEmu, como salvar e carregar estado, mostram o atalho de teclado ao lado, e o InputConfig pode colocar qualquer atalho em um botão que o OpenEmu deixa sem função, como um paddle do DualSense Edge ou o clique do touchpad.
A biblioteca. O mesmo controle pode mover o ponteiro do Mac pela biblioteca de jogos e passar o controle ao OpenEmu quando um jogo abre.

Em resumo

Permissões. Permita Input Monitoring para o teclado e Bluetooth para controles sem fio, e depois abra o OpenEmu de novo.
Controls. Escolha o controle por console e por jogador.
Interferência. Feche o Steam e os apps que alteram entradas enquanto testa.

A maioria dos problemas de controle no OpenEmu é um seletor de permissão.

Perguntas

O OpenEmu tem suporte ao controle de PS5?

Sim. O DualSense está no banco de dados de controles do OpenEmu com um layout automático. Se ele não faz nada, confira as permissões Input Monitoring e Bluetooth do OpenEmu em Privacidade e Segurança e depois escolha-o em Controls.

Por que o teclado não funciona no OpenEmu em um Mac?

O OpenEmu precisa da permissão Input Monitoring para o teclado. Ative em System Settings, Privacidade e Segurança, Input Monitoring, depois feche e abra o OpenEmu de novo. O teclado tem uma página própria, com os apps que o bloqueiam.

Como mudo os controles no OpenEmu?

Abra os ajustes do OpenEmu, vá para Controls, escolha o console e o seu controle, depois clique em cada botão da imagem e pressione o botão que você quer. Cada console tem o próprio mapeamento.

O OpenEmu funciona com um controle de Xbox 360?

Com o de cabo, não no macOS atual, porque o próprio macOS não tem suporte a ele. Os controles Xbox One e Series funcionam por Bluetooth.

O OpenEmu ainda recebe atualizações?

A versão mais recente é a 2.4.1, de dezembro de 2023. Ela ainda roda no macOS atual para a maioria das pessoas, e por isso os passos de permissão importam mais do que a versão.

Mais em português

Guias completos, em inglês

Quem escreve. Ryleigh Newman desenvolve o InputConfig e usa o próprio Mac todos os dias com um controle, porque as mãos não funcionam bem. Esta página foi traduzida do inglês. Os principais botões e menus do app aparecem em português quando o Mac está em português; esta página os chama assim, com o nome em inglês entre parênteses. O restante do app e do site está em inglês.

Esta página em outros idiomas: English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文

Grátis. macOS 14 ou posterior. Sem conta, nada sai do seu Mac. Código aberto no GitHub.