# Unity 2022 中 MRTK3 Input Simulator 无法使用 WASD 控制的排查记录
在混合现实开发中，MRTK3 的 Input Simulator 是脱离真机调试的核心工具，其通过键盘鼠标模拟手部交互与相机移动的功能，直接影响开发效率。然而，升级至 Unity 2022 并导入 MRTK3 后，部分开发者遇到了典型问题：鼠标点击交互正常，但 WASD 键无法控制相机移动。本文将完整记录这一问题的排查过程与解决方案。
## 问题现象与初步判断
项目环境为 Unity 2022.3.49 LTS 与 MRTK 3.2.0。导入 MRTK3 示例场景后，通过鼠标可正常点击 UI 面板，手部模拟器也能响应鼠标拖拽，但按下 W/A/S/D 键时，相机视角毫无反应。键盘其他按键如 Q/E（升降）、Shift（加速）同样无效。
初步判断问题可能出现在三个层面：Input Simulator 组件配置异常、Unity 输入系统兼容性问题、或 MRTK3 依赖包缺失。
## 排查步骤一：Input Simulator 组件检查
首先检查场景中的 MixedRealityToolkit 与 InputSimulator 配置。在 Hierarchy 窗口选中 MixedRealityPlaySpace，检查其子物体 InputSimulator 上的组件状态。
```csharp
// InputSimulator 的关键配置项
// - Hand Simulation Mode: Two-Handed 或 ArrowsAndKeys
// - Camera Control Mode: WASD 或 Mouse
// - Fly Speed: 相机移动速度
```
确认 Hand Simulation Mode 设置为 "Two-Handed"（支持 WASD），Camera Control Mode 为 "WASD"，Fly Speed 设为正常值（如 2.0）。这些设置均无误，排除组件配置问题。
## 排查步骤二：输入系统兼容性验证
MRTK3 基于 Unity 的 Input System 包处理输入，与旧版 Input Manager 存在差异。在 Unity 2022 中，如果项目同时启用了两种输入系统，可能导致按键事件无法正确传递。
打开 Edit → Project Settings → Player → Active Input Handling，检查设置：
<"vds.j9k5.org.cn"><"kfc.j9k5.org.cn"><"doro.j9k5.org.cn">
```text
Active Input Handling 选项：
- Input Manager (旧版)
- Input System Package (新版)
- Both (两者并存)
```
部分项目升级后默认设为 "Both"，但某些情况下 "Both" 模式会导致 MRTK3 的 Input System 无法正常监听键盘事件。尝试切换为 "Input System Package (新版)"，重启 Unity 后问题依旧。
进一步检查 Package Manager 中 Input System 包的版本，确保其与 MRTK3 兼容。MRTK3 官方要求 Input System 版本不低于 1.5.0，当前项目使用 1.7.0，满足要求。
## 排查步骤三：XRI 与 XR Interaction Subsystem 检查
MRTK3 依赖 XR Interaction Toolkit（XRI）处理设备输入。Input Simulator 实际是通过 XRI 的模拟设备（XR Simulated HMD）来实现键盘控制相机的功能。因此，XRI 包的完整性与 XR Interaction Subsystem 的注册状态直接影响 WASD 功能。
打开 Window → Analysis → XR Interaction Debugger，查看 Simulated Devices 节点：
- 若 "Simulated HMD" 设备存在且状态正常，说明 XRI 模拟设备已注册
- 若该节点缺失，则说明 XR Interaction Subsystem 未正常初始化
检查结果发现 XR Interaction Debugger 中仅有物理设备，Simulated HMD 设备未出现，问题定位至此。
## 排查步骤四：Subsystem Registry 手动注册
查阅 MRTK3 源码与 XRI 文档发现，Input Simulator 启动时会通过 SubsystemManager 注册 XR 模拟设备子系统。但在某些 Unity 2022 版本中，Subsystem 的自动注册可能因加载顺序问题而失败。
尝试在场景启动时手动触发注册：
```csharp
using UnityEngine;
using UnityEngine.XR.Management;
public class ForceSubsystemInitialization : MonoBehaviour
{
void Awake()
{
// 确保 XR General Settings 已初始化
if (XRGeneralSettings.Instance != null &&
XRGeneralSettings.Instance.Manager != null)
{
XRGeneralSettings.Instance.Manager.InitializeLoaderSync();
XRGeneralSettings.Instance.Manager.StartSubsystems();
}
}
}
```
将此脚本挂载到 MixedRealityPlaySpace 上，运行测试，问题依然存在。说明子系统注册并非简单通过启动 XR Manager 就能解决。
## 最终解决方案：手动启用 Simulated Devices
深入 XRI 源码发现，Simulated Devices 的启用受静态属性 `SimulatedDeviceSettings.enableSimulatedDevices` 控制。在某些环境下，该属性默认可能为 `false`，需手动开启。
在游戏启动或 Input Simulator 初始化前添加以下代码：
```csharp
using UnityEngine.XR.Interaction.Toolkit;
<"cctc.j9k5.org.cn"><"awm.j9k5.org.cn"><"xox.j9k5.org.cn">
public class EnableSimulatedDevices : MonoBehaviour
{
void Start()
{
// 强制启用模拟设备
SimulatedDeviceSettings.enableSimulatedDevices = true;
// 可选：等待一帧确保设备注册完成
StartCoroutine(WaitForSimulatedDevices());
}
System.Collections.IEnumerator WaitForSimulatedDevices()
{
yield return null; // 等待一帧
Debug.Log("Simulated Devices Enabled: " +
SimulatedDeviceSettings.enableSimulatedDevices);
}
}
```
将此脚本添加到场景中任意 GameObject 上，运行后 WASD 立即恢复控制。
## 原因分析与经验总结
### 根本原因
Unity 2022 中，XR Interaction Subsystem 的初始化顺序发生变化。当项目首 次运行时，`SimulatedDeviceSettings.enableSimulatedDevices` 可能未正确同步，导致模拟设备注册失败。尽管 Input Simulator 组件尝试启动模拟设备，但底层子系统尚未就绪，因此按键事件无法路由到相机控制逻辑。
### 预防措施
为后续项目避免类似问题，可采取以下措施：
1. **保留关键脚本**：将 `EnableSimulatedDevices` 脚本作为项目模板的一部分，确保新项目自动包含模拟设备启用逻辑。
2. **检查 XR Interaction Debugger**：在遇到输入问题时，优先查看 Debugger 窗口确认模拟设备状态，这是最直接的诊断手段。
3. **避免 Both 模式**：除非有特殊需求，尽量将 Active Input Handling 设为 "Input System Package"，减少输入路由的复杂性。
## 结语
MRTK3 Input Simulator WASD 失效问题的排查，本质上是对 Unity 输入系统与 XR 子系统初始化流程的深入理解过程。通过 XR Interaction Debugger 定位问题根源，并通过手动启用模拟设备解决，这一经验为后续 MRTK3 项目开发提供了参考。在跨版本升级时，开发者需保持对底层机制变化的敏感，同时善用调试工具定位问题，而非停留于表层配置检查。