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 Scene 및 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의 분류 유형 간 매핑을 보여줍니다. 시스템에서 반환된 분류 유형이 정의된 유형 범위를 벗어날 경우, 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]

공간 앵커의 위치.

이 속성은 세션 좌표계 내에서 공간 앵커의 원점 위치(미터 단위)를 반환합니다.

rotation : quaternion [read-only]

공간 앵커의 방향.

이 속성은 공간 앵커의 회전(쿼터니언 형식)을 제공합니다.