XrSpatialAnchorListModel QML Type
공간 앵커가 포함된 모델을 제공합니다. 더 보기...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
이 유형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.
속성
- classificationFilter : enumeration
- classificationStringFilter : list<string>
- filterMode : enumeration
- identifierFilter : list<string>
방법
- void requestSceneCapture()
상세 설명
이 유형은 추적할 수 있고 가상 콘텐츠와 연관될 수 있는 물리적 세계의 점인 공간 앵커 목록을 제공합니다.
이 목록에는 ` anchor ` 속성이 있으며, 해당 속성의 유형이 ` XrSpatialAnchor`인 요소들이 포함되어 있습니다.
다음과 같이 사용할 수 있습니다:
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.