转自：http://dev.arinchina.com/177wz/ar9625/9625/1
命名空间: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()只能延迟调用，不是每帧都可更新都调用。
HoloToolkit
HoloToolkit项目是基于Unity API封装的一系列很有用的全息开发代码工具集合，能帮助开发者快速集成HoloLens特性。
故障问题解决
· 确保你设置了 SpatialPreception性能
· 当追踪焦点丢失时，在接下来的OnSurfaceChanged事件处理中将会移除所有网格。
