SpatialLocator Klasse

Definition

Namespace:

Windows.Perception.Spatial

Ermöglicht den Zugriff auf den Standort eines Geräts, das relativ zur Umgebung des Benutzers nachverfolgt wird, z. B. eine HoloLens oder ein anderes Mixed Reality Headsets.

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

Public NotInheritable Class SpatialLocator

Vererbung

Object Platform::Object IInspectable SpatialLocator

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

Die SpatialLocator-Klasse stellt ein Gerät dar, dessen Position und Ausrichtung von Windows relativ zur Umgebung des Benutzers nachverfolgt werden können. Ein SpatialLocator-instance ist die Quelle für durch Locator angefügte und stationäre Referenzrahmen. Auf einem Mixed Reality Headsets wie HoloLens können diese Referenzrahmen für holografisches Rendering und zum Überlegen von Oberflächen in der Welt um das Gerät verwendet werden.

Eigenschaften

Locatability

Ruft den aktuellen Zustand des räumlichen Standortsystems des Geräts ab.

Methoden

CreateAttachedFrameOfReferenceAtCurrentHeading()	Erstellt einen Bezugsrahmen, der positionell an diesen SpatialLocator angefügt ist und die aktuelle Ausrichtung als feste Überschrift aufweist.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	Erstellt einen Bezugsrahmen, der positional an diesen SpatialLocator angefügt ist, wobei die aktuelle Ausrichtung als feste Überschrift und sein Ursprungsversatz durch die angegebene relative Position festgelegt ist.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	Erstellt einen Bezugsrahmen, der positional an diesen SpatialLocator angefügt ist, wobei die aktuelle Ausrichtung als feste Überschrift und deren Ursprungsoffset um die angegebene relative Position und Ausrichtung gedreht wird.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)	Erstellt einen Bezugsrahmen, der positional an diesen SpatialLocator mit der angegebenen Überschrift in Bogenmaßen relativ zur aktuellen Ausrichtung und mit seinem Ursprungsoffset durch die angegebene relative Position und Ausrichtung angefügt ist.
CreateStationaryFrameOfReferenceAtCurrentLocation()	Erstellt einen Bezugsrahmen, der relativ zur Umgebung des Benutzers stationär bleibt, wobei der ursprüngliche Ursprung am aktuellen Standort des SpatialLocators liegt.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)	Erstellt einen Bezugsrahmen, der relativ zur Umgebung des Benutzers stationär bleibt, wobei der ursprüngliche Ursprung am angegebenen Offset vom aktuellen Standort des SpatialLocators liegt.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)	Erstellt einen Bezugsrahmen, der relativ zur Umgebung des Benutzers stationär bleibt, wobei der ursprüngliche Ursprung am angegebenen Offset vom aktuellen Standort des SpatialLocators liegt und dann mit der angegebenen Drehung gedreht wird.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)	Erstellt einen Bezugsrahmen, der relativ zur Umgebung des Benutzers stationär bleibt, wobei sein ursprünglicher Ursprung am angegebenen Offset von der aktuellen Position des SpatialLocator entlang der angegebenen relativen Überschrift in Bogenmaßen bleibt und dann mit der angegebenen Drehung gedreht wird.
GetDefault()	Ruft die SpatialLocator-instance ab, die den Standort des aktuellen Geräts, z. B. eine HoloLens, relativ zur Umgebung des Benutzers nachverfolgt.
TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)	Gibt einen SpatialLocation-Wert zurück, der den Standort des Geräts zum angegebenen Zeitstempel darstellt. Die Darin enthaltenen Koordinaten werden relativ zum angegebenen Koordinatensystem ausgedrückt. Wenn das Gerät nicht zum angegebenen Zeitstempel in diesem Koordinatensystem gefunden werden kann, ist der Rückgabewert NULL. Dies kann beispielsweise passieren, wenn das Gerät die Nachverfolgung verloren hat.

Ereignisse

LocatabilityChanged	Tritt auf, wenn sich der Zustand des räumlichen Standortsystems ändert.
PositionalTrackingDeactivating	Tritt auf, wenn das räumliche Standortsystem des Geräts aufgrund von Inaktivität deaktiviert wird.

Weitere Informationen

• Hologrammbeispiel mit Tag-Along