空间映射渲染器 (Spatial Mapping Renderer)

__空间映射渲染器__组件提供空间映射表面的可视化表示。这对于通过可视化方式调试表面并向环境添加视觉效果非常有用。

系统定期向__空间映射渲染器__组件发送有关物理空间变化的数据。每次由空间映射系统向该组件通知这些变化时，该组件都会将返回的表面数据烘焙到包含网格过滤器 (Mesh Filter) 和网格渲染器 (Mesh Renderer) 组件的游戏对象中。空间映射渲染器组件会管理这些表面游戏对象的生命周期。也就是说，该组件负责在场景中创建、更新和销毁表面游戏对象网格渲染器。

Render Settings

下表列出了__空间映射渲染器__组件可用的所有唯一渲染设置 (Render Settings)。

General Settings

以下是__空间映射渲染器 (Spatial Mapping Renderer)__ 和__空间映射碰撞体 (Spatial Mapping Collider)__ 组件的共同设置。

Level of Detail

两个空间映射组件都允许为每个组件生成的空间网格指定三个细节级别之一（Low、Medium 或 High），如下图所示。

如果可能，请将 Spatial Mapping Colliders 的 Level of Detail 设置为 Low。这样将在计算碰撞交点时提高性能并降低功耗。但是，将 Level of Detail 设置为 Low 可能会对应用程序的视觉效果产生负面影响。

使用空间映射渲染器

Render State

此组件提供了一种动态更改所有生成的表面上的材质的简便方法。Unity 提供了两种预先构建的材质类型供您使用：

Occlusion Material

此材质使游戏对象看起来透明，但通过游戏对象看不到全息图。例如，如果需要一个真实的桌子来隐藏位于其下方的游戏内全息对象，这可能会很有用。

Visual Material

这是 Unity 应用于空间映射渲染器组件中所有表面的线框材质。使用默认的线框着色器时，线框的颜色代表真实世界的距离。这通常是进行调试时最有用的选项，但也可以将其用于呈现视觉效果。该着色器使用颜色映射来指示距离；下表显示了这种颜色映射：

将新材质指定给 Visual Material 或 Occlusion Material 时，表面游戏对象的材质不会自动更改。要将新材质应用于所有表面，必须将 Render State 设置为已更改的材质（__Visual Material__ 或 __Occlusion Material__）。

如果仅从 Unity Editor 中（直接在场景中的游戏对象上）分配 Render State 中的 Occlusion Material 或 Visual Material 属性，则空间映射会与__空间映射渲染器__组件同时销毁它们。但是，空间映射不会销毁通过脚本随组件分配或更改的任何 Occlusion Material 或 __Visual Material__，因此需要手动销毁它们。

下面的代码片段会更改空间映射在运行时动态应用于所有表面游戏对象的材质。

SpatialMappingRenderer renderer = spatialMappingGameObject.AddComponent<SpatialMappingRenderer>();
renderer.visualMaterial = new Material(Shader.Find("VR/SpatialMapping/Wireframe"));
renderer.renderState = SpatialMappingRenderer.RenderState.Visualization;

表面游戏对象

__空间映射渲染器__组件会在运行时创建自己独立的一组表面游戏对象。这些游戏对象出现在场景中作为一个表面父游戏对象的子项：

__空间映射渲染器__生成的表面游戏对象包含以下组件

• 网格过滤器 (Mesh Filter)

• 世界锚点 (World Anchor)

• 网格渲染器 (Mesh Renderer)

• 共享的材质（此材质为 Visualization 或 Occlusion Material，具体取决于 Render State 设置）

如果将多个__空间映射渲染器__组件添加到场景，则每个组件都会生成自己的一组表面游戏对象。例如，如果有两个游戏对象包含__空间映射渲染器__组件，则场景将包含两组表面游戏对象：每个组件在运行时生成一组。为了优化目的，请务必牢记这一点。

• 2018–05–01 页面已发布并进行了编辑审查

• 在 2017.3 版中更新了 Hololens 空间映射文档