SpatialAnchor 클래스

정의

네임스페이스:

Windows.Perception.Spatial

사용자 주변의 지점에 강력하게 고정되는 좌표계를 나타냅니다.

public ref class SpatialAnchor 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 SpatialAnchor 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 SpatialAnchor

Public NotInheritable Class SpatialAnchor

상속

Object Platform::Object IInspectable SpatialAnchor

특성

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에서 도입되었습니다.)

설명

선택한 SpatialCoordinateSystem 내의 모든 위치 및 방향에서 SpatialAnchor를 만들 수 있습니다. 디바이스는 현재 해당 좌표계를 찾을 수 있어야 하며 시스템이 공간 앵커 제한에 도달하지 않아야 합니다.

정의되면 SpatialAnchor의 좌표계는 초기 위치의 정확한 위치와 방향을 유지하기 위해 지속적으로 조정됩니다. 그런 다음 이 SpatialAnchor를 사용하여 정확한 위치에서 사용자 주변에 고정된 홀로그램을 렌더링할 수 있습니다.

앵커와의 거리가 증가함에 따라 앵커를 제자리에 유지하는 조정의 효과가 확대됩니다. 해당 앵커의 원점에서 3미터 이상 떨어진 앵커를 기준으로 콘텐츠를 렌더링하지 않아야 합니다.

SpatialAnchorStore 클래스를 사용하여 SpatialAnchor를 유지한 다음, 이후 앱 세션에서 다시 가져올 수 있습니다.

CoordinateSystem 속성은 장치가 앵커의 정확한 위치를 조정할 때 감속이 적용된 상태에서 앵커를 기준으로 콘텐츠를 배치할 수 있는 좌표계를 가져옵니다.

RawCoordinateSystem 속성 및 해당 RawCoordinateSystemAdjusted 이벤트를 사용하여 이러한 조정을 직접 관리합니다.

좌표계는 오른손잡이이며 , +y 위쪽, 오른쪽에는 +x, -z는 앞으로 입니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	RemovedByUser

속성

CoordinateSystem	감속 조정이 적용된 앵커의 좌표계를 가져옵니다.
RawCoordinateSystem	감속/가속을 적용하지 않고 앵커의 좌표계를 가져옵니다.
RemovedByUser	사용자가 지속형 앵커를 제거했는지 여부를 나타내는 값을 가져옵니다.

메서드

TryCreateRelativeTo(SpatialCoordinateSystem)	지정된 좌표계의 원점에서 앵커를 만듭니다.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	지정된 좌표계 내의 특정 위치에 앵커를 만듭니다.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	지정된 좌표계 내의 특정 위치와 방향에 앵커를 만듭니다. 시스템이 공간 앵커에 대한 제한에 도달하면 null을 반환할 수 있습니다. 지정된 좌표계를 이 프레임에 배치할 수 없는 경우에도 null을 반환할 수 있습니다.

이벤트

RawCoordinateSystemAdjusted

디바이스가 RawCoordinateSystem을 업데이트하는 앵커의 정확한 위치를 조정할 때 발생합니다.