XrSpatialAnchorListModel QML Type

Stellt ein Modell mit räumlichen Ankern bereit. Mehr...

Import Statement:	`import QtQuick3D.Xr`
Since:	Qt 6.8
Inherits:	ListModel
Status:	Technical Preview

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

classificationFilter : enumeration
classificationStringFilter : list<string>
filterMode : enumeration
identifierFilter : list<string>

Methoden

void requestSceneCapture()

Detaillierte Beschreibung

Dieser Typ bietet eine Liste von räumlichen Ankern, d.h. Punkten in der physischen Welt, die verfolgt und mit virtuellen Inhalten verknüpft werden können.

Die Liste enthält Elemente, die eine anchor Eigenschaft mit dem Typ XrSpatialAnchor haben.

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...
    }
}

Eigenschaft Dokumentation

classificationFilter : enumeration

Enthält das Klassifizierungskennzeichen, das zum Filtern von räumlichen Ankern verwendet wird.

Der Filter ClassificationFlag wird als eine 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 Ankern verwendet werden.

Wenn filterMode auf Classification gesetzt ist, kann diese Eigenschaft verwendet werden, um eine Liste zusätzlicher Klassifizierungszeichenfolgen für die Filterung zu erstellen. Diese Bezeichnungen werden dann mit demselben Wert abgeglichen, den die Eigenschaft XrSpatialAnchor::classificationString des räumlichen Ankers angibt.

Hinweis: Nur spatial anchors, die als Other klassifiziert sind, werden mit diesem Filter abgeglichen.

filterMode : enumeration

Gibt den Filtermodus für räumliche Anker an.

Enthält den Filtermodus. Der Filtermodus kann einer der folgenden sein:

Konstant	Beschreibung
`XrSpatialAnchorListModel.All`	Alle räumlichen Verankerungen anzeigen.
`XrSpatialAnchorListModel.Classification`	Zeigt räumliche Verankerungen basierend auf dem angegebenen Klassifizierungsfilter-Flag.
`XrSpatialAnchorListModel.Identifier`	Zeigt räumliche Verankerungen basierend auf der Übereinstimmung mit den angegebenen Bezeichnern.

identifierFilter : list<string>

Enthält die Liste der Bezeichner für die Filterung räumlicher Verankerungen.

Dokumentation der Methode

void requestSceneCapture()

Diese Methode löst einen Scan aus, um räumliche Daten für die aktuelle Umgebung zu erfassen oder zu aktualisieren.

Diese Methode veranlasst das zugrundeliegende XR-System, eine Szenenerfassung der aktuellen physischen Umgebung des Benutzers durchzuführen, um das räumliche Netz zu aktualisieren oder zu verfeinern, was eine genauere Platzierung und Verfolgung von räumlichen Ankern ermöglicht.

Hinweis: Einige Plattformen führen diesen Vorgang nicht automatisch durch. Wenn sich der Benutzer beispielsweise auf Quest 3 in einem zuvor nicht erfassten Raum befindet, wird diese Methode nicht automatisch aufgerufen, was dazu führt, dass keine Anker verfügbar sind, bis eine Erfassung manuell ausgelöst wird.

© 2025 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.