Unity构建应用后通过USB部署至HoloLens 1时出现报错

核心错误原因 #

你遇到的部署报错核心原因是HoloLens 1不支持你当前项目配置的凝视输入（Gaze Input）设备能力声明，你参考的教程默认适配的是HoloLens 2及更高版本设备，相关配置和HoloLens 1的运行环境不兼容。

解决方案 #

1. 修复Unity XR配置

• 打开Unity项目，进入Build Settings > UWP平台 > Player Settings > XR Plug-in Management，将当前启用的OpenXR插件替换为Windows XR Plugin（Legacy），HoloLens 1原生适配这套旧的XR接口，不存在输入能力不兼容问题。
• 如果必须保留OpenXR配置，需进入OpenXR的交互配置页，移除所有和凝视输入相关的绑定项，后续生成VS解决方案后还要手动删除清单文件里的gazeinput能力声明。

2. 修复USB无法识别存储空间问题

你当前遇到的USB只能充电不能读取存储的问题，优先排查以下两点：

• 更换支持数据传输的USB 3.0 A to C线，目前使用的线大概率仅支持供电，HoloLens 1对数据传输线的兼容性要求较高，优先用原装配套数据线。
• 打开PC端设备管理器，找到便携设备分类下的HoloLens条目，如果带有黄色感叹号，右键卸载设备后重新拔插HoloLens，系统会自动安装匹配驱动。连接设备前确保HoloLens处于解锁的主界面状态，锁屏状态会默认禁止PC访问内部存储。

3. 重新执行部署流程

• 删除之前生成的旧VS解决方案文件夹，在Unity里重新执行生成UWP解决方案操作，避免旧配置缓存残留。
• 打开新生成的VS解决方案，右键项目进入属性页，确认部署架构选择x86（HoloLens 1仅支持x86架构），部署目标选择「设备」。
• 打开项目内的Package.appxmanifest文件，进入「功能」标签页，确认列表内没有gazeinput选项，如有则手动取消勾选后保存。
• 重新执行部署操作即可正常安装应用到HoloLens 1设备。

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