XrSpatialAnchorListModel QML Type
Stellt ein Modell bereit, das räumliche Anker enthält. Mehr...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.
Eigenschaften
- classificationFilter : enumeration
- classificationStringFilter : list<string>
- filterMode : enumeration
- identifierFilter : list<string>
Methoden
- void requestSceneCapture()
Ausführliche Beschreibung
Dieser Typ stellt eine Liste von räumlichen Ankerpunkten bereit, bei denen es sich um Punkte in der realen Welt handelt, die verfolgt und mit virtuellen Inhalten verknüpft werden können.
Die Liste enthält Elemente, die über eine Eigenschaft „ anchor “ vom Typ „ XrSpatialAnchor “ verfügen.
Sie können sie wie folgt verwenden:
Repeater3D {
model: XrSpatialAnchorListModel {
}
delegate: Node {
required property XrSpatialAnchor anchor
position: anchor.position
rotation: anchor.rotation
// Further use of anchor properties...
}
}Eigenschaftsdokumentation
classificationFilter : enumeration
Enthält das Klassifizierungsflag, das zum Filtern von räumlichen Ankerpunkten verwendet wird.
Der Filter „ClassificationFlag“ wird als Kombination von Flags dargestellt:
| Konstante | Wert |
|---|---|
XrSpatialAnchorListModel.Wall | |
XrSpatialAnchorListModel.Ceiling | |
XrSpatialAnchorListModel.Floor | |
XrSpatialAnchorListModel.Table | |
XrSpatialAnchorListModel.Seat | |
XrSpatialAnchorListModel.Window | |
XrSpatialAnchorListModel.Door | |
XrSpatialAnchorListModel.Other |
classificationStringFilter : list<string>
Enthält die Klassifizierungszeichenfolgen, die zum Filtern von räumlichen Ankerpunkten verwendet werden.
Wenn die Eigenschaft „ filterMode “ auf „ Classification “ gesetzt ist, kann diese Eigenschaft verwendet werden, um eine Liste zusätzlicher Klassifizierungszeichenfolgen für die Filterung bereitzustellen. Diese Bezeichnungen werden dann mit demselben Wert abgeglichen, der von der Eigenschaft „ XrSpatialAnchor::classificationString “ des räumlichen Ankers gemeldet wird.
Hinweis: Nur „ spatial anchors “, die als „ Other “ klassifiziert sind, werden anhand dieses Filters überprüft.
filterMode : enumeration
Legt den Filtermodus für räumliche Anker fest.
Enthält den Filtermodus. Der Filtermodus kann einer der folgenden sein:
| Konstant | Beschreibung |
|---|---|
XrSpatialAnchorListModel.All | Alle räumlichen Anker anzeigen. |
XrSpatialAnchorListModel.Classification | Zeigt räumliche Anker basierend auf dem angegebenen Klassifizierungsfilter-Flag an. |
XrSpatialAnchorListModel.Identifier | Zeigt räumliche Anker an, die mit den angegebenen Identifikatoren übereinstimmen. |
identifierFilter : list<string>
Enthält die Liste der Identifikatoren zum Filtern von räumlichen Ankerpunkten.
Methodendokumentation
void requestSceneCapture()
Diese Methode löst einen Scan aus, um räumliche Daten der aktuellen Umgebung zu erfassen oder zu aktualisieren.
Diese Methode veranlasst das zugrunde liegende XR-System, eine Szenenerfassung der aktuellen physischen Umgebung des Benutzers durchzuführen, um das räumliche Netz zu aktualisieren oder zu verfeinern, wodurch eine genauere Platzierung und Verfolgung von räumlichen Ankern ermöglicht wird.
Hinweis: Einige Plattformen führen diesen Vorgang nicht automatisch durch. Befindet sich der Nutzer beispielsweise auf dem Quest 3 in einem zuvor nicht erfassten Raum, wird diese Methode nicht automatisch aufgerufen, sodass keine Anker verfügbar sind, bis eine Erfassung manuell ausgelöst wird.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.