SpatialPointerPose Klasse

Definition

Namespace:

Windows.UI.Input.Spatial

Stellt die verfügbaren räumlichen Zeigerhaltungen dar, z. B. den Kopfblick des Benutzers, den Blick und die Zeigerhaltung jedes Bewegungscontrollers für die Verwendung bei Handgesten, Bewegungscontrollerdrücken und Sprachinteraktionen.

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

Vererbung

Object Platform::Object IInspectable SpatialPointerPose

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

SpatialPointerPose stellt den Satz von Zeigestrahlen bereit, die zu der durch die Timestamp-Eigenschaft dargestellten Zeit verfügbar sind.

Bei der Ausrichtung auf eine räumliche Interaktion, z. B. eine Handgeste, eine Bewegungssteuerung oder eine Sprachinteraktion, sollten Apps einen zeigenden Strahl auswählen, der aus dem SpatialPointerPose der Interaktion verfügbar ist, basierend auf der Art der SpatialInteractionSource der Interaktion:

• Wenn die Interaktionsquelle das Zeigen nicht unterstützt (IsPointingSupported ist false), sollte die App basierend auf dem Kopfblick des Benutzers als Zielziel verwendet werden, das über die Head-Eigenschaft verfügbar ist.
• Wenn die Interaktionsquelle das Pointing unterstützt (IsPointingSupported ist true), kann die App stattdessen basierend auf der Zeigerposition der Quelle als Ziel verwendet werden, die über die TryGetInteractionSourcePose-Methode verfügbar ist.

Die App sollte dann den ausgewählten zeigenden Strahl mit eigenen Hologrammen oder mit dem räumlichen Zuordnungsgitter überschneiden, um Cursor zu rendern und zu bestimmen, womit der Benutzer interagieren möchte.

Sobald eine Interaktion gestartet wurde, können relative Bewegungen der Hand oder des Controllers verwendet werden, um die Geste zu steuern, wie bei der Bearbeitungs- oder Navigationsgeste.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1703	15063	TryGetInteractionSourcePose
1903	18362	Augen
1903	18362	IsHeadCapturedBySystem

Eigenschaften

Eyes	Ruft den Blick des Benutzers für diesen Zeitstempel ab.
Head	Ruft den Kopfblick des Benutzers für diesen Zeitstempel ab.
IsHeadCapturedBySystem	Ruft ab, ob der Kopfblick des Benutzers derzeit von der Systembenutzeroberfläche erfasst wird (wodurch verhindert wird, dass blickgesteuerte Druckvorgänge an die ansicht übermittelt werden, die diesem SpatialPointerPose zugeordnet ist).
Timestamp	Ruft den Zeitstempel ab, wenn die zeigenden Strahlen bestimmt werden.

Methoden

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	Ruft die Kopfblick- und Bewegungscontrollerzeigerhaltungen für den angegebenen Zeitstempel ab.
TryGetInteractionSourcePose(SpatialInteractionSource)	Ruft die Zeigerpose für eine bestimmte räumliche Interaktionsquelle ab, z. B. einen Bewegungscontroller, zu einem bestimmten Zeitstempel.