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 Spatial Anchors Exampleを参照してください。

プラットフォーム

メタクエストデバイス

このAPIはMeta Quest Scene APIとSpatial Anchor 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 における分類タイプ間のマッピングを示しています。システムからの分類タイプが定義されたタイプから外れる場合、タイプは Other に設定され、システム・タイプはclassificationString プロパティによって提供されます。

classification : enumeration [read-only]

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

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

classificationStringも参照してください 。

classificationString : string [read-only]

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

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

classificationも参照のこと 。

extent2D : vector2d [read-only]

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

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

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

extent3D : vector3d [read-only]

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

このプロパティは、空間アンカーの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]

空間アンカーの向き。

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