Freigeben über

SpatialStageFrameOfReference Klasse

  • Referenz

Definition

Namespace:
Windows.Perception.Spatial
Bearbeiten

Stellt eine räumliche Bühne dar, die vom Benutzer definiert wird, um den physischen Raum festzulegen, in dem er ein Mixed Reality Headset verwenden möchte.

public ref class SpatialStageFrameOfReference sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialStageFrameOfReference final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialStageFrameOfReference
Public NotInheritable Class SpatialStageFrameOfReference
Vererbung
Object Platform::Object IInspectable SpatialStageFrameOfReference
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Creators Update (eingeführt in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v4.0)

Hinweise

Eine Raumbühne besteht minimal aus einem Koordinatensystem auf Bodenebene, dessen Ursprung vom Benutzer ausgewählt wird, das den logischen Mittelpunkt des Bereichs darstellt, in dem er sein Mixed Reality Headset verwenden möchte. Dieses Koordinatensystem auf Bodenebene ermöglicht Apps die Darstellung von Benutzererfahrungen im Standmaßstab.

Optional kann der Benutzer auch eine Bewegungsgrenze definieren, die den offenen Bereich darstellt, in dem er während der Verwendung des Headsets laufen möchte. Diese Verschiebungsgrenze ermöglicht Apps die Darstellung von Benutzererfahrungen auf Raummaßstab.

Wenn der Benutzer keine räumliche Phase definiert hat, kann eine App die RequestNewStageAsync-Methode aufrufen, um den Benutzer durch die Systemoberfläche zu führen, die es ihnen ermöglicht, eine zu definieren.

Auf HoloLens kann eine App mithilfe der räumlichen Zuordnung auch Umgebungen im Stand- oder Raummaßstab erstellen. Mithilfe der räumlichen Zuordnung kann der Entwickler die Umgebung des Benutzers analysieren und die Positionen der Wände und Böden des Benutzers mithilfe des SpatialSurfaceObserver-Typs bestimmen, auch wenn der Benutzer keine Phase manuell definiert hat. Überprüfen Sie die SpatialSurfaceObserver.IsSupported-Eigenschaft , um zu ermitteln, ob das aktuelle Gerät räumliche Zuordnungen unterstützt.

Koordinatensysteme, die von der Bühne zurückgegeben werden, sind rechtshändig, mit +y nach oben, +x nach rechts und -z vorwärts.

Eigenschaften

CoordinateSystem

Ruft ein Koordinatensystem auf Bodenebene ab, das sich am vom Benutzer definierten Phasenursprung befindet.
Current

Ruft die aktuelle räumliche Phase ab, wenn eine vom Benutzer definiert wurde.
LookDirectionRange

Ruft den Umfang ab, in dem sich der Benutzer mit dem Headset umsehen kann.
MovementRange

Ruft den Umfang ab, in dem sich der Benutzer bewegen kann, während er sein Headset trägt.

Methoden

GetCoordinateSystemAtCurrentLocation(SpatialLocator)

Ruft ein Koordinatensystem auf Bodenebene an der aktuellen Position und Ausrichtung des Benutzers ab.
RequestNewStageAsync()

Zeigt die Systembenutzeroberfläche an, um den Benutzer bei der Definition einer neuen Phase zu unterstützen, um die aktuelle Phase zu ersetzen.
TryGetMovementBounds(SpatialCoordinateSystem)

Ruft die Begrenzungsvertices des offenen Bereichs ab, der vom Benutzer definiert wird, wohin er sich bewegen möchte, während er sein Headset verwendet.

Ereignisse

CurrentChanged

Tritt auf, wenn der Benutzer die aktuelle raumbezogene Phase ändert oder neu definiert.

Gilt für:

Weitere Informationen