XrSpatialAnchor QML Type

実空間内の特定の場所やオブジェクトを追跡します。詳細...

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• Classification : enumeration
• classification : enumeration
• classificationString : string
• extent2D : vector2d
• extent3D : vector3d
• has2DBounds : bool
• has3DBounds : bool
• identifier : string
• offset2D : vector2d
• offset3D : vector3d
• position : vector3d
• rotation : quaternion

詳細な説明

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

空間アンカーには、XrSpatialAnchorListModel を通じてアクセスします。

この型の使用方法については、「Qt Quick 3D - XR 空間アンカーの例」を参照してください。

プラットフォームに関する注意事項

Meta Quest デバイス

このAPIは、Meta Questのシーンおよび空間アンカーAPIを利用しています。アプリのAndroidManifest.xml ファイルに以下の権限を追加する必要があります。

<uses-permission android:name="com.oculus.permission.USE_ANCHOR_API"/>
<uses-permission android:name="com.oculus.permission.USE_SCENE"/>

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

Classification : enumeration [read-only]

空間アンカーの分類。

Classification列挙型は、空間アンカーの目的や文脈を記述する、あらかじめ定義されたカテゴリ型のセットを提供します。

以下の表は、Qt Quick 3D Xr、OpenXR、およびVisionOSにおける分類タイプの対応関係を示しています。システムからの分類タイプが定義されたタイプに含まれない場合、TypeはOther に設定され、システムタイプはclassificationString プロパティによって提供されます。

classification : enumeration [read-only]

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

このプロパティは、このアンカーの目的やコンテキストを記述するclassification type （例：Table またはFloor ）を返します。

「classificationString」も参照してください 。

classificationString : string [read-only]

空間アンカーの分類タイプ（文字列）。

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

関連項目： classification 。

extent2D : vector2d [read-only]

空間アンカーの2次元範囲。

このプロパティは、X/Z平面内における空間アンカーの2次元サイズ（幅と高さ）を保持します。has2DBounds がtrue の場合に有効です。

「 has2DBounds 」および「offset2D 」も参照してください 。

extent3D : vector3d [read-only]

空間アンカーの3次元範囲。

このプロパティは、空間アンカーの3次元（幅、高さ、奥行き）における体積を指定します。has3DBounds がtrue の場合に有効です。

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

has2DBounds : bool [read-only]

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

空間アンカーが、offset2D およびextent2D で記述される2Dの境界を持ち、平らな面（床や壁など）を表している場合、このプロパティは `true ` を返します。

それ以外の場合は、falseを返します。

offset2D 、extent2D 、およびhas3DBoundsも参照してください 。

has3DBounds : bool [read-only]

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

このプロパティは、空間アンカーに3Dの境界がある場合、true を返します。これは、その空間アンカーが体積（例えば、テーブルや食器棚など）を表していることを示します。境界は、offset3D およびextent3D によって記述されます。

それ以外の場合は、false を返します。

offset3D 、extent3D 、およびhas2DBoundsも参照してください 。

identifier : string [read-only]

この空間アンカーを一意に識別する識別子です。

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

offset2D : vector2d [read-only]

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

このプロパティは、X/Z平面内におけるアンカーの境界のオフセットを保持します。has2DBounds がtrue の場合に有効です。

「 has2DBounds 」および「extent2D 」も参照してください 。

offset3D : vector3d [read-only]

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

このプロパティは、アンカーのposition からのアンカーの境界の3Dオフセット（メートル単位）を返します。

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

position : vector3d [read-only]

空間アンカーの位置。

このプロパティは、セッションの座標系における空間アンカーの原点の3D位置（メートル単位）を返します。

rotation : quaternion [read-only]

空間アンカーの向き。

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