このページでは

XrSpatialAnchorListModel QML Type

空間アンカーを含むモデルを提供します。詳細...

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

ListModel

Status: Technology preview

この型はテクノロジープレビュー段階にあり、変更される可能性があります。

プロパティ

方法

詳細な説明

この型は、空間アンカーのリストを提供します。空間アンカーとは、現実世界にある点であり、追跡が可能で、仮想コンテンツに関連付けることができます。

このリストには、タイプが `XrSpatialAnchor` の `anchor ` プロパティを持つ要素が含まれています。

次のように使用できます:

Repeater3D {
    model: XrSpatialAnchorListModel {
    }
    delegate: Node {
        required property XrSpatialAnchor anchor
        position: anchor.position
        rotation: anchor.rotation
        // Further use of anchor properties...
    }
}

プロパティのドキュメント

classificationFilter : enumeration

空間アンカーのフィルタリングに使用される分類フラグを保持します。

ClassificationFlag フィルターは、以下のフラグの組み合わせとして表されます:

定数値
XrSpatialAnchorListModel.Wall
XrSpatialAnchorListModel.Ceiling
XrSpatialAnchorListModel.Floor
XrSpatialAnchorListModel.Table
XrSpatialAnchorListModel.Seat
XrSpatialAnchorListModel.Window
XrSpatialAnchorListModel.Door
XrSpatialAnchorListModel.Other

classificationStringFilter : list<string>

空間アンカーのフィルタリングに使用される分類文字列を保持します。

filterMode がClassification に設定されている場合、このプロパティを使用して、フィルタリングに用いる追加の分類文字列のリストを指定できます。これらのラベルは、空間アンカーのXrSpatialAnchor::classificationString プロパティで報告される値と照合されます。

注: このフィルタによるチェックの対象となるのは、`Other ` として分類されたspatial anchors のみです 。

filterMode : enumeration

空間アンカーのフィルタモードを指定します。

フィルタモードを保持します。フィルタモードは、以下のいずれかになります:

定数説明
XrSpatialAnchorListModel.Allすべての空間アンカーを表示します。
XrSpatialAnchorListModel.Classification指定された分類フィルタフラグに基づいて空間アンカーを表示します。
XrSpatialAnchorListModel.Identifier指定された識別子との一致に基づいて空間アンカーを表示します。

identifierFilter : list<string>

空間アンカーをフィルタリングするための識別子のリストを保持します。

メソッドのドキュメント

void requestSceneCapture()

このメソッドは、現在の環境の空間データを取得または更新するためのスキャンを実行します。

このメソッドは、基盤となるXRシステムに、ユーザーの現在の物理環境のシーンキャプチャを実行させ、空間メッシュを更新または精緻化することで、空間アンカーのより正確な配置と追跡を可能にします。

注:一部の プラットフォームでは 、この操作が自動的に実行されません。たとえば、Quest 3 では、ユーザーが以前にキャプチャされていない空間にいる場合、このメソッドは自動的に呼び出されないため、手動でキャプチャがトリガーされるまで利用可能なアンカーは存在しません。

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