SpatialAnchor 클래스

참조

정의

네임스페이스:: Windows.Perception.Spatial

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

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

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	사용자가 지속형 앵커를 제거했는지 여부를 나타내는 값을 가져옵니다.