Below is a list of interfaces based on the OrientationSensor interface.

- {{domxref('AbsoluteOrientationSensor')}}

- {{domxref('RelativeOrientationSensor')}}

- {{domxref("OrientationSensor.quaternion")}} {{ReadOnlyInline}}

- : Returns a four element {{jsxref('Array')}} whose elements contain the components of the unit quaternion representing the device's orientation.

- {{domxref("OrientationSensor.populateMatrix()")}}

- : Populates the given object with the rotation matrix based on the latest sensor reading.

The following example, which is loosely based on [Intel's Orientation Phone demo](https://intel.github.io/generic-sensor-demos/orientation-phone/), instantiates an `AbsoluteOrientationSensor` with a frequency of 60 times a second. On each reading it uses {{domxref('OrientationSensor.quaternion')}} to rotate a visual model of a phone.

const options = { frequency: 60, referenceFrame: "device" };

const sensor = new AbsoluteOrientationSensor(options);

sensor.addEventListener("reading", () => {

// model is a Three.js object instantiated elsewhere.

model.quaternion.fromArray(sensor.quaternion).inverse();

});

sensor.addEventListener("error", (error) => {

if (event.error.name === "NotReadableError") {

console.log("Sensor is not available.");

}

});

sensor.start();

Using orientation sensors requires requesting permissions for multiple device sensors. Because the {{domxref('Permissions')}} interface uses promises, a good way to request permissions is to use {{jsxref('Promise.all')}}.

const sensor = new AbsoluteOrientationSensor();

Promise.all([

navigator.permissions.query({ name: "accelerometer" }),

navigator.permissions.query({ name: "magnetometer" }),

navigator.permissions.query({ name: "gyroscope" }),

]).then((results) => {

if (results.every((result) => result.state === "granted")) {

sensor.start();

// …

} else {

console.log("No permissions to use AbsoluteOrientationSensor.");

}

});

{{Specifications}}