SpatialInteractionManager Klasse

  • Referenz

Definition

Namespace:
Windows.UI.Input.Spatial
Bearbeiten

Bietet Zugriff auf Benutzereingaben von Händen, Motion Controllern und Systemstimmebefehlen.

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
Vererbung
Object Platform::Object IInspectable SpatialInteractionManager
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Hinweise

Räumliche Gesten sind eine wichtige Form der Eingabe für HoloLens. Durch das Weiterleiten der Interaktionen vom SpatialInteractionManager an das SpatialGestureRecognizer eines Hologramms können Apps Tap-, Hold-, Manipulations- und Navigationsereignisse gleichmäßig über Hand-, Sprach- und Controllerinteraktionen hinweg erkennen.

Hinweis

Räumliche Interaktionen werden von Gamepad-, Tastatur- oder Mauseingabegeräten nicht erkannt.

Interaktionen sind meist undurchsichtig, wobei ein Ereignis nur am Anfang ausgelöst wird, sodass die Gestenerkennung, an die Sie sie weiterleiten, die Interaktion vollständig erfassen kann. Apps können stattdessen die Quellereignisse auf niedriger Ebene verwenden oder mit GetDetectedSourcesAtTimestamp abfragen, um die von einer bestimmten Hand oder einem Controller angezeigten Presss, Updates und Releases manuell zu verarbeiten.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1903 18362 IsSourceKindSupported

Methoden

GetDetectedSourcesAtTimestamp(PerceptionTimestamp)

Ruft den Status aller Interaktionsquellen ab, die für den angegebenen Zeitstempel erkannt wurden.
GetForCurrentView()

Ruft den SpatialInteractionManager ab, der dem aktuellen CoreWindow zugeordnet ist.
IsSourceKindSupported(SpatialInteractionSourceKind)

Ruft ab, ob die angegebene Interaktionsquelle auf diesem Gerät unterstützt wird.

Ereignisse

InteractionDetected

Tritt auf, wenn eine neue Interaktion für das Routing an einen SpatialGestureRecognizer verfügbar ist.
SourceDetected

Tritt auf, wenn eine neue Hand-, Bewegungscontroller- oder Sprachquelle erkannt wurde.
SourceLost

Tritt auf, wenn keine Hand-, Bewegungscontroller- oder Sprachquelle mehr verfügbar ist.
SourcePressed

Tritt auf, wenn eine Hand-, Bewegungscontroller- oder Sprachquelle in einen gedrückten Zustand versetzt wurde.
SourceReleased

Tritt auf, wenn eine Hand-, Bewegungscontroller- oder Sprachquelle den gedrückten Zustand verlassen hat.
SourceUpdated

Tritt auf, wenn für eine Hand-, Bewegungscontroller- oder Sprachquelle eine Änderung des SpatialInteractionSourceState-Steuerelements aufgetreten ist.

Gilt für:

Weitere Informationen