GamepadPose.position

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The position read-only property of the GamepadPose interface returns the position of the Gamepad as a 3D vector.

The coordinate system is as follows:

  • Positive X is to the user’s right.
  • Positive Y is up.
  • Positive Z is behind the user.

Positions are measured in meters from an origin point — this point is the position the sensor was first read at.

Syntax

var myGamepadPosition = gamepadPoseInstance.position;

Value

A Float32Array, or null if the gamepad is not able to provide position data.

Note: User agents may provide emulated position values through certain techniques; when doing so they should still report GamepadPose.hasPosition as false.

Examples

TBD

Specifications

Specification Status Comment
Gamepad Extensions
The definition of 'position' in that specification.
Editor's Draft Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No No Yes1 2 No No No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic support No No No No No No No

1. The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.

2. This feature is behind the dom.gamepad-extensions.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Document Tags and Contributors

 Contributors to this page: fscholz, chrisdavidmills
 Last updated by: fscholz,