Expo 传感器
一个提供访问设备加速度计、气压计、运动传感器、陀螺仪、光线传感器、磁力计和计步器的库。
For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.
expo-sensors 提供了各种 API,用于访问设备传感器,以测量运动、方向、气压、磁场、环境光和步数。
安装
- npx expo install expo-sensorsIf you are installing this in an existing React Native app, make sure to install expo in your project.
在应用配置中进行配置
如果你在项目中使用配置插件(Continuous Native Generation (CNG)),你可以使用 expo-sensors 内置的 config plugin 来进行配置。该插件允许你配置一些无法在运行时设置的属性,并且这些更改需要重新构建新的应用二进制文件才会生效。如果你的应用不使用 CNG,则需要手动配置该库。
Example app.json with config plugin
{ "expo": { "plugins": [ [ "expo-sensors", { "motionPermission": "允许 $(PRODUCT_NAME) 访问你的设备运动" } ] ] } }
Configurable properties
| Name | Default | Description |
|---|---|---|
motionPermission | "允许 $(PRODUCT_NAME) 访问你的设备运动" | Only for: iOS 用于设置 |
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 数组里。
| Android Permission | Description |
|---|---|
Allows an app to access sensor data with a sampling rate greater than 200 Hz. |
Are you using this library in an existing React Native app?
如果你没有使用 Continuous Native Generation (CNG),或者你是手动使用原生 android 项目,请将 HIGH_SAMPLING_RATE_SENSORS 权限添加到项目的 android/app/src/main/AndroidManifest.xml 中:
<uses-permission android:name="android.permission.HIGH_SAMPLING_RATE_SENSORS" />
iOS
此库使用以下用途说明键:
| Info.plist Key | Description |
|---|---|
| A message that tells the user why the app is requesting access to the device’s motion data. |
可用传感器
有关更多信息,请参阅你感兴趣的传感器文档:
在所有平台上测量设备加速度。
在 Android 和 iOS 平台上测量气压。
在所有平台上测量设备运动。
在所有平台上测量设备旋转。
在 Android 和 iOS 平台上测量磁场。
在 Android 平台上测量环境光。
在 Android 和 iOS 平台上测量步数。