This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.
The orientation
read-only property of the GamepadPose
interface returns the orientation of the Gamepad
, as a quarternion value.
The value is a Float32Array
, made up of the following values:
- pitch — rotation around the X axis.
- yaw — rotation around the Y axis.
- roll — rotation around the Z axis.
- w — the fourth dimension (usually 1).
The orientation yaw (rotation around the y axis) is relative to the initial yaw of the sensor when it was first read.
Syntax
var myGamepadOrientation = gamepadPoseInstance.orientation;
Value
A Float32Array
, or null
if the VR sensor is not able to provide orientation data.
Examples
TBD
Note: An orientation of { x: 0, y: 0, z: 0, w: 1 }
is considered to be "forward".
Specifications
Specification | Status | Comment |
Gamepad ExtensionsThe definition of 'orientation' in that specification. | Editor's Draft | Initial definition |
Browser compatibility
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
No support No |
Edge
No support 15 — 79 |
Firefox Full support Yes Full support Yes Notes' The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.
Disabled' This feature is behind the |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
No support No |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
- See implementation notes.'
- See implementation notes.
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
See also
GamepadPose.orientation by Mozilla Contributors is licensed under CC-BY-SA 2.5.