SpatialLocator 클래스

정의

네임스페이스:

Windows.Perception.Spatial

HoloLens 또는 기타 Mixed Reality 헤드셋과 같이 사용자의 주변 환경을 기준으로 추적되는 디바이스의 위치에 대한 액세스를 제공합니다.

public ref class SpatialLocator sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialLocator final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialLocator

Public NotInheritable Class SpatialLocator

상속

Object Platform::Object IInspectable SpatialLocator

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v2.0에서 도입되었습니다.)

설명

SpatialLocator 클래스는 사용자의 주변 환경을 기준으로 Windows에서 위치와 방향을 추적할 수 있는 디바이스를 나타냅니다. SpatialLocator instance 로케이터가 연결되고 고정된 참조 프레임의 소스입니다. HoloLens와 같은 Mixed Reality 헤드셋에서 이러한 참조 프레임은 홀로그램 렌더링 및 장치 주변 전 세계의 표면에 대한 추론에 사용할 수 있습니다.

속성

Locatability

디바이스 공간 위치 시스템의 현재 상태를 가져옵니다.

메서드

CreateAttachedFrameOfReferenceAtCurrentHeading()	현재 방향을 고정 제목으로 사용하여 이 SpatialLocator에 위치적으로 연결된 참조 프레임을 만듭니다.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	현재 방향을 고정 제목으로 사용하고 지정된 상대 위치에 의해 원점 오프셋을 사용하여 이 SpatialLocator에 위치적으로 연결된 참조 프레임을 만듭니다.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	현재 방향을 고정 제목으로 사용하고 원점 오프셋을 사용하여 지정된 상대 위치 및 방향으로 회전하여 이 SpatialLocator에 위치적으로 연결된 참조 프레임을 만듭니다.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)	현재 방향을 기준으로 제공된 제목을 라디안으로 사용하고 지정된 상대 위치 및 방향에 따라 원점 오프셋을 사용하여 이 SpatialLocator에 위치적으로 연결된 참조 프레임을 만듭니다.
CreateStationaryFrameOfReferenceAtCurrentLocation()	SpatialLocator의 현재 위치에 초기 원본을 사용하여 사용자 주변을 기준으로 고정된 상태로 유지되는 참조 프레임을 만듭니다.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)	SpatialLocator의 현재 위치에서 지정된 오프셋에 초기 원점이 있는 사용자 주변을 기준으로 고정된 상태로 유지되는 참조 프레임을 만듭니다.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)	SpatialLocator의 현재 위치에서 지정된 오프셋에 초기 원점이 있는 사용자 주변을 기준으로 고정된 상태로 유지되는 참조 프레임을 만든 다음 지정된 회전에서 회전합니다.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)	사용자 주변을 기준으로 고정된 상태로 유지되는 참조 프레임을 만듭니다. 초기 원점은 SpatialLocator의 현재 위치에서 지정된 상대 제목을 따라 라디안의 지정된 오프셋에 있는 다음 지정된 회전에서 회전됩니다.
GetDefault()	사용자 주변을 기준으로 현재 디바이스의 위치(예: HoloLens)를 추적하는 SpatialLocator instance 가져옵니다.
TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)	지정된 타임스탬프에서 디바이스의 위치를 나타내는 SpatialLocation을 반환합니다. 내의 좌표는 제공된 좌표계를 기준으로 표현됩니다. 지정된 타임스탬프의 해당 좌표계에 디바이스를 배치할 수 없는 경우 반환 값은 null이 됩니다. 예를 들어 디바이스가 추적을 분실한 경우 이 문제가 발생할 수 있습니다.

이벤트

LocatabilityChanged	공간 위치 시스템의 상태가 변경되면 발생합니다.
PositionalTrackingDeactivating	비활성으로 인해 디바이스의 공간 위치 시스템이 비활성화되는 경우에 발생합니다.

추가 정보

• 태그 따라 홀로그램 샘플