Unity 2022 3D项目部署HoloLens 1黑屏问题求助

基础配置校验 #

• 检查XR插件设置：打开Edit > Project Settings > XR Plug-in Management，确保勾选Windows Mixed Reality（HoloLens 1不支持OpenXR，不要选错插件）。
• 修正相机参数：场景主相机的Clear Flags必须设为Depth Only（设为其他值会覆盖全息层导致黑屏），同时确认相机的Culling Mask包含立方体所在的层级（默认Default层级即可）。如果用MRTK，直接使用MRTK自带的Mixed Reality Camera组件，避免手动配置出错。
• 确认立方体可见性：立方体的位置不要超出相机视锥体范围，缩放比例不要过小/过大，建议放在相机前方1-2米处，确保在HoloLens的可视空间内。

MRTK适配调整 #

• 切换HoloLens 1专属配置：如果使用MRTK，在场景的Mixed Reality Toolkit组件中，将Profile切换为HoloLens 1 Default Profile（若无此配置，新建配置时禁用手部追踪、眼动追踪等HoloLens 1不支持的功能）。最新版MRTK默认适配HoloLens 2，强行用在HoloLens 1上会导致初始化失败。
• 精简功能模块：关闭MRTK中不必要的服务（比如语音命令、空间映射之外的感知功能），减少设备加载压力，避免因资源不足导致黑屏。

构建与部署参数检查 #

• Unity Player Settings配置：
  • 切换到Universal Windows Platform平台，Target Device设为HoloLens，Architecture选x86（HoloLens 1仅支持x86架构）。
  • 在Capabilities中必须勾选SpatialPerception（空间感知权限是全息显示的核心，缺失会导致黑屏），远程部署额外勾选PrivateNetworkClientServer和InternetClient。
• Visual Studio部署设置：部署时选择Release、x86，目标设备选Device（有线连接）或Remote Machine（无线需输入HoloLens的IP地址），确保Deployment Mode为Release（Debug模式可能因性能问题触发黑屏）。同时查看VS输出窗口，排查是否有初始化失败、权限拒绝等报错信息。

设备端问题排查 #

• 重启HoloLens 1：设备的全息服务偶尔会卡住，重启后可重置感知模块。
• 确认空间扫描状态：打开HoloLens设置，确保空间感知已开启，且设备已完成至少一次环境扫描（未扫描环境会导致空间定位失效，无法显示全息内容）。
• 查看应用日志：在VS中连接设备后，打开Debug > Windows > Device Log，过滤你的应用名称，定位是否有相机初始化失败、组件加载错误等关键日志。

最小项目验证 #

• 创建一个极简测试项目：不导入MRTK，仅添加一个立方体，手动配置XR插件和相机参数（Clear Flags设为Depth Only），构建UWP后部署到HoloLens 1。如果该项目能正常显示立方体，说明原项目的MRTK配置或自定义逻辑存在问题，需逐步排查添加的功能模块。

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