XrHandModel QML Type

Represents a 3D model for a hand. More...

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

Model

Status: Technical Preview

Properties

  • hand : enumeration

Detailed Description

Contains an animated 3D model that tracks the user's hands.

XrHandModel is only visible when hand tracking is active.

Note: XrHandModel depends on hand-tracking data from the underlying system and is, therefore, not available on all platforms.

Platform Notes

Apple Vision Pro

The Apple Vision Pro will overlay video of the user's hands directly, and the XrHandModel will not have any content.

Meta devices

This required the following feature and permission lines to be added in the AndroidManifest.qml file of your project.

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

Use true instead of false in the uses-feature tag if your app's interaction is implemented only for hands.

Property Documentation

hand : enumeration [default: XrHandModel.Unknown]

Specifies which hand the model is showing

ConstantDescription
XrHandModel.LeftHandThe left hand.
XrHandModel.RightHandThe right hand.
XrHandModel.UnknownNo hand is shown.

The value of this property is compatible with XrController.controller.

Warning: This property must be set when the XrHandModel is constructed. Changing hands later is not currently supported.