控制器模拟器 是 Roblox Studio 中的一个小部件,它模拟玩家用来控制您体验的设备:游戏手柄、VR 头盔和控制器、掌中宝以及电视遥控器。它显示您选择的设备的图片,当您点击它或按下映射的键时,会发送真实的输入事件,并在输入到达时点亮其控制,因此您可以在不拥有任何设备的情况下测试以游戏手柄为主的控制方案或 VR 交互。
模拟输入与模拟设备是分开的。设备模拟器 更改您的体验认为正在运行的屏幕、平台和硬件。控制器模拟器更改插入的设备。通常这两者是一起使用的。
打开控制器模拟器
您可以:
- 点击设备模拟器工具栏中的 虚拟控制器,或
- 点击 仿真 工具栏选项卡中的 控制器。
该小部件需要一个打开的场所。在您进行游戏测试时,打开小部件会连接模拟设备,关闭它会断开连接,因此您可以在会话中插拔控制器。
模拟设备
小部件顶部的下拉菜单选择要模拟的设备。

| 设备 | 模拟 |
|---|---|
| 通用游戏手柄 | 没有特定厂商按钮命名的游戏手柄。 |
| PS4 | PlayStation 4 控制器。 |
| PS5 | PlayStation 5 控制器。 |
| Xbox | Xbox 控制器。 |
| 通用掌中宝 | 带有内置控制的掌中宝 PC。 |
| 电视遥控器 | 包括方向键和中心及返回按钮的 Android TV 遥控器。 |
| Quest2 / Quest3 | Meta Quest 头盔和控制器。 |
您的体验会看到相应的游戏手柄类型,因此在 Enum.GamepadType 上分支的代码或读取控制器的按钮集的行为与真实设备连接时相同。
发送输入
输入可以来自三个地方,小部件显示来自任何地方的输入:当接收到输入时,包括您插入的真实控制器,设备图片上的匹配控制会高亮显示。这是确认您的体验接收到的输入是您想要发送的输入的最快方式。
设备控制
设备图片上的按钮、触发器和摇杆是互动的。点击或拖动它们以发送输入。触发器和摇杆报告模拟值,而不仅仅是按下和释放,因此您可以测试部分拉动或缓慢的摇杆移动。
键盘
当小部件获得焦点时,键盘输入会根据其当前映射转发到模拟设备。这使您能够以玩家使用的方式快速测试控制方案,双手同时操作。请参见 编辑映射 以更改哪个键驱动哪个控制。
头盔和手部姿势
VR 没有单一的控制可供点击。它的输入是头部姿势和两个手部姿势,因此当模拟 VR 设备时,小部件会添加用于移动它们的控制。
头盔、左控制器和右控制器各有一个切换开关。启用的部分会响应您的键盘和鼠标,而禁用的部分则保持静止。独立移动头部和一只手可以让您测试交互是否依赖于玩家的视线位置。
| 动作 | 输入 |
|---|---|
| 移动 | Shift + W / A / S / D |
| 向上/向下飞行 | Shift + E / Q |
| 旋转 | 鼠标移动 |
| 倾斜 | 右键点击 + 鼠标移动 |
| 切换控制器 | Shift + 左 / 右 |
| 切换光标锁定 | Alt + 1 |
| 切换鼠标模拟 | Alt + Esc |
点击 3D 视口与 VR 场景进行交互。
移动灵敏度 设定了每次按键时启用部分的移动距离,从 1 到 10。当您将手放在小目标上时,降低它;在穿越场景时提高它。重置位置 在游戏测试期间将头部和双手返回到默认姿势,这是快速摆脱无法手动恢复的姿势的最佳方法。
编辑映射
每个模拟设备都有自己的键盘映射,因此 W 在游戏手柄上可以表示一种含义,而在电视遥控器上则表示另一种含义。点击 编辑映射 打开映射编辑器,显示设备图片以及每个控制的当前绑定键。

要重新映射控制,点击其标签,然后按下您想要绑定的键。悬停在标签上会高亮显示它在图片上驱动的控制,因此您可以知道您即将重新绑定哪个物理控制。
- 如果您按下的键已经绑定到另一个控制,旧的绑定会被移除,并且会有警告告诉您是哪个,而不是默默地让两个控制在一个键上。
- 保存 将您的更改提交到设备。
- 恢复默认 在确认后将设备恢复到其原始映射。
映射是按设备存储的,并在会话之间保持不变。
与设备模拟器配对
控制器模拟器跟随您正在模拟的设备。在 设备模拟器 中选择一个控制台、头盔、掌中宝或 Android TV 设备会将控制器模拟器切换到匹配的控制器,因此模拟硬件和模拟输入保持一致,而无需您同时设置两者。
示例工作流程
- 测试以游戏手柄为主的控制方案。 在设备模拟器中模拟一个控制台,并在这里模拟其控制器,然后完全通过模拟的手柄驱动您的体验。任何您无法到达的地方都是您游戏手柄导航中的一个缺口。
- 确认输入是否到达。 在您玩游戏时观察设备图片。如果某个控制没有亮起,问题出在您的输入处理上游。
- 测试模拟阈值。 缓慢拖动触发器或摇杆,检查您的死区和激活阈值实际触发的位置。
- 一次测试一个手的 VR 交互。 禁用头盔和一个控制器,然后将剩余的手移动到位置以检查可达性、抓取体积以及交互是否依赖于视线。
- 测试电视遥控器导航。 模拟一个 Android TV 设备,并确认您的 UI 可以完全通过方向键、中心按钮和返回按钮进行导航。
- 验证自定义映射。 重新绑定您最常用的控制,并使用键盘进行游戏,这比点击图片更快,尤其是涉及时机的操作。