SpatialStageFrameOfReference 클래스

정의

네임스페이스:

Windows.Perception.Spatial

Mixed Reality 헤드셋을 사용하려는 물리적 공간을 설정하기 위해 사용자가 정의한 공간 단계를 나타냅니다.

public ref class SpatialStageFrameOfReference sealed

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

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

Public NotInheritable Class SpatialStageFrameOfReference

상속

Object Platform::Object IInspectable SpatialStageFrameOfReference

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

설명

공간 단계는 사용자가 원점이 선택된 바닥 수준 좌표계로 최소로 구성되며, 이는 Mixed Reality 헤드셋을 사용하려는 영역의 논리적 중심을 나타냅니다. 이 바닥 수준 좌표계를 사용하면 앱이 스탠딩 스케일 환경을 표시할 수 있습니다.

필요에 따라 사용자는 헤드셋을 사용하는 동안 걷려는 열린 영역을 나타내는 이동 경계를 정의할 수도 있습니다. 이 이동 경계를 사용하면 앱이 회의실 규모 환경을 표시할 수 있습니다.

사용자가 공간 단계를 정의하지 않은 경우 앱은 RequestNewStageAsync 메서드를 호출하여 사용자를 정의할 수 있는 시스템 UI를 안내할 수 있습니다.

HoloLens에서 앱은 공간 매핑을 사용하여 스탠딩 스케일링 또는 룸 스케일 환경을 빌드할 수도 있습니다. 공간 매핑을 사용하면 사용자가 스테이지를 수동으로 정의하지 않은 경우에도 개발자가 SpatialSurfaceObserver 형식을 사용하여 사용자의 주변 환경을 분석하고 사용자의 벽과 바닥 위치를 확인할 수 있습니다. SpatialSurfaceObserver.IsSupported 속성을 검사하여 현재 디바이스가 공간 매핑을 지원하는지 확인합니다.

스테이지에서 반환된 좌표계는 오른손으로, +y 위쪽, 오른쪽에 +x, -z 앞으로 입니다.

속성

CoordinateSystem	사용자가 정의한 스테이지 원점의 바닥 수준 좌표계를 가져옵니다.
Current	사용자가 정의한 경우 현재 공간 단계를 가져옵니다.
LookDirectionRange	사용자가 헤드셋을 사용하여 주위를 둘러볼 수 있는 정도를 가져옵니다.
MovementRange	헤드셋을 착용하는 동안 사용자가 이동할 수 있는 범위를 가져옵니다.

메서드

GetCoordinateSystemAtCurrentLocation(SpatialLocator)	사용자의 현재 위치 및 방향에서 바닥 수준 좌표계를 가져옵니다.
RequestNewStageAsync()	현재 스테이지를 대체할 새 스테이지를 정의하는 사용자를 안내하는 시스템 UI를 표시합니다.
TryGetMovementBounds(SpatialCoordinateSystem)	헤드셋을 사용하는 동안 이동하려는 사용자가 정의한 열린 영역의 경계 꼭짓점을 가져옵니다.

이벤트

CurrentChanged

사용자가 현재 공간 단계를 변경하거나 다시 정의할 때 발생합니다.

추가 정보

• 홀로그램 공간 단계 샘플