title: hand-controls type: components layout: docs parent_section: components source_code: src/components/hand-controls.js
The hand-controls component provides tracked hands (using a prescribed model) with animated gestures. hand-controls wraps the vive-controls and oculus-touch-controls which in turn wrap the tracked-controls component. By specifying just hand-controls
, we have something that works well with both Vive and Rift. The component gives extra events and handles hand animations and poses.
<a-entity id="leftHand" hand-controls="hand: left; handModelStyle: lowPoly; color: #ffcccc"></a-entity> <a-entity id="rightHand" hand-controls="hand: right; handModelStyle: lowPoly; color: #ffcccc"></a-entity>
Property | Description | Default Value |
---|---|---|
color | Color of hand material. | white |
hand | Associated controller. Can be left or right . |
left |
handModelStyle | Style of the hand 3D model loaded. Can be lowPoly , highPoly or toon . |
lowPoly |
Event Name | Description |
---|---|
gripdown | The hand is closed into a fist without thumb raised. |
gripup | The hand is no longer closed into a fist without thumb raised. |
pointup | The hand is touching or pressing the trigger only. |
pointdown | The hand is no longer touching or pressing the trigger only. |
thumbup | The hand is closed into a fist with thumb raised. |
thumbdown | The hand is no longer closed into a fist with thumb raised. |
pointingstart | The hand is pointing with index finger without thumb raised. |
pointingend | The hand is no longer pointing without thumb raised. |
pistolstart | The hand is pointing with index finger and thumb raised. |
pistolend | The hand is no longer pointing with thumb raised. |