SpatialInteractionManager 클래스

정의

네임스페이스:

Windows.UI.Input.Spatial

손, 모션 컨트롤러 및 시스템 음성 명령의 사용자 입력에 대한 액세스를 제공합니다.

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

Public NotInheritable Class SpatialInteractionManager

상속

Object Platform::Object IInspectable SpatialInteractionManager

특성

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

설명

공간 제스처는 HoloLens의 핵심 입력 형식입니다. SpatialInteractionManager의 상호 작용을 홀로그램의 SpatialGestureRecognizer로 라우팅하여 앱은 손, 음성 및 컨트롤러 상호 작용을 통해 탭, 홀드, 조작 및 탐색 이벤트를 균일하게 검색할 수 있습니다.

참고

공간 상호 작용은 게임 패드, 키보드 또는 마우스 입력 장치에서 검색되지 않습니다.

상호 작용은 대부분 불투명하며, 이벤트는 처음에만 트리거되므로 이를 라우팅하는 제스처 인식기가 상호 작용 전체를 캡처할 수 있습니다. 대신 앱은 GetDetectedSourcesAtTimestamp를 사용하여 하위 수준 원본 이벤트 또는 설문 조사를 사용하여 지정된 손 또는 컨트롤러가 노출하는 프레스, 업데이트 및 릴리스를 수동으로 처리하도록 선택할 수 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1903	18362	IsSourceKindSupported

메서드

GetDetectedSourcesAtTimestamp(PerceptionTimestamp)	지정된 타임스탬프에 대해 검색된 모든 상호 작용 원본의 상태를 가져옵니다.
GetForCurrentView()	현재 CoreWindow와 연결된 SpatialInteractionManager를 가져옵니다.
IsSourceKindSupported(SpatialInteractionSourceKind)	지정된 상호 작용 원본이 이 디바이스에서 지원되는지 여부를 가져옵니다.

이벤트

InteractionDetected	SpatialGestureRecognizer로 라우팅하는 데 새 상호 작용을 사용할 수 있을 때 발생합니다.
SourceDetected	새 손, 모션 컨트롤러 또는 음성 원본이 검색되었을 때 발생합니다.
SourceLost	손, 모션 컨트롤러 또는 음성 원본을 더 이상 사용할 수 없는 경우에 발생합니다.
SourcePressed	손, 동작 컨트롤러 또는 음성 원본이 누름 상태로 들어갔을 때 발생합니다.
SourceReleased	손, 동작 컨트롤러 또는 음성 원본이 누름 상태를 종료했을 때 발생합니다.
SourceUpdated	손, 동작 컨트롤러 또는 음성 원본이 SpatialInteractionSourceState를 변경한 경우에 발생합니다.

추가 정보

• 공간 상호 작용 원본 샘플