다음을 통해 공유


SpatialPointerPose 클래스

정의

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

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
특성

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)

지정된 타임스탬프에서 동작 컨트롤러와 같은 특정 공간 상호 작용 원본에 대한 포인터 포즈를 가져옵니다.

적용 대상