求基于MRTK 2.5.1的全息远程手部跟踪场景稳定运行最小项目配置

我帮你梳理了一套经过社区验证的最小配置方案，能解决你用MRTK 2.5.1 + Unity 2019.4.13f1时遇到的崩溃问题，确保手部跟踪示例稳定运行：

核心版本匹配（关键！） #

版本不兼容是这类崩溃的最常见原因，建议替换为以下稳定组合：

• Unity版本：2019.4.31f1 LTS（2019.4.x系列的后期稳定版，修复了多个XR SDK和Hololens 2适配bug，比你用的13f1更可靠）
• MRTK版本：2.5.7（2.5.x分支的最终稳定版，修复了2.5.1中的手部跟踪内存泄漏、USB连接稳定性问题）
• Windows XR Plugin：2.7.0（Unity内置XR插件，和上述版本兼容性拉满）

最小项目配置步骤 #

1. 初始化Unity项目 #

• 创建全新的3D模板项目，不要勾选初始Enable XR选项（手动配置更可控）
• 切换目标平台到UWP：
  1. 打开File > Build Settings，选择Universal Windows Platform，点击Switch Platform
  2. 在Player Settings中：
     • 设置Target Device为HoloLens，Architecture为ARM64
     • 勾选Allow unsafe code（MRTK的核心功能依赖此设置）
     • 关闭Graphics Jobs（旧Unity版本中该选项易导致Hololens 2崩溃）

2. 导入并配置MRTK #

• 通过Package Manager导入MRTK 2.5.7：
  1. 打开Window > Package Manager，点击+ > Add package from git URL
  2. 输入com.microsoft.mixedreality.toolkit.foundation@2.5.7，等待导入完成
• 运行MRTK配置向导：
  1. 打开Mixed Reality > Toolkit > Configure Mixed Reality Toolkit
  2. 选择DefaultHoloLens2ConfigurationProfile，点击Apply（这个预设已经帮你配置好了基础手部跟踪参数）

3. 启用基础手部跟踪 #

• 在MRTK配置Profile中，找到Input > Hand Tracking：
  • 确保Enable Hand Tracking已勾选，Hand Tracking Mode设为Both Hands
  • 暂时禁用Hand Mesh Visualization（减少性能开销，避免不必要的崩溃）
• 场景中添加MixedRealityPlayspace（如果没有自动生成，右键场景层级面板 > Mixed Reality > Playspace）
• 从Assets/MRTK/SDK/Prefabs/Input/HandTracking拖入DefaultHandVisualizer到场景，它会自动关联到Playspace的输入系统

4. USB部署与调试 #

• 确保Hololens 2已开启开发者模式：
  1. 在Hololens设置中进入Update & Security > For developers，启用Developer mode和Device discovery
  2. 用USB线连接Hololens 2和电脑，等待驱动安装完成
• 在Unity Build Settings中：
  • 设置Build and Run为USB Device，Build Configuration为Debug（调试模式下能快速排查剩余问题，稳定后可切换为Release）
  • 点击Build and Run，等待部署完成

额外崩溃排查提示 #

• 确保项目中没有其他XR相关插件（比如VRTK、Oculus SDK），避免冲突
• 简化场景：移除所有不必要的灯光、模型、脚本，只保留手部跟踪所需的核心元素
• 如果仍有崩溃，查看Hololens 2的设备日志：在Device Portal > System > Event Viewer中筛选Application日志，找到崩溃的具体原因

内容的提问来源于stack exchange，提问作者Isaak