이 페이지에서

XrHandModel QML Type

손의 3D 모델을 나타냅니다. 더 보기...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

Model

Status: Technology preview

이 유형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.

속성

  • hand : enumeration

상세 설명

사용자의 손을 추적하는 애니메이션 3D 모델이 포함되어 있습니다.

XrHandModel은 손 추적 기능이 활성화된 경우에만 표시됩니다.

참고: XrHandModel은 기본 시스템의 손 추적 데이터에 의존하므로, 모든 플랫폼에서 사용할 수 있는 것은 아닙니다.

플랫폼 참고 사항

Apple Vision Pro

Apple Vision Pro는 사용자의 손 영상을 직접 오버레이하므로, XrHandModel에는 어떠한 콘텐츠도 표시되지 않습니다.

Meta 기기

이를 위해서는 프로젝트의 AndroidManifest.qml 파일에 다음 기능 및 권한 줄을 추가해야 합니다.

<uses-permission android:name="com.oculus.permission.HAND_TRACKING" />
<uses-feature android:name="oculus.software.handtracking" android:required="false" />

앱의 상호 작용이 손에만 구현된 경우, ` uses-feature ` 태그에서 ` false ` 대신 ` true `을 사용하십시오.

속성 문서

hand : enumeration [default: XrHandModel.Unknown]

모델이 어떤 손을 보여주고 있는지 지정합니다

상수설명
XrHandModel.LeftHand왼손.
XrHandModel.RightHand오른손.
XrHandModel.Unknown손이 표시되지 않습니다.

이 속성의 값은 ` XrController.controller`와 호환됩니다.

경고: 이 속성은 ` XrHandModel `가 생성될 때 설정되어야 합니다. 나중에 손을 변경하는 기능은 현재 지원되지 않습니다.

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