React Native中expo-sensors的Pedometer在react-native-background-actions中失效

核心问题分析 #

1. 传感器进程隔离：expo-sensors 的 Pedometer 依赖 Expo 前台运行时上下文，react-native-background-actions 创建的后台任务是独立原生进程，无法共享 Expo 传感器订阅实例，导致后台接收不到步数更新。
2. 状态方法无法跨进程传递：你传入后台任务的状态更新方法属于前台 JS 线程上下文，无法被序列化传递到独立后台进程，因此即使流程执行，也无法触发前台状态更新。
3. 系统后台限制：iOS/Android 对后台传感器监听有严格管控，expo-sensors 默认实现不支持持续后台监听。

可行解决步骤 #

1. 前台监听+持久化存储，后台任务读取数据

利用前台正常监听的特性，在前台保持 Pedometer 订阅，将实时步数存入持久化存储（如 AsyncStorage），后台任务定时读取存储数据做后续处理。

代码示例：

• 前台启动监听并存储步数：

import { Pedometer } from 'expo-sensors';
import AsyncStorage from '@react-native-async-storage/async-storage';

export const startPedometerForeground = async () => {
  const subscription = Pedometer.watchStepCount(result => {
    AsyncStorage.setItem('latestStepCount', JSON.stringify(result.steps));
  });
  return subscription;
};

• 后台任务读取存储的步数：

import BackgroundService from 'react-native-background-actions';
import AsyncStorage from '@react-native-async-storage/async-storage';

const veryIntensiveTask = async taskDataArguments => {
  const { delay } = taskDataArguments;
  await new Promise(resolve => {
    setInterval(async () => {
      const stepCountStr = await AsyncStorage.getItem('latestStepCount');
      const stepCount = stepCountStr ? JSON.parse(stepCountStr) : 0;
      console.log('后台读取步数:', stepCount);
      // 执行你的后台业务逻辑，比如上传步数到服务器
    }, delay);
  });
};

export const startBackgroundTask = async () => {
  const options = {
    taskName: 'PedometerBackgroundTask',
    taskTitle: '步数统计中',
    taskDesc: '后台统计步数',
    taskIcon: { name: 'ic_launcher', type: 'mipmap' },
    delay: 5000, // 每5秒读取一次
  };
  await BackgroundService.start(veryIntensiveTask, options);
};

2. 用事件通知更新前台状态

后台任务无法直接调用前台状态方法，可通过事件通知机制触发前台更新：

• 后台任务发送事件：

import { DeviceEventEmitter } from 'react-native';

// 在veryIntensiveTask的定时器内
DeviceEventEmitter.emit('stepCountUpdated', stepCount);

• 前台监听事件更新状态：

import { DeviceEventEmitter } from 'react-native';

useEffect(() => {
  const listener = DeviceEventEmitter.addListener('stepCountUpdated', (stepCount) => {
    setStepCount(stepCount);
  });
  return () => listener.remove();
}, []);

3. 配置系统后台权限

确保已申请必要权限：

• Android：在 AndroidManifest.xml 中添加：

<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

• iOS：在 Info.plist 中添加：

<key>NSMotionUsageDescription</key>
<string>需要访问运动数据以统计步数</string>
<key>UIBackgroundModes</key>
<array>
  <string>fetch</string>
</array>

关键注意事项 #

• 禁止在 react-native-background-actions 后台任务中直接创建 Pedometer 订阅，后台进程无法获取 Expo 传感器上下文。
• 后台任务执行频率受系统限制，间隔不要设置过短，避免被系统强制终止。

内容的提问来源于stack exchange，提问作者Ahmad Nourldin