Émulateur de Contrôleur est un widget dans Roblox Studio qui émule les dispositifs que les joueurs utilisent pour contrôler votre expérience : manettes, casques et contrôleurs VR, consoles portables et télécommandes. Il affiche une image du dispositif que vous choisissez, envoie de vrais événements d'entrée lorsque vous cliquez dessus ou appuyez sur une touche mappée, et illumine ses contrôles à mesure que l'entrée arrive, vous permettant ainsi de tester un schéma de contrôle orienté manette ou une interaction VR, sans posséder l'un ou l'autre.
L'émulation d'entrée est distincte de la simulation d'un dispositif. Simulateur de Dispositif change l'écran, la plateforme et le matériel sur lequel votre expérience croit qu'elle fonctionne. L'Émulateur de Contrôleur change ce qui y est branché. Les deux sont généralement utilisés ensemble.
Ouvrir l'Émulateur de Contrôleur
Soit :
- Cliquez sur Contrôleur virtuel dans la barre d'outils du Simulateur de Dispositif, ou
- Cliquez sur Contrôleur dans l'onglet de la barre d'outils Émulation.
Le widget nécessite un lieu ouvert. Pendant que vous êtes en test de jeu, ouvrir le widget connecte le dispositif émulé et le fermer le déconnecte, vous permettant de brancher et débrancher le contrôleur en cours de session.
Émuler un dispositif
Le menu déroulant en haut du widget sélectionne le dispositif à émuler.

| Dispositif | Émule |
|---|---|
| Manette Générique | Une manette sans nommage de bouton spécifique au fournisseur. |
| PS4 | Un contrôleur PlayStation 4. |
| PS5 | Un contrôleur PlayStation 5. |
| Xbox | Un contrôleur Xbox. |
| Console Portable Générique | Un PC portable avec des contrôles intégrés. |
| Télécommande TV | Une télécommande Android TV, y compris son pavé directionnel et les boutons central et retour. |
| Quest2 / Quest3 | Casques et contrôleurs Meta Quest. |
Votre expérience voit le type de manette correspondant, donc le code qui se ramifie sur Enum.GamepadType ou qui lit l'ensemble de boutons d'un contrôleur se comporte comme s'il était attaché au véritable dispositif.
Envoyer une entrée
L'entrée peut provenir de trois sources, et le widget montre ce qui est arrivé de chacune d'elles : à mesure que l'entrée est reçue, y compris d'un vrai contrôleur que vous avez branché, le contrôle correspondant sur l'image du dispositif s'illumine. C'est le moyen le plus rapide de confirmer que l'entrée que votre expérience a reçue est celle que vous vouliez envoyer.
Contrôles du dispositif
Les boutons, les gâchettes et les joysticks sur l'image du dispositif sont interactifs. Cliquez ou faites-les glisser pour envoyer une entrée. Les gâchettes et les joysticks rapportent des valeurs analogiques, pas seulement pressées et relâchées, vous permettant de tester un tir partiel ou un mouvement lent du joystick.
Clavier
Tant que le widget a le focus, l'entrée du clavier est transmise au dispositif émulé en utilisant ses mappages actuels. C'est ce qui vous permet de tester un schéma de contrôle à vitesse, avec les deux mains, comme un joueur le ferait. Voir Modifier les mappages pour changer quelle touche contrôle quel contrôle.
Poses de casque et de main
La VR n'a pas de contrôle unique à cliquer. Son entrée est une pose de tête et deux poses de main, donc lorsqu'un dispositif VR est émulé, le widget ajoute des contrôles pour les déplacer.
Casque, Contrôleur Gauche et Contrôleur Droit ont chacun un interrupteur. Les parties activées répondent à votre clavier et à votre souris, et les parties désactivées restent immobiles. Déplacer la tête et une main indépendamment est ce qui vous permet de tester si une interaction dépend de l'endroit où le joueur regarde.
| Action | Entrée |
|---|---|
| Déplacer | Shift + W / A / S / D |
| Voler haut/bas | Shift + E / Q |
| Faire pivoter | Déplacement de la souris |
| Incliner | Clic droit + déplacement de la souris |
| Changer de contrôleurs | Shift + Gauche / Droite |
| Basculer le verrouillage du curseur | Alt + 1 |
| Basculer l'émulation de la souris | Alt + Échap |
Cliquez sur la vue 3D pour interagir avec la scène VR.
Sensibilité de translation échelle la distance que les parties activées parcourent par pression de touche, de 1 à 10. Diminuez-la lorsque vous positionnez une main contre une petite cible, et augmentez-la pour traverser la scène. Réinitialiser les Positions ramène la tête et les deux mains à leur pose par défaut pendant un test de jeu, ce qui est le moyen le plus rapide de sortir d'une pose dont vous ne pouvez pas vous remettre manuellement.
Modifier les mappages
Chaque dispositif émulé a ses propres mappages de clavier, donc W peut signifier une chose sur une manette et une autre sur une télécommande TV. Cliquez sur Modifier les mappages pour ouvrir l'éditeur de mappage, qui montre l'image du dispositif avec chaque contrôle étiqueté par la touche actuellement liée à celui-ci.

Pour remapper un contrôle, cliquez sur son étiquette, puis appuyez sur la touche ou les touches que vous souhaitez lier à celui-ci. Survoler une étiquette met en surbrillance le contrôle qu'elle pilote sur l'image, vous permettant de savoir quel contrôle physique vous êtes sur le point de reconfigurer.
- Si la touche que vous appuyez est déjà liée à un autre contrôle, l'ancienne liaison est supprimée et un avertissement vous indique laquelle, plutôt que de laisser silencieusement deux contrôles sur une seule touche.
- Enregistrer valide vos modifications sur le dispositif.
- Restaurer les Valeurs par Défaut ramène le dispositif à ses mappages d'origine, après confirmation.
Les mappages sont stockés par dispositif et persistent entre les sessions.
Associer avec le Simulateur de Dispositif
L'Émulateur de Contrôleur suit le dispositif que vous simulez. Sélectionner une console, un casque, une console portable ou un dispositif Android TV dans Simulateur de Dispositif change l'Émulateur de Contrôleur pour le contrôleur correspondant, de sorte que le matériel simulé et l'entrée émulée restent cohérents sans que vous ayez à configurer les deux.
Exemples de flux de travail
- Tester un schéma de contrôle orienté manette. Simulez une console dans le Simulateur de Dispositif et son contrôleur ici, puis pilotez entièrement votre expérience depuis la manette émulée. Tout ce que vous ne pouvez pas atteindre est un vide dans votre navigation de manette.
- Confirmer que l'entrée arrive. Regardez l'image du dispositif pendant que vous jouez. Si un contrôle ne s'illumine pas, le problème se situe en amont de votre gestion des entrées.
- Tester les seuils analogiques. Faites glisser une gâchette ou un joystick lentement et vérifiez où vos zones mortes et seuils d'activation se déclenchent réellement.
- Tester une interaction VR une main à la fois. Désactivez le casque et un contrôleur, puis déplacez la main restante en position pour vérifier la portée, les volumes de saisie et si l'interaction dépend du regard.
- Tester la navigation avec la télécommande TV. Simulez un dispositif Android TV et confirmez que votre interface utilisateur est entièrement navigable avec un pavé directionnel, un bouton central et un bouton retour.
- Valider les mappages personnalisés. Reconfigurez les contrôles que vous utilisez le plus et jouez avec le clavier, ce qui est plus rapide que de cliquer sur l'image pour tout ce qui implique du timing.