Expo 传感器

一个提供对设备的加速度计、气压计、运动、陀螺仪、光、磁力计和计步器的访问的库。

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

¥expo-sensors provide various APIs for accessing device sensors to measure motion, orientation, pressure, magnetic fields, ambient light, and step count.

安装

¥Installation

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

应用配置中的配置

¥Configuration in app config

如果你在项目中使用配置插件（EAS 构建 或 npx expo run:[android|ios]），则可以使用其内置的 配置插件 配置 expo-sensors。该插件允许你配置无法在运行时设置的各种属性，并且需要构建新的应用二进制文件才能生效。

¥You can configure expo-sensors using its built-in config plugin if you use config plugins in your project (EAS Build or npx expo run:[android|ios]). The plugin allows you to configure various properties that cannot be set at runtime and require building a new app binary to take effect.

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';
// OR
import {
  Accelerometer,
  Barometer,
  DeviceMotion,
  Gyroscope,
  LightSensor,
  Magnetometer,
  MagnetometerUncalibrated,
  Pedometer,
} from 'expo-sensors';

权限

¥Permissions

安卓

¥Android

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

¥Starting in Android 12 (API level 31), the system has a 200Hz limit for each sensor updates.

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

¥If you need an update interval of less than 200Hz, you must add the following permissions to your app.json inside the expo.android.permissions array.

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

iOS 系统

¥iOS

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

¥The following usage description keys are used by this library:

可用传感器

¥Available sensors

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

¥For more information, see the documentation for the sensor you are interested in: