XrSpatialAnchorListModel QML Type

공간 앵커가 포함된 모델을 제공합니다. 더 보기...

Import Statement:	`import QtQuick3D.Xr`
Since:	Qt 6.8
Inherits:	ListModel
Status:	Technical Preview

상속된 멤버를 포함한 모든 멤버 목록

속성

classificationFilter : enumeration
classificationStringFilter : list<string>
filterMode : enumeration
identifierFilter : list<string>

방법

void requestSceneCapture()

상세 설명

이 유형은 가상 콘텐츠와 추적 및 연결할 수 있는 물리적 세계의 지점인 공간 앵커 목록을 제공합니다.

이 목록에는 XrSpatialAnchor 유형의 anchor 속성을 가진 요소가 포함됩니다.

다음과 같이 사용할 수 있습니다:

Repeater3D {
    model: XrSpatialAnchorListModel {
    }
    delegate: Node {
        required property XrSpatialAnchor anchor
        position: anchor.position
        rotation: anchor.rotation
        // Further use of anchor properties...
    }
}

속성 문서

classificationFilter : enumeration

공간 앵커를 필터링하는 데 사용되는 분류 플래그를 보유합니다.

ClassificationFlag 필터는 플래그의 조합으로 표시됩니다:

상수	Value
`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 시스템을 트리거하여 사용자의 현재 물리적 환경에 대한 씬 캡처를 수행하고 공간 메시를 업데이트하거나 세분화하여 공간 앵커를 보다 정확하게 배치하고 추적할 수 있도록 합니다.

참고: 일부 플랫폼에서는 이 작업이 자동으로 수행되지 않습니다. 예를 들어, 퀘스트 3에서 사용자가 이전에 캡처되지 않은 공간에 있는 경우 이 메서드는 자동으로 호출되지 않으므로 수동으로 캡처를 트리거할 때까지 사용 가능한 앵커가 없습니다.

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