XrHandModel QML Type

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

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

Model

Status: Technology preview

This type is in technology preview and is subject to change.

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. Like other tracked nodes, it must be a child of the XrOrigin, because the joint poses that drive it are relative to the origin.

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.

See also Coordinate Systems and Units in Qt Quick 3D Xr.

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.