空间映射碰撞体 (Spatial Mapping Collider)

__空间映射碰撞体__组件允许全息内容与真实世界的物理表面进行交互。该组件负责在场景中创建、更新和销毁表面游戏对象碰撞体。

该组件定期向系统查询物理世界中的表面更改。当系统报告有表面更改时，__空间映射碰撞体__组件会确定 Unity 对每个报告的表面进行烘焙的先后时间。系统每次烘焙表面时，Unity 都会生成一个新的游戏对象，使其包含网格过滤器 (Mesh Filter) 和网格碰撞体 (Mesh Collider) 组件。与 Unity 中的任何其他网格一样，具有网格碰撞体的表面允许与射线投射进行碰撞。请参阅摄像机射线投射文档以了解更多信息。

__注意：__此组件仅更新表面游戏对象的网格碰撞体组件，而不更新网格渲染器 (Mesh Renderer)。

注意：空间映射碰撞体__的更新延迟比__空间映射网格渲染器 (Spatial Mapping Mesh Renderer) 更短。这意味着碰撞体的更新速度比渲染器快。

Collider 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 可能会对应用程序的视觉效果产生负面影响。

使用空间映射碰撞体

表面游戏对象

将__空间映射碰撞体__组件添加到场景中的游戏对象时，该组件会在运行时生成自己独立的一组表面游戏对象。这些游戏对象出现在场景中作为一个表面父游戏对象的子项。

__空间映射碰撞体__生成的表面游戏对象包含以下组件：

• 网格过滤器 (Mesh Filter)

• 世界锚点 (World Anchor)

• 网格碰撞体 (Mesh Collider)

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

注意：__所有__表面游戏对象__首次由空间映射系统生成时都会分配给__默认层 (Default Layer)。但是，最好将游戏对象分配给特定层，因为射线投射是一项高成本的计算。通过使用层，可以过滤要进行射线投射计算的游戏对象，从而可以优化性能。如果__默认__层上没有很多复杂的网格，那么对碰撞进行射线投射测试不会产生很大的性能成本。但是，为了在进行碰撞时降低射线投射测试的复杂性，最好将游戏对象按层进行组织。通过更改 Collider Settings > Mesh Layer 属性，即可更改分配给特定__空间映射碰撞体__组件生成的所有表面游戏对象的层。

示例脚本：发生点击手势事件时的 SpatialSurface 射线投射

以下示例展示了在检测到点击手势事件时，如何在 SpatialSurface 层上对游戏对象进行射线投射，并使用 GestureRecognizer 启动此射线投射。

using UnityEngine;
using System.Collections; 

//这是 Gesture Recognizer 所必需的
using UnityEngine.XR.WSA.Input;


public class CustomLayerCollision : MonoBehaviour
{

    //用于捕捉手势事件

    private GestureRecognizer GR_recognizer;

    void Start()
    {
        //初始化 GestureRecognizer

        GR_recognizer = new GestureRecognizer();

        //启动手势捕捉

        GR_recognizer.StartCapturingGestures();

        //告知 GestureRecognizer 需要监听的事件

        GR_recognizer.SetRecognizableGestures(GestureSettings.Tap);

        //将 Tapped 事件订阅到 DetectCollisions 方法

        //这样可确保在 GestureRecognizer 检测到点击事件时立即调用此方法

        GR_recognizer.Tapped += DetectCollisions;

        //当用户发出点击手势时，Tapped 事件委托

        //会调用 DetectCollisions 方法来使用射线投射进行碰撞测试

        //请参阅 [GestureRecognizer API 参考](../ScriptReference/XR.WSA.Input.GestureRecognizer.html)了解更多详细信息
    }
    //发生点击事件时用于触发射线投射的方法
    public void DetectCollisions(TappedEventArgs tapEvent)
    {
        // 对空间表面或 UI 层上的所有游戏对象
        // 进行射线投射。

        int layerMask = 1 << LayerMask.NameToLayer("SpatialSurface");

        //使用用户头部的位置和前进方向构造 Ray
        Ray GazeRay = new Ray(tapEvent.headPose.position, tapEvent.headPose.forward);

        //使用 Gaze 中构造的 Ray 进行射线投射并将碰撞存储在阵列命中内

        RaycastHit[] hits = Physics.RaycastAll(GazeRay, float.MaxValue, layerMask);

        if (hits.Length > 0)
        {
            foreach (RaycastHit hit in hits)
            {
                Debug.Log(string.Format("Hit Object **\"**{0}**\"** at position **\"**{1}**\"**", hit.collider.gameObject, hit.point));
            }
        }
        else
        {
            Debug.Log("Nothing was hit.");
        }
    }
}

请参阅有关层和摄像机射线投射的文档以了解更多信息。

–

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

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