SpatialLocator Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 SpatialLocatorPublic NotInheritable Class SpatialLocator- Vererbung
- 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
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. |