Reference version

Expo 传感器 iconExpo 传感器

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

Android
iOS
Web
Included in Expo Go
Bundled version:
~14.1.4

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

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

安装

Terminal
npx expo install expo-sensors

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

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

Configurable properties

NameDefaultDescription
motionPermission"允许 $(PRODUCT_NAME) 访问你的设备运动"
Only for:
iOS

用于设置 NSMotionUsageDescription 权限提示消息的字符串,或设置为 false 以禁用运动权限。

API

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

权限

Android

从 Android 12(API level 31)开始,系统对每个传感器更新设置了 200Hz 的限制。

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

Android PermissionDescription

HIGH_SAMPLING_RATE_SENSORS

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 KeyDescription

NSMotionUsageDescription

A message that tells the user why the app is requesting access to the device’s motion data.

可用传感器

更多信息请参阅你感兴趣的传感器文档:

Accelerometer

在所有平台上测量设备加速度。

Barometer

在 Android 和 iOS 平台上测量压力。

DeviceMotion

在所有平台上测量设备运动。

Gyroscope

在所有平台上测量设备旋转。

Magnetometer

在 Android 和 iOS 平台上测量磁场。

LightSensor

在 Android 平台上测量环境光。

Pedometer

在 Android 和 iOS 平台上测量步数。