hand-controls
NOTE: This version of the documentation tracks unstable development happening on A-Frame’s master branch . If you wish to try it out, grab the unstable build . Otherwise, head to the documentation for the current 1.7.0 version
The hand-controls component provides tracked hands (using a prescribed model)
with animated gestures. hand-controls wraps the vive-controls and
meta-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.
Example <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 >
Properties
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
Events
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.
Assets