Unity空间映射（Spatial mapping in Unity）

回复

命名空间: UnityEngine.VR.WSA.SurfaceObserver

本文主要介绍如何在Unity项目中使用空间映射功能。Unity中提供了对空间映射功能的支持，可通过以下方式提供给开发者：

1. 可以在HoloToolkit项目中找到空间映射组件，会提供便捷快速地路径开始使用空间映射特性。

2. 底层空间映射API，以便开发者能够完全控制空间映射特性，满足定制复杂应用的需求

为了在应用中使用空间映射功能，需要在AppxManifest（应用权限清单）中设置启用SpatialPerception性能。

设置SpatialPerception性能

为了使应用能够使用空间映射数据，SpatialPerception性能必须被启用。

可以通过使用以下步骤开启该功能：

1. 在Unity编辑器中，进入Player Settings选项（Edit > Project Settings > Player）

2. 点击Window Store选项卡

3. 展开Publish Settings选项，并在Capabilities列表勾选SpatialPerception选项

注意：如果你已经把Unity项目导出为Visual Studio项目，你需要重新导出修改后的项目到新文件夹或者手动在Visual Studio中修改AppxManifest应用清单。

空间映射特性也要求MaxVersionTested版本最低为10.0.10586.0：

1. Visual Studio项目解决方案，双击Package.appxmanifest文件，并右键选中查看源码方式打开

2. 找到TargetDeviceFamily这一行，并将MaxVersionTested="10.0.10240.0" 修改为 MaxVersionTested="10.0.10586.0"

3. 保存Package.appmanifest文件

空间映射组件

HoloToolkit为简单快速集成空间映射特性至应用提供了几个方案。

对于默认的空间映射需求，推荐使用SpatialMappingComponent目录下的 SpatialMappingCollider.cs 和 SpatialMapppingRenderer.cs脚本。如果你需要从网络或者文件载入空间网格，可以使用更为合适的SpatialMapping目录下的脚本。

更多的细节可以在HoloToolkit Github主页上找到。

如何使用API

命名空间: UnityEngine.VR.WSA

类型 SurfaceObserver, SurfaceChange, SurfaceData, SurfaceId

以下是应用推荐的使用空间映射API性能的大致流程。

设定SurfaceObserver对象

需要为每一个需要空间映射数据的空间区域在应用中初始化一个SurfaceObserver对象。

通过调用SetVolumeAsSphere、SetVolumeAsAxisAlignedBox、 SetVolumeAsOrientedBox、或 SetVolumeAsFrustum方法，为每个SurfaceObserver对象指定它们需要获取数据的空间区域。你还可以通过再次调用它们，重新定义检测空间区域范围。

当你调用SurfaceObserver.Update()时，需要提供每一个SurfaceObserver对象检测区域中的空间表面（spatial surface）指定事件处理方法。

处理空间表面变化

在此有几个需要处理的典型情形。Added和Updated状态可使用相同代码处理，Removed状态需要使用另一种代码处理。

· 在Added和Updated情形下，我们从字典中添加或获取代表当前网格的对象，使用必要的组件来创建一个SurfaceData结构体，然后调用RequestMeshDataAsync通过在场景中使用网格数据和位置来填充对象。

· Removed情况下，我们从字典中移除网格代表的对象并将它销毁。

处理DataReady事件

OnDataReady事件会接收到一个SurfaceData对象，它包含了WorldAnchor、MeshFilter和MeshCollider对象数据，表示了当前关联的空间表面最新状态。通过访问Mesh Filter对象的Mesh数据可以进行性能分析或者网格处理。使用最新的Mesh数据来渲染空间表面并将它用于物理碰撞或者射线击中对象。必须确认SurfaceData内容不是空的。

处理更新操作

SurfaceObserver.Update()只能延迟调用，不是每帧都可更新都调用。