GamepadPose.orientation

Experimental: This is an experimental technology
Check 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
Gamepad Extensions
# dom-gamepadpose-orientation

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
orientation
No
15-79
55
No
No
No
No
No
55
No
No
No

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GamepadPose/orientation