Auf dieser Seite

XrSpatialAnchorListModel QML Type

Stellt ein Modell bereit, das räumliche Anker enthält. Mehr...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

ListModel

Status: Technology preview

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

Eigenschaften

Methoden

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:

KonstanteWert
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:

KonstantBeschreibung
XrSpatialAnchorListModel.AllAlle räumlichen Anker anzeigen.
XrSpatialAnchorListModel.ClassificationZeigt räumliche Anker basierend auf dem angegebenen Klassifizierungsfilter-Flag an.
XrSpatialAnchorListModel.IdentifierZeigt 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.