Back to Aframe

hand-tracking-controls

docs/components/hand-tracking-controls.md

1.7.12.1 KB
Original Source

Use hand-tracking-controls to integrate hand tracked input in your application. The component provides a visual representation of the hand and basic gesture recognition. It can be used along tracked controllers (e.g: meta-touch-controls) for applications requiring multiple input methods. Component is only active when the browser and underlying system starts tracking the user's hands.

Example

html
<a-entity id="leftHand" hand-tracking-controls="hand: left;"></a-entity>
<a-entity id="rightHand" hand-tracking-controls="hand: right;"></a-entity>

Properties

PropertyDescriptionDefault Value
handThe hand that will be tracked (i.e., right, left).left
modelColorColor of hand material.white
modelOpacityOpacity of the hand material.1.0
modelStyleMesh representing the hand or dots matching the jointsmesh

Events

Event NameDescription
pinchstartedThe pinch gesture has started. World coordinates passed as event detail.
pinchendedThe pinch gesture has ended. World coordinates passed as event detail.
pinchmovedThe hand moved while making the pinch gesture. Useful for interactions that track the hand while the gesture is engaged. World coordinates passed as event detail.

Assets