공간 매핑 콜라이더

공간 매핑 콜라이더(Spatial Mapping Collider) 컴포넌트는 홀로그래픽 콘텐츠와 실제 물리 표면과의 인터랙션을 구현합니다. 또한 씬에서 표면 게임 오브젝트 콜라이더의 생성, 업데이트 및 삭제를 처리합니다.

이 컴포넌트는 주기적으로 물리 월드의 표면 변화를 시스템에 쿼리합니다. 시스템이 표면 변화를 보고하면 공간 매핑 콜라이더(Spatial Mapping Collider) 컴포넌트는 각각의 보고된 표면이 Unity에서 베이크될 시간에 대해 우선 순위를 지정합니다. 표면이 시스템에서 베이크되면 Unity는 메시 필터(Mesh Filter) 및 메시 콜라이더(Mesh Collider) 컴포넌트가 포함된 새 게임 오브젝트를 생성합니다. 메시 콜라이더가 포함된 표면을 이용하면 Unity의 여타 다른 메시와 마찬가지로 레이캐스트와 충돌하도록 만들 수 있습니다. 자세한 내용은 [카메라 레이캐스트(Camera Raycast) 문서를 참조하십시오.

참고: 이 컴포넌트는 메시 렌더러가 아니라 표면 게임 오브젝트의 메시 콜라이더 컴포넌트만 업데이트합니다.

참고: 공간 매핑 콜라이더(Spatial Mapping Colliders) 는 공간 매핑 메시 렌더러(Spatial Mapping Mesh Renderer) 보다 업데이트 지연 시간이 짧습니다. 즉, 공간 매핑 콜라이더가 공간 매핑 메시 렌더러보다 빠르게 업데이트됩니다.

콜라이더 설정

일반 설정

아래 설정은 공간 매핑 렌더러 및 공간 매핑 콜라이더 컴포넌트 모두에 공통적으로 적용됩니다.

디테일 수준(LOD)

아래 이미지에서 설명된 것처럼 두 Spatial Mapping 컴포넌트 모두 각 컴포넌트의 생성 공간 메시에 대해 세 가지 디테일 수준(LOD)(낮음, 중간, 높음) 중 하나를 지정할 수 있습니다.

가능한 경우 Spatial Mapping Colliders 에 대한 디테일 수준(LOD) 설정을 Low로 설정하십시오. 이렇게 하면 충돌 교차를 계산할 때 성능이 향상되고 전력 소모가 감소합니다. 하지만 Level of Detail 을 Low 로 설정하면 애플리케이션의 시각 효과가 저하될 수 있습니다.

공간 매핑 콜라이더 사용

표면 게임 오브젝트

씬의 게임 오브젝트에 공간 매핑 콜라이더 컴포넌트를 추가하면 런타임 동안 별도의 표면 게임 오브젝트 세트가 생성됩니다. 이 표면 게임 오브젝트는 표면 부모 게임 오브젝트에 연결된 씬에 나타납니다.

공간 매핑 콜라이더 에서 생성한 표면 게임 오브젝트에는 다음 컴포넌트가 포함되어 있습니다.

• 메시 필터(Mesh Filter)

• 월드 앵커(World Anchor)

• 메시 콜라이더(Mesh Collider)

씬에 여러 개의 공간 매핑 콜라이더 컴포넌트를 추가하는 경우 각 컴포넌트는 별도의 표면 게임 오브젝트 세트를 생성합니다. 예를 들어, 씬에 있는 두 개의 게임 오브젝트에 공간 매핑 콜라이더 가 포함되어 있다면 씬에 두 세트의 표면 게임 오브젝트가 포함됩니다. 각 세트는 런타임 시점에 각 컴포넌트에 의해 생성됩니다. 최적화를 위해 이 점을 잘 기억해두는 것이 좋습니다. 참고: 공간 매핑 시스템에서 처음 생성될 때 모든 표면 게임 오브젝트 는 기본 레이어 에 할당됩니다. 하지만 레이캐스트 계산은 성능 소모가 크기 때문에 게임 오브젝트를 특정 레이어에 할당하는 것이 더 좋습니다. 레이어를 사용하면 레이캐스트 계산을 수행할 게임 오브젝트를 필터링할 수 있습니다. 기본(Default) 레이어에 복잡한 메시가 많지 않은 경우에는 충돌을 위한 레이캐스트 테스트를 수행해도 성능 소모가 적습니다. 하지만 충돌 수행 시 레이캐스트 테스트의 복잡성을 줄이려면 게임 오브젝트를 레이어에 할당하는 것이 좋습니다. 특정 공간 매핑 콜라이더 컴포넌트에서 생성한 모든 표면 게임 오브젝트에 할당된 레이어를 바꾸려면 콜라이더 설정(Collider Settings) > 메시 레이어(Mesh Layer) 프로퍼티를 변경하십시오.

예제 스크립트: 탭 제스처 이벤트에 대한 SpatialSurface 레이캐스트

다음 예제는 표면 공간(SpatialSurface) 레이어의 게임 오브젝트에 대해 레이캐스트를 수행하고 GestureRecognizer를 사용하여 탭 제스처 이벤트 감지 시 이 레이캐스트를 시작하는 방법을 보여줍니다.

using UnityEngine;
using System.Collections; 

//Required for Gesture Recognizer
using UnityEngine.XR.WSA.Input;


public class CustomLayerCollision : MonoBehaviour
{

    //use this to capture gesture events

    private GestureRecognizer GR_recognizer;

    void Start()
    {
        //Initialise the GestureRecognizer

        GR_recognizer = new GestureRecognizer();

        //Initiate gesture capture

        GR_recognizer.StartCapturingGestures();

        //Tell the GestureRecognizer which events to listen for

        GR_recognizer.SetRecognizableGestures(GestureSettings.Tap);

        //Subscribe the Tapped event to the DetectCollisions method

        //This makes this method be called any time the GestureRecognizer detects a tap event

        GR_recognizer.Tapped += DetectCollisions;

        //When the user initiates a tap gesture, the DetectCollisions   

        //method is called by the Tapped event delegate to do a collision test using Raycasting

        //See [GestureRecognizer API reference](../ScriptReference/XR.WSA.Input.GestureRecognizer.html) for more details
    }
    //Method to fire a raycast on a Tap event
    public void DetectCollisions(TappedEventArgs tapEvent)
    {
        // Raycast against all GameObjects that are on either the
        // spatial Surface or UI layers.

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

        //construct a Ray using the position and forward direction of the User’s head
        Ray GazeRay = new Ray(tapEvent.headPose.position, tapEvent.headPose.forward);

        //Raycast using constructed Ray from Gaze and store collisions in array hits

        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 편집 리뷰를 거쳐 페이지 게시됨

• Unity 2017.3에서 HoloLens 공간 매핑에 대한 설명이 업데이트됨