SpatialPointerPose 클래스

정의

네임스페이스:

Windows.UI.Input.Spatial

손 제스처, 모션 컨트롤러 누르기 및 음성 상호 작용을 대상으로 하는 데 사용할 수 있는 사용자의 머리 응시, 시선 응시 및 각 모션 컨트롤러의 포인터 포즈와 같은 사용 가능한 공간 포인터 포즈를 나타냅니다.

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

Public NotInheritable Class SpatialPointerPose

상속

Object Platform::Object IInspectable SpatialPointerPose

특성

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

설명

SpatialPointerPose는 타임스탬프 속성이 나타내는 시간에 사용할 수 있는 포인팅 광선 집합을 제공합니다.

손 제스처, 모션 컨트롤러 누르기 또는 음성 상호 작용과 같은 공간 상호 작용을 대상으로 하는 경우 앱은 상호 작용의 SpatialInteractionSource 특성에 따라 상호 작용의 SpatialPointerPose에서 사용할 수 있는 포인팅 광선을 선택해야 합니다.

• 상호 작용 원본이 포인팅을 지원하지 않는 경우(IsPointingSupported 가 false임) 앱은 Head 속성을 통해 사용할 수 있는 사용자의 헤드 응시를 기준으로 대상을 지정해야 합니다.
• 상호 작용 원본이 포인팅을 지원하는 경우(IsPointingSupported 가 true임) 앱은 대신 TryGetInteractionSourcePose 메서드를 통해 사용할 수 있는 원본의 포인터 포즈를 기반으로 대상을 지정할 수 있습니다.

그런 다음 앱은 선택한 포인팅 광선을 자체 홀로그램 또는 공간 매핑 메시와 교차하여 커서를 렌더링하고 사용자가 상호 작용할 대상을 결정해야 합니다.

조작이 시작되면 조작 또는 탐색 제스처와 마찬가지로 손이나 컨트롤러의 상대 동작을 사용하여 제스처를 제어할 수 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	TryGetInteractionSourcePose
1903	18362	눈
1903	18362	IsHeadCapturedBySystem

속성

Eyes	이 타임스탬프에 대한 사용자의 시선 응시를 가져옵니다.
Head	이 타임스탬프에 대한 사용자의 머리 응시를 가져옵니다.
IsHeadCapturedBySystem	현재 시스템 UI에서 사용자의 머리 응시를 캡처하는지 여부를 가져옵니다(응시 기반 누름이 이 SpatialPointerPose와 연결된 보기로 전달되지 않도록 방지).
Timestamp	포인팅 광선이 결정되는 경우 타임스탬프를 가져옵니다.

메서드

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	지정된 타임스탬프에 대한 헤드 응시 및 모션 컨트롤러 포인터 포즈를 가져옵니다.
TryGetInteractionSourcePose(SpatialInteractionSource)	지정된 타임스탬프에서 동작 컨트롤러와 같은 특정 공간 상호 작용 원본에 대한 포인터 포즈를 가져옵니다.