Sur cette page

XrHandModel QML Type

Représente un modèle 3D de main. En savoir plus...

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

Model

Status: Technology preview

Ce type est en préversion technologique et est susceptible d'être modifié.

Propriétés

  • hand : enumeration

Description détaillée

Contient un modèle 3D animé qui suit les mouvements des mains de l'utilisateur.

XrHandModel n'est visible que lorsque le suivi des mains est activé.

Remarque : XrHandModel dépend des données de suivi des mains fournies par le système sous-jacent et n'est donc pas disponible sur toutes les plateformes.

Remarques sur les plateformes

Apple Vision Pro

L'Apple Vision Pro superposera directement la vidéo des mains de l'utilisateur, et le XrHandModel n'affichera aucun contenu.

Appareils Meta

Cela a nécessité l’ajout des lignes de fonctionnalités et d’autorisations suivantes dans le fichier AndroidManifest.qml de votre projet.

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

Utilisez « true » à la place de « false » dans la balise « uses-feature » si l’interaction de votre application est implémentée uniquement pour les mains.

Documentation des propriétés

hand : enumeration [default: XrHandModel.Unknown]

Indique quelle main le modèle montre

ConstanteDescription
XrHandModel.LeftHandLa main gauche.
XrHandModel.RightHandLa main droite.
XrHandModel.UnknownAucune main n’est représentée.

La valeur de cette propriété est compatible avec XrController.controller.

Avertissement : cette propriété doit être définie lors de la création de l'XrHandModel. La modification ultérieure de la main n'est actuellement pas prise en charge.

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