XrSpatialAnchor QML Type

Verfolgt einen bestimmten Ort oder ein bestimmtes Objekt im realen Raum. Mehr...

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• Classification : enumeration
• classification : enumeration
• classificationString : string
• extent2D : vector2d
• extent3D : vector3d
• has2DBounds : bool
• has3DBounds : bool
• identifier : string
• offset2D : vector2d
• offset3D : vector3d
• position : vector3d
• rotation : quaternion

Ausführliche Beschreibung

Dieser Typ stellt einen räumlichen Anker dar, der einen bestimmten Ort oder ein bestimmtes Objekt im realen Raum verfolgt. Er liefert Informationen über die Position, Rotation, Klassifizierung und Begrenzungen des Ankers.

Der Zugriff auf räumliche Anker erfolgt über eine „ XrSpatialAnchorListModel “.

Informationen zur Verwendung dieses Typs finden Sie im Beispiel „Qt Quick 3D – XR Spatial Anchors “.

Plattformhinweise

Meta Quest-Geräte

Diese API nutzt die Meta Quest Scene- und Spatial Anchor-APIs. Sie müssen die folgenden Berechtigungen zur ` AndroidManifest.xml `-Datei Ihrer App hinzufügen:

<uses-permission android:name="com.oculus.permission.USE_ANCHOR_API"/>
<uses-permission android:name="com.oculus.permission.USE_SCENE"/>

Dokumentation zu den Eigenschaften

Classification : enumeration [read-only]

Die Klassifizierung des räumlichen Ankers.

Die Enumeration „Classification“ stellt eine Reihe vordefinierter Kategorietypen bereit, die den Zweck oder Kontext eines räumlichen Ankers beschreiben.

Die folgende Tabelle zeigt die Zuordnung zwischen dem Klassifizierungstyp in „ Qt Quick 3D Xr“, „OpenXR“ und „VisionOS“. Wenn der Klassifizierungstyp des Systems nicht unter die definierten Typen fällt, wird der Typ auf „ Other “ gesetzt, und der Systemtyp wird über die Eigenschaft „ classificationString “ bereitgestellt.

classification : enumeration [read-only]

Der Klassifizierungstyp des räumlichen Ankers.

Diese Eigenschaft gibt den „ classification type “ für diesen Anker zurück (z. B. „Table “ oder „ Floor “), der den Zweck oder Kontext des Ankers beschreibt.

Siehe auch classificationString.

classificationString : string [read-only]

Der Klassifizierungstyp des räumlichen Ankers als Zeichenkette.

Diese Eigenschaft gibt den Klassifizierungstyp als Zeichenfolge zurück, sofern einer vorhanden ist. Befindet sich der Klassifizierungstyp nicht in der durch die Enums „ Classification “ definierten Typenmenge, wird die Bezeichnung auf „ Other “ gesetzt, und diese Eigenschaft kann verwendet werden, um auf den vom System gemeldeten Typ zuzugreifen.

Siehe auch „ classification “.

extent2D : vector2d [read-only]

Die 2D-Ausdehnung des räumlichen Ankers.

Diese Eigenschaft enthält die Größe des räumlichen Ankers in zwei Dimensionen (Breite und Höhe) innerhalb der X/Z-Ebene. Sie ist gültig, wenn „ has2DBounds “ auf „ true “ gesetzt ist.

Siehe auch „ has2DBounds “ und „ offset2D “.

extent3D : vector3d [read-only]

Die 3D-Ausdehnung des räumlichen Ankers.

Diese Eigenschaft gibt das Volumen des räumlichen Ankers in drei Dimensionen (Breite, Höhe und Tiefe) an. Sie ist gültig, wenn „ has3DBounds “ auf „ true “ gesetzt ist.

Siehe auch „ offset3D “ und „ has3DBounds “.

has2DBounds : bool [read-only]

Gibt an, ob der räumliche Anker 2D-Grenzen hat.

Diese Eigenschaft hat den Wert „ true “, wenn der räumliche Anker 2D-Grenzen hat, die durch „ offset2D “ und „ extent2D “ beschrieben werden, was darauf hinweist, dass er eine ebene Fläche darstellt (z. B. einen Boden oder eine Wand).

Andernfalls gibt sie „false“ zurück.

Siehe auch offset2D, extent2D und has3DBounds.

has3DBounds : bool [read-only]

Gibt an, ob der räumliche Anker 3D-Grenzen hat.

Diese Eigenschaft gibt „ true “ zurück, wenn der räumliche Anker 3D-Grenzen hat, was darauf hinweist, dass er ein Volumen darstellt (z. B. einen Tisch oder einen Schrank). Die Grenzen werden durch „ offset3D “ und „ extent3D “ beschrieben.

Andernfalls gibt sie „ false “ zurück.

Siehe auch offset3D, extent3D und has2DBounds.

identifier : string [read-only]

Eine eindeutige Kennung für diesen räumlichen Anker.

Diese Eigenschaft enthält eine eindeutige Kennung, die dem räumlichen Anker zugeordnet ist. Es handelt sich um dieselbe Kennung, auf die in einem „ XrSpatialAnchorListModel “ verwiesen wird.

offset2D : vector2d [read-only]

Der 2D-Versatz des räumlichen Ankers.

Diese Eigenschaft enthält den Versatz der Begrenzungslinien des Ankers innerhalb der X/Z-Ebene. Sie ist gültig, wenn „ has2DBounds “ auf „ true “ gesetzt ist.

Siehe auch „ has2DBounds “ und „ extent2D “.

offset3D : vector3d [read-only]

Der 3D-Versatz des räumlichen Ankers.

Diese Eigenschaft gibt den 3D-Versatz der Begrenzungslinien des Ankers (in Metern) vom Ankerpunkt „ position “ an.

Siehe auch „offset3D“ und „ has3DBounds “.

position : vector3d [read-only]

Die Position des räumlichen Ankers.

Diese Eigenschaft gibt die 3D-Position (in Metern) des Ursprungs des räumlichen Ankers innerhalb des Koordinatensystems der Sitzung zurück.

rotation : quaternion [read-only]

Die Ausrichtung des räumlichen Ankers.

Diese Eigenschaft gibt die Drehung des räumlichen Ankers (als Quaternion) an.