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
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | No | No | Yes1 2 | No | No | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS 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.