Emulador de Controlador é um widget no Roblox Studio que emula os dispositivos que os jogadores usam para controlar sua experiência: gamepads, headsets e controladores de VR, portáteis e controles remotos de TV. Ele mostra uma imagem do dispositivo que você escolhe, envia eventos de entrada reais quando você clica nele ou pressiona uma tecla mapeada, e ilumina seus controles à medida que a entrada chega, para que você possa testar um esquema de controle focado em gamepad ou uma interação de VR, sem possuir nenhum dos dois.
Emular entrada é separado de simular um dispositivo. Simulador de Dispositivo muda a tela, a plataforma e o hardware que sua experiência acredita estar rodando. O Emulador de Controlador muda o que está conectado a ele. Os dois são geralmente usados juntos.
Abrir Emulador de Controlador
Ou:
- Clique em Controlador Virtual na barra de ferramentas do Simulador de Dispositivo, ou
- Clique em Controlador na aba da barra de ferramentas Emulação.
O widget requer um lugar aberto. Enquanto você estiver em um teste de jogo, abrir o widget conecta o dispositivo emulado e fechá-lo desconecta, para que você possa conectar e desconectar o controlador durante a sessão.
Emular um dispositivo
O dropdown na parte superior do widget seleciona o dispositivo a ser emulado.
| Dispositivo | Emula |
|---|---|
| Gamepad Genérico | Um gamepad sem nomenclatura de botão específica do vendedor. |
| PS4 | Um controlador PlayStation 4. |
| PS5 | Um controlador PlayStation 5. |
| Xbox | Um controlador Xbox. |
| Portátil Genérico | Um PC portátil com controles integrados. |
| Controle Remoto de TV | Um controle remoto de Android TV, incluindo seu painel direcional e botões de centro e voltar. |
| Quest2 / Quest3 | Headsets e controladores Meta Quest. |
Sua experiência vê o tipo de gamepad correspondente, então o código que ramifica em Enum.GamepadType ou lê o conjunto de botões de um controlador se comporta como se o dispositivo real estivesse conectado.
Enviar entrada
A entrada pode vir de três lugares, e o widget mostra o que chegou de qualquer um deles: à medida que a entrada é recebida, incluindo de um controlador real que você tenha conectado, o controle correspondente na imagem do dispositivo se destaca. Essa é a maneira mais rápida de confirmar que a entrada que sua experiência recebeu é a entrada que você pretendia enviar.
Controles do dispositivo
Botões, gatilhos e thumbsticks na imagem do dispositivo são interativos. Clique ou arraste-os para enviar entrada. Gatilhos e thumbsticks reportam valores analógicos, não apenas pressionados e liberados, para que você possa testar um puxão parcial ou um movimento lento do stick.
Teclado
Enquanto o widget tem foco, a entrada do teclado é encaminhada para o dispositivo emulado usando seus mapeamentos atuais. Isso é o que permite que você teste um esquema de controle em velocidade, com ambas as mãos, da maneira que um jogador usaria. Veja Editar mapeamentos para mudar qual tecla controla qual controle.
Poses do headset e das mãos
VR não tem um único controle para clicar. Sua entrada é uma pose da cabeça e duas poses das mãos, então quando um dispositivo de VR é emulado, o widget adiciona controles para movê-los.
Headset, Controlador Esquerdo e Controlador Direito têm cada um um interruptor. Partes ativadas respondem ao seu teclado e mouse, e partes desativadas permanecem paradas. Mover a cabeça e uma mão independentemente é o que permite que você teste se uma interação depende de onde o jogador está olhando.
| Ação | Entrada |
|---|---|
| Mover | Shift + W / A / S / D |
| Voar para cima/baixo | Shift + E / Q |
| Rotacionar | Movimento do mouse |
| Inclinar | Botão direito do mouse + movimento do mouse |
| Trocar controladores | Shift + Esquerdo / Direito |
| Alternar bloqueio do cursor | Alt + 1 |
| Alternar emulação do mouse | Alt + Esc |
Clique na visualização 3D para interagir com a cena de VR.
Sensibilidade de tradução escala quão longe as partes ativadas se movem por pressionamento de tecla, de 1 a 10. Reduza quando você estiver posicionando uma mão contra um pequeno alvo e aumente para atravessar a cena. Redefinir Posições retorna a cabeça e ambas as mãos para sua pose padrão durante um teste de jogo, que é a maneira mais rápida de sair de uma pose da qual você não pode se recuperar manualmente.
Editar mapeamentos
Cada dispositivo emulado tem seus próprios mapeamentos de teclado, então W pode significar uma coisa em um gamepad e outra em um controle remoto de TV. Clique em Editar mapeamentos para abrir o editor de mapeamentos, que mostra a imagem do dispositivo com cada controle rotulado pela tecla atualmente vinculada a ele.
Para remapear um controle, clique em seu rótulo, depois pressione a tecla ou teclas que você deseja vincular a ele. Passar o mouse sobre um rótulo destaca o controle que ele aciona na imagem, para que você possa saber qual controle físico você está prestes a reconfigurar.
- Se a tecla que você pressionar já estiver vinculada a outro controle, a vinculação anterior é removida e um aviso informa qual é, em vez de deixar silenciosamente dois controles em uma tecla.
- Salvar confirma suas alterações no dispositivo.
- Restaurar Padrões retorna o dispositivo para seus mapeamentos originais, após uma confirmação.
Os mapeamentos são armazenados por dispositivo e persistem entre sessões.
Emparelhar com o Simulador de Dispositivo
O Emulador de Controlador segue o dispositivo que você está simulando. Selecionar um console, headset, portátil ou dispositivo Android TV no Simulador de Dispositivo troca o Emulador de Controlador para o controlador correspondente, para que o hardware simulado e a entrada emulada permaneçam consistentes sem que você precise configurar ambos.
Exemplos de fluxos de trabalho
- Teste um esquema de controle focado em gamepad. Simule um console no Simulador de Dispositivo e seu controlador aqui, depois conduza sua experiência inteiramente a partir do pad emulado. Qualquer coisa que você não conseguir alcançar é uma lacuna na sua navegação com gamepad.
- Confirme que a entrada está chegando. Observe a imagem do dispositivo enquanto você joga. Se um controle não se iluminar, o problema está antes do seu manuseio de entrada.
- Teste limiares analógicos. Arraste um gatilho ou thumbstick lentamente e verifique onde suas zonas mortas e limiares de ativação realmente disparam.
- Teste uma interação de VR uma mão de cada vez. Desative o headset e um controlador, depois mova a mão restante para a posição para verificar alcance, volumes de captura e se a interação depende do olhar.
- Teste a navegação do controle remoto de TV. Simule um dispositivo Android TV e confirme que sua interface do usuário é totalmente navegável com um painel direcional, um botão central e um botão de voltar.
- Valide mapeamentos personalizados. Reconfigure os controles que você mais usa e jogue com o teclado, que é mais rápido do que clicar na imagem para qualquer coisa que envolva tempo.