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 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 는 속성이 나타내는 시간에 사용할 수 있는 포인팅 광선 집합을 Timestamp 제공합니다.

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

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

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

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

버전 기록

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

속성

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

메서드

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