node package manager



A GearVR Controller component for A-Frame.

GearVR Touchpad

The gearvr-controls component interfaces with the Gear VR Touchpad controller exposed by the Carmel and Samsung Internet VR browsers. The tracked-controls component cannot provide its usual functionality, since the Gear VR touchpad has no pose. Instead, the look-controls component is used to mimic a 3DOF controller. (Note that a dummy instance of tracked-controls is currently added anyway for compatibility, since other components such as aframe-teleport-controls query for entities with that component attached.)

This component adds button mappings and events, but does not currently provide a controller model since it is assumed that end users will use this indirectly through higher level components such as the hand-controls component.

As there is only one Gear VR Touchpad, currently this component should only be bound to one hand (e.g. to the right hand, not the left).


<a-entity gearvr-controls></a-entity>


Property Description Default Value
hand The hand that will be tracked (i.e., right, left). right
model Whether the controller model is loaded. false
rotationOffset Offset to apply to model rotation. 0


Event Name Description
trackpaddown Trackpad pressed.
trackpadup Trackpad released.



Install and use by directly including the browser files:

  <title>My A-Frame Scene</title>
  <script src=""></script> 
  <script src=""></script> 
    <a-entity gearvr-controls></a-entity>


Install via npm:

npm install aframe-gearvr-controls-component

Then register and use.