You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

HoloLens空间映射不可用:Unity新版本SpatialMappingRenderer报错咨询

解决Unity新版本打开Origami示例出现SpatialMappingRenderer找不到的问题

这个问题本质是Unity混合现实开发工具链迭代带来的API兼容性问题,我来给你拆解清楚:

为什么Unity 2017.2.5f1能正常运行

你用的这个版本是微软Holograms 101教程最初发布时配套的专属稳定版本,当时Unity把HoloLens开发所需的核心组件(包括SpatialMappingRenderer这类空间映射相关类)直接内置在了编辑器的HoloLens SDK里,不需要额外安装工具包,所以旧示例项目能直接识别并运行这些类。

新版本Unity的变化

从Unity 2018系列开始,微软对混合现实开发工具进行了重构:

  • 原本内置在Unity中的HoloLens专属组件被迁移到了Mixed Reality Toolkit (MRTK),不再默认随Unity编辑器安装。
  • 旧的SpatialMappingRenderer类已经被MRTK中的新组件(比如Spatial Awareness Mesh Renderer)替代,API结构和使用方式都有变化,直接打开旧项目自然会找不到这个类。

两种解决思路

1. 适配新版本Unity(推荐长期使用)

如果想在Unity 2018+的LTS版本中运行这个示例,需要:

  • 安装对应版本的MRTK(比如MRTK 2适合Unity 2018-2020,MRTK 3适配更高版本)
  • 修改项目中SpatialMapping.cs的代码:替换SpatialMappingRenderer的引用,改用MRTK提供的空间感知API。你可以参考MRTK官方的空间映射示例来调整代码逻辑。

2. 继续使用兼容版本

如果只是想快速运行原始示例完成教程,保持使用Unity 2017.2.5f1是最省心的选择——这个版本和Origami示例的代码完全匹配,不需要做任何修改。

补充:微软的混合现实教程会随Unity和MRTK版本持续更新,现在的新版教程已经基于MRTK 2/3开发,旧的Origami示例属于早期版本的教学内容,所以跨版本会出现API不兼容的情况。

内容的提问来源于stack exchange,提问作者NPadrutt

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.12 04:33:25