XrSpatialAnchor QML Type

実空間の特定の場所や物体を追跡します。詳細...

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

QtObject

Status: Technical Preview

プロパティ

詳細説明

この型は、実空間の特定の場所やオブジェクトを追跡する空間アンカーを表す。アンカーの位置、回転、分類、境界に関する情報を提供する。

空間アンカーはXrSpatialAnchorListModel を通してアクセスされる。

注意: アンカーオブジェクトはシステムから提供されます。QMLで作成することはできません。

このタイプの使用方法については、Qt Quick 3D - XR Spatial Anchors Exampleを参照してください。

プロパティ ドキュメント

Classification : enumeration [read-only]

空間アンカーの分類。

Classification列挙型は、空間アンカーの目的やコンテキストを記述する、定義済みのカテゴリータイプのセットを提供します。

定数説明
Classification.Unknownラベルは設定または識別されていません。
Classification.Wallアンカーは壁を表します。
Classification.Ceilingアンカーは天井を表す。
Classification.Floorアンカーは床を表す。
Classification.Tableアンカーはテーブルを表す。
Classification.Seatアンカーは座席を表す。
Classification.Window錨は窓を表す。
Classification.Doorアンカーはドアを表す。
Classification.Otherアンカーは上記のタイプのいずれにも該当しない。参照:classificationString

次の表は、Qt Quick 3D Xr、OpenXR、および VisionOS における分類タイプ間のマッピングを示しています。システムからの分類タイプが定義されたタイプから外れる場合、タイプは Other に設定され、システム・タイプはclassificationString プロパティによって提供されます。

注: 分類文字列は、Other にすることもできます。

タイプOpenXRVisionOS説明
不明--ラベルが設定または識別されていない。
壁面アンカーは壁を表す。
天井天井天井アンカーは天井を表す。
アンカーは床を表す。
テーブルテーブルテーブルアンカーはテーブルを表す。
シートソファーシートアンカーは座席を表す。
窓枠アンカーは窓を表す。
ドアドア_フレームドアアンカーはドアを表す。
その他--アンカーは他の何かを表す。参照:classificationString

classification : enumeration [read-only]

空間アンカーの分類タイプ。

このプロパティは、アンカーの目的またはコンテキストを記述する、このアンカーのclassification type (例えば、Table またはFloor )を返す。

注意: システムからの分類タイプは、Classification enumで定義されたラベルのセットに含まれていない可能性があります。その場合、タイプはOther に設定され、classificationString プロパティには元のラベルが含まれます。

classificationStringも参照のこと


classificationString : string [read-only]

空間アンカーの分類タイプを文字列として返す。

このプロパティは、分類タイプが存在する場合、文字列として返す。分類タイプがClassification enums で定義されたタイプセットにない場合、ラベルはOther に設定され、このプロパティを使用してシステムから報告されたタイプにアクセスできます。

注: この文字列は、システムとアンカーがどのように分類されるかに応じて、空または変更される。

classificationも参照のこと


extent2D : vector2d [read-only]

空間アンカーの 2D 範囲。

このプロパティは、空間アンカーのX/Z平面内の2次元サイズ(幅と高さ)を保持する。has2DBoundstrue のときに有効です。

has2DBounds およびoffset2Dも参照のこと


extent3D : vector3d [read-only]

空間アンカーの3Dエクステント。

このプロパティは、空間アンカーの体積を3次元(幅、高さ、奥行き)で指定する。has3DBoundstrue のときに有効です。

offset3D およびhas3DBoundsも参照


has2DBounds : bool [read-only]

空間アンカーが 2D 境界を持つかどうかを示します。

このプロパティは、空間アンカーがoffset2D およびextent2D で説明される 2D 境界を持つ場合、true を保持する。これは、空間アンカーが平面(例えば、床や壁)を表すことを示す。

そうでない場合は、false を返します。

offset2Dextent2D 、およびhas3DBoundsも参照のこと


has3DBounds : bool [read-only]

空間アンカーに 3D 境界があるかどうかを示します。

このプロパティは、空間アンカーが3D境界を持つ場合、true を返す。これは、空間アンカーがボリューム(テーブルや食器棚など)を表すことを示す。境界はoffset3Dextent3D で説明される。

そうでない場合は、false を返します。

offset3Dextent3D 、およびhas2DBoundsも参照


identifier : string [read-only]

この空間アンカーの一意の識別子。

このプロパティは、空間アンカーに関連付けられた一意の識別子を保持する。これは、XrSpatialAnchorListModel で参照される識別子と同じである。


offset2D : vector2d [read-only]

空間アンカーの 2D オフセット。

このプロパティは、X/Z 平面内でのアンカーの境界のオフセットを保持する。has2DBoundstrue のときに有効である。

has2DBounds およびextent2Dも参照


offset3D : vector3d [read-only]

空間アンカーの3Dオフセット。

このプロパティは、アンカーのposition からのアンカーの境界の3Dオフセット(メートル単位)を提供する。

offset3D およびhas3DBoundsも参照してください


position : vector3d [read-only]

空間アンカーの位置。

このプロパティは、セッションの座標系内での空間アンカーの原点の3D位置(メートル単位)を返す。


rotation : quaternion [read-only]

空間アンカーの向き。

このプロパティは、空間アンカーの回転を(クォータニオンとして)提供します。


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