前言
在Flutter中可以使用sensors_plus插件来访问加速度计、陀螺仪、磁力计以及气压传感器
sensors_plue的平台支持
sensors_plue的要求
- Flutter >=3.19.0
- Dart >=3.3.0 <4.0.0
- iOS >=12.0
- MacOS >=10.14
- Android
compileSDK
34 - Java 17
- Android Gradle Plugin >=8.3.0
- Gradle wrapper >=8.4
sensors_plue的常用方法
AccelerometerEvent
加速计的离散读数。加速计测量设备的速度。请注意,这些读数包括重力的影响。简单地说,您可以使用加速计读数来判断设备是否在特定方向上移动。
UserAccelerometerEvent
与[AccelerometerEvent]一样,这是加速计的离散读数,用于测量设备的速度。然而,与[AccelerometerEvent]不同,该事件不包括重力的影响。
GyroscopeEvent
陀螺仪的离散读数。陀螺仪测量设备在3D空间中的速率或旋转。
MagnetometerEvent
磁力计测量传感器周围的环境磁场,返回每个三维轴的微特斯拉(μT)值。
考虑到这些样本可能受到地球磁场的影响以及设备本身的金属或附近磁铁等局部因素的影响,尽管大多数设备都会补偿这些因素。指南针是磁力计数据通用工具的一个例子。
BarometerEvent
气压计测量传感器周围的大气压力,返回百帕(hPa)的值。
考虑到这些样本可能受到海拔和天气条件的影响,可用于预测短期天气变化或确定海拔高度。请注意,由于操作设备引起的压力变化,防水手机或类似的密封设备在握持或使用时可能会出现压力波动。高度计是气压计数据通用工具的一个例子。
用法
如果要获取气压计数据,iOS需要访问运动数据。因此必须在应用文件中包含一个名为的键Info.plist
。此键提供一条消息,告知用户应用为何请求访问设备的运动数据
info.plist 条目示例:
<key>NSMotionUsageDescription</key>
<string>This app requires access to the barometer to provide altitude information.</string>
示例内容
import 'package:sensors_plus/sensors_plus.dart';
// 监听设备的加速度(包括重力影响)
accelerometerEventStream().listen(
(AccelerometerEvent event) {
print(event);
},
onError: (error) {},
cancelOnError: true,
); // [AccelerometerEvent (x: 0.0, y: 9.8, z: 0.0)]
// 监听设备的加速度(不包括重力影响)
userAccelerometerEventStream().listen(
(UserAccelerometerEvent event) {
print(event);
},
onError: (error) {},
cancelOnError: true,
); // [UserAccelerometerEvent (x: 0.0, y: 0.0, z: 0.0)]
// 监听设备的陀螺仪数据
gyroscopeEventStream().listen(
(GyroscopeEvent event) {
print(event);
},
onError: (error) {},
cancelOnError: true,
);// [GyroscopeEvent (x: 0.0, y: 0.0, z: 0.0)]
//监听设备的环境磁场
magnetometerEventStream().listen(
(MagnetometerEvent event) {
print(event);
},
onError: (error) {},
cancelOnError: true,
);// [MagnetometerEvent (x: -23.6, y: 6.2, z: -34.9)]
//监听设备周围的大气压力
barometerEventStream().listen(
(BarometerEvent event) {
print(event);
},
onError: (error) {},
cancelOnError: true,
);// [BarometerEvent (pressure: 1000.0)]