expo-sensors/src/Gyroscope.ts

Provides access to a hardware device's accelerometer, gyroscope, magnetometer, and pedometer.

import DeviceSensor from './DeviceSensor';
import type { Listener, Subscription } from './DeviceSensor';
import ExponentGyroscope from './ExponentGyroscope';

/**
 * Each of these keys represents the rotation along that particular axis measured in radians per second (rad/s).
 */
export type GyroscopeMeasurement = {
  /**
   * Value of rotation in radians per second device reported in X axis.
   */
  x: number;
  /**
   * Value of rotation in radians per second device reported in Y axis.
   */
  y: number;
  /**
   * Value of rotation in radians per second device reported in Z axis.
   */
  z: number;
  /**
   * Timestamp of the measurement in seconds.
   */
  timestamp: number;
};

export class GyroscopeSensor extends DeviceSensor<GyroscopeMeasurement> {
  /**
   * > **info** You should always check the sensor availability before attempting to use it.
   *
   * Returns whether the gyroscope is enabled on the device.
   *
   * On mobile web, you must first invoke `Gyroscope.requestPermissionsAsync()` in a user interaction (i.e. touch event) before you can use this module.
   * If the `status` is not equal to `granted` then you should inform the end user that they may have to open settings.
   *
   * 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.
   *
   * @return A promise that resolves to a `boolean` denoting the availability of the gyroscope.
   */
  async isAvailableAsync(): Promise<boolean> {
    return super.isAvailableAsync();
  }

  /**
   * Subscribe for updates to the gyroscope.
   *
   * @param listener A callback that is invoked when a gyroscope update is available. When invoked,
   * the listener is provided a single argument that is an `GyroscopeMeasurement` object.
   *
   * @return A subscription that you can call `remove()` on when you would like to unsubscribe the listener.
   */
  addListener(listener: Listener<GyroscopeMeasurement>): Subscription {
    return super.addListener(listener);
  }
}

export default new GyroscopeSensor(ExponentGyroscope, 'gyroscopeDidUpdate');