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

Expo 磁力计 iconExpo 磁力计

提供对设备磁力计传感器的访问的库。

Android
iOS
Included in Expo Go
Recommended version:
~58.0.3

expo-sensors 的 Magnetometer 提供对设备磁力计传感器的访问,以响应并测量以微特斯拉(μT)为单位的磁场变化。

你可以使用 Magnetometer 访问校准后的数值,使用 MagnetometerUncalibrated 访问未校准的原始数值。

🌐 You can access the calibrated values with Magnetometer and uncalibrated raw values with MagnetometerUncalibrated.

安装

🌐 Installation

Terminal
- npx expo install expo-sensors
- yarn expo install expo-sensors
- pnpm expo install expo-sensors
- bun expo install expo-sensors

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

用法

🌐 Usage

Magnetometer
import { useState, useEffect } from 'react'; import { StyleSheet, Text, TouchableOpacity, View } from 'react-native'; import { Magnetometer } from 'expo-sensors'; export default function Compass() { const [{ x, y, z }, setData] = useState({ x: 0, y: 0, z: 0, }); const [subscription, setSubscription] = useState(null); const _slow = () => Magnetometer.setUpdateInterval(1000); const _fast = () => Magnetometer.setUpdateInterval(16); const _subscribe = () => { setSubscription( Magnetometer.addListener(result => { setData(result); }) ); }; const _unsubscribe = () => { subscription && subscription.remove(); setSubscription(null); }; useEffect(() => { _subscribe(); return () => _unsubscribe(); }, []); return ( <View style={styles.container}> <Text style={styles.text}>Magnetometer:</Text> <Text style={styles.text}>x: {x}</Text> <Text style={styles.text}>y: {y}</Text> <Text style={styles.text}>z: {z}</Text> <View style={styles.buttonContainer}> <TouchableOpacity onPress={subscription ? _unsubscribe : _subscribe} style={styles.button}> <Text>{subscription ? 'On' : 'Off'}</Text> </TouchableOpacity> <TouchableOpacity onPress={_slow} style={[styles.button, styles.middleButton]}> <Text>Slow</Text> </TouchableOpacity> <TouchableOpacity onPress={_fast} style={styles.button}> <Text>Fast</Text> </TouchableOpacity> </View> </View> ); } const styles = StyleSheet.create({ container: { flex: 1, justifyContent: 'center', paddingHorizontal: 10, }, text: { textAlign: 'center', }, buttonContainer: { flexDirection: 'row', alignItems: 'stretch', marginTop: 15, }, button: { flex: 1, justifyContent: 'center', alignItems: 'center', backgroundColor: '#eee', padding: 10, }, middleButton: { borderLeftWidth: 1, borderRightWidth: 1, borderColor: '#ccc', }, });

应用接口

🌐 API

import { Magnetometer, MagnetometerUncalibrated } from 'expo-sensors';

No API data file found, sorry!