Freigeben über


SpatialPointerPose Klasse

Definition

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

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.

Gilt für: