SpatialAnchor Klasse

Definition

Namespace:

Windows.Perception.Spatial

Stellt ein Koordinatensystem dar, das stark an einem Punkt in der Umgebung des Benutzers verankert ist.

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

Public NotInheritable Class SpatialAnchor

Vererbung

Object Platform::Object IInspectable SpatialAnchor

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

Sie können einen SpatialAnchor an jeder Position und Ausrichtung innerhalb des SpatialCoordinateSystem Ihrer Wahl erstellen. Das Gerät muss in der Lage sein, dieses Koordinatensystem im Moment zu lokalisieren, und das System darf die Grenze der Raumanker nicht erreicht haben.

Nach der Definition passt sich das Koordinatensystem eines SpatialAnchor kontinuierlich an, um die genaue Position und Ausrichtung der ursprünglichen Position beizubehalten. Anschließend können Sie diesen SpatialAnchor verwenden, um Hologramme zu rendern, die in der Umgebung des Benutzers an genau dieser Stelle behoben angezeigt werden.

Die Auswirkungen der Anpassungen, die den Anker an Ort und Stelle halten, werden vergrößert, wenn die Entfernung vom Anker zunimmt. Sie sollten das Rendern von Inhalten im Verhältnis zu einem Anker vermeiden, der mehr als 3 Meter vom Ursprung dieses Ankers entfernt ist.

Sie können einen SpatialAnchor mithilfe der SpatialAnchorStore-Klasse beibehalten und dann in einer zukünftigen App-Sitzung wieder abrufen.

Die CoordinateSystem-Eigenschaft ruft ein Koordinatensystem ab, mit dem Sie Inhalte relativ zum Anker platzieren können, wobei die Beschleunigung angewendet wird, wenn das Gerät die genaue Position des Ankers anpasst.

Verwenden Sie die RawCoordinateSystem-Eigenschaft und das entsprechende RawCoordinateSystemAdjusted-Ereignis , um diese Anpassungen selbst zu verwalten.

Das Koordinatensystem ist rechtshändig, mit +y nach oben, +x nach rechts und -z vorwärts.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	RemovedByUser

Eigenschaften

CoordinateSystem	Ruft das Koordinatensystem des Ankers ab, wobei Anpassungen für die Beschleunigung angewendet werden.
RawCoordinateSystem	Ruft das Koordinatensystem des Ankers ab, ohne dass eine Beschleunigung angewendet wird.
RemovedByUser	Ruft einen Wert ab, der angibt, ob der persistente Anker vom Benutzer entfernt wurde.

Methoden

TryCreateRelativeTo(SpatialCoordinateSystem)	Erstellt einen Anker am Ursprung des angegebenen Koordinatensystems.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	Erstellt einen Anker an einer bestimmten Position innerhalb des angegebenen Koordinatensystems.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	Erstellt einen Anker an einer bestimmten Position und Ausrichtung innerhalb des angegebenen Koordinatensystems. Dies kann NULL zurückgeben, wenn das System sein Limit für räumliche Anker erreicht hat. Es kann auch NULL zurückgeben, wenn das angegebene Koordinatensystem diesen Frame nicht finden kann.

Ereignisse

RawCoordinateSystemAdjusted

Tritt auf, wenn das Gerät die genaue Position des Ankers anpasst, wodurch das RawCoordinateSystem aktualisiert wird.