Get Started
API Reference


Gyroscope from expo-sensors provides access to the device's gyroscope sensor to respond to changes in rotation in 3D space.

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb


expo install expo-sensors

If you're installing this in a bare React Native app, you should also follow these additional installation instructions.

import React, { useState, useEffect } from 'react';
import { StyleSheet, Text, TouchableOpacity, View } from 'react-native';
import { Gyroscope } from 'expo-sensors';

export default function App() {
  const [data, setData] = useState({});

  useEffect(() => {
  }, []);

  useEffect(() => {
    return () => {
  }, []);

  const _toggle = () => {
    if (this._subscription) {
    } else {

  const _slow = () => {

  const _fast = () => {

  const _subscribe = () => {
    this._subscription = Gyroscope.addListener(gyroscopeData => {

  const _unsubscribe = () => {
    this._subscription && this._subscription.remove();
    this._subscription = null;

  let { x, y, z } = data;
  return (
    <View style={styles.sensor}>
      <Text style={styles.text}>Gyroscope:</Text>
      <Text style={styles.text}>
        x: {round(x)} y: {round(y)} z: {round(z)}
      <View style={styles.buttonContainer}>
        <TouchableOpacity onPress={_toggle} style={styles.button}>
        <TouchableOpacity onPress={_slow} style={[styles.button, styles.middleButton]}>
        <TouchableOpacity onPress={_fast} style={styles.button}>

function round(n) {
  if (!n) {
    return 0;

  return Math.floor(n * 100) / 100;

import { Gyroscope } from 'expo-sensors';


You should always check the sensor availability before attempting to use it.
Returns whether the gyroscope is enabled on the device.
On web this starts a timer and waits to see if an event is fired. This should predict if the iOS device has the device orientation API disabled in Settings > Safari > Motion & Orientation Access. Some devices will also not fire if the site isn't hosted with HTTPS as DeviceMotion is now considered a secure API. There is no formal API for detecting the status of DeviceMotion so this API can sometimes be unreliable on web.

  • A promise that resolves to a boolean denoting the availability of the sensor.

Subscribe for updates to the gyroscope.

  • listener (function) -- A callback that is invoked when an gyroscope update is available. When invoked, the listener is provided a single argument that is an object containing keys x, y, z.

  • An EventSubscription object that you can call remove() on when you would like to unsubscribe the listener.

Remove all listeners.

Subscribe for updates to the gyroscope.

  • intervalMs (number) -- Desired interval in milliseconds between gyroscope updates.