SpatialHoldStartedEventArgs.TryGetPointerPose(SpatialCoordinateSystem) 메서드

정의

네임스페이스:

Windows.UI.Input.Spatial

이 제스처를 대상으로 하는 데 사용할 수 있는 포인터 포즈(예: 사용자의 머리 응시 및 각 모션 컨트롤러의 포인팅 광선)를 가져옵니다.

public:
 virtual SpatialPointerPose ^ TryGetPointerPose(SpatialCoordinateSystem ^ coordinateSystem) = TryGetPointerPose;

SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem const& coordinateSystem);

public SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem coordinateSystem);

function tryGetPointerPose(coordinateSystem)

Public Function TryGetPointerPose (coordinateSystem As SpatialCoordinateSystem) As SpatialPointerPose

매개 변수

coordinateSystem

SpatialCoordinateSystem

포인터를 표현할 좌표계입니다.

반환

SpatialPointerPose

포인터가 포즈를 취합니다.

설명

이 포즈는 활성 제스처를 시작하기 위해 이 인식기로 라우팅된 초기 SpatialInteraction의 타임스탬프에서 가져옵니다.

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

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

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

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

지정된 좌표계를 현재 배치할 수 없는 경우 이 메서드는 null을 반환합니다.