This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 55).

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

expo-sensors 提供了多种 API，用于访问设备传感器，以测量运动、方向、压力、磁场、环境光和步数。

安装

If you are installing this in an existing React Native app, make sure to install expo in your project.

在 app config 中进行配置

如果你在项目中使用 config plugins（Continuous Native Generation (CNG)），可以使用 expo-sensors 内置的 config plugin 进行配置。该插件允许你配置各种无法在运行时设置的属性，并且这些配置需要构建新的应用二进制文件后才会生效。如果你的应用不使用 CNG，那么你需要手动配置该库。

Example app.json with config plugin

{
  "expo": {
    "plugins": [
      [
        "expo-sensors",
        {
          "motionPermission": "Allow $(PRODUCT_NAME) to access your device motion"
        }
      ]
    ]
  }
}

Configurable properties

API

import * as Sensors from 'expo-sensors';
// 或
import {
  Accelerometer,
  Barometer,
  DeviceMotion,
  Gyroscope,
  LightSensor,
  Magnetometer,
  MagnetometerUncalibrated,
  Pedometer,
} from 'expo-sensors';

权限

Android

从 Android 12（API 级别 31）开始，系统对每个传感器更新设置了 200Hz 的限制。

如果你需要大于 200Hz 的更新间隔，则必须将以下权限添加到你的 app.json 中 expo.android.permissions 数组里。

<uses-permission android:name="android.permission.HIGH_SAMPLING_RATE_SENSORS" />

iOS

该库使用以下用途描述键：

可用传感器

有关更多信息，请参阅你感兴趣的传感器文档：