This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

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

安装

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

在 app 配置中进行配置

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

Example app.json with config plugin

{
  "expo": {
    "plugins": [
      [
        "expo-sensors",
        {
          "motionPermission": "允许 $(PRODUCT_NAME) 访问你的设备运动"
        }
      ]
    ]
  }
}

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

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

可用传感器

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