Web/API/GamepadPose/orientation

From Get docs

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 Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet

orientation

Experimental'

Chrome

No support No

Edge

No support 15 — 79

Firefox Full support Yes

Notes' Disabled'

Full support Yes

Notes' Disabled'

Notes' The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Disabled' This feature is behind the dom.gamepad-extensions.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

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