Pedometer Pro #

中文文档

Based on Pedometer & Pedometer_plus (references at the bottom)

This plugin allows you to get this info on both Android and iOS:

• Get step count for a from:to date range
• Get step count since last system boot
• Get real-time step count (Stream)
• Get real-time pedestrian status: Walking, Stopped (Stream)
• Get real-time step count since a date (Stream) (iOS only; Android alternative below)

Supported on both Android and iOS. Uses the Sensors API (Android & iOS) and the Recording API (Android, when Google Play Services is available).

Package: https://pub.dev/packages/pedometer_pro

Repository: https://github.com/whevether/pedometer_pro

Android data sources #

On aggressive OEM battery savers (Xiaomi / OPPO / vivo), background listeners may be killed. Use the streams in the foreground, and ask the user to disable battery optimization for the app if you need more reliable tracking.

Run the sample app:

cd example && flutter run

Android release signing for the example uses a committed test keystore (example/jks/). See example/jks/README.md. Do not use it for production.

Configuration #

Permissions #

For both Android and iOS you need to request permission to track the user's activity. I recommend using permission_handler, but you can use others if it suits you better.

How to use it #

1. Request permissions

   • Using permission_handler, you can request permission on both platforms.
   • The plugin includes openAppSettings() so the user can enable permissions if the system prompt is not shown again.

     Behavior

   • The first request shows a system dialog. Later calls return the stored answer or the current OS setting.
   • If permission is denied, show a snackbar or dialog and ask the user to update settings.

     Example:

     import 'package:permission_handler/permission_handler.dart';
     
     PermissionStatus perm =
     Platform.isAndroid ? await Permission.activityRecognition.request() : await Permission.sensors.request();
     print('perm: $perm');
     
     if (perm.isDenied || perm.isPermanentlyDenied || perm.isRestricted) {
         ScaffoldMessenger.of(context).showSnackBar(
             SnackBar(
                 content: Text(
                     'You need to approve the permissions to use the pedometer',
                     style: TextStyle(
                     color: Theme.of(context).colorScheme.onError,
                     fontWeight: FontWeight.bold,
                     ),
                 ),
                 backgroundColor: Theme.of(context).colorScheme.errorContainer,
                 action: SnackBarAction(
                     label: 'Settings',
                     textColor: Theme.of(context).colorScheme.onError,
                     onPressed: () => openAppSettings(),
                 ),
             ),
         );
     } else {
         // Call the functions you need to read stepCount
     }
     

2. Get step count

   • Request the total steps in a time range (from / to).
   • If from or to is omitted, it defaults to the maximum recorded window: 7 days on iOS, 10 days on Android.
   • If the range is longer than the platform window, the result only covers that window.

     Behavior

   • On Android, history is read from Health Connect (Samsung Health and other linked apps). The first call may show a Health Connect permission sheet.
   • play-services-fitness Local Recording is only this app's own log after subscribe, not vendor health-app history.
   • If Health Connect is missing or empty, ranges that include "now" fall back to steps since last boot.

     Example:

     import 'package:pedometer_pro/pedometer_pro.dart';
     
     DateTime now = DateTime.now();
     DateTime from = now.subtract(Duration(days: now.weekday - 1));
     DateTime to = now.add(Duration(days: DateTime.daysPerWeek - now.weekday));
     
     int steps = await Pedometer().getStepCount(from: from, to: to);
     print('steps: $steps');
     

3. Real-time step count (Stream) and steps since last boot

   • The first event is steps since last system boot. Further events stream as the user walks.
   • If the value is 0, the stream may not fire until the user takes a step.

     Behavior

   • After a reboot (or a manual date change), the value resets to 0.

     Example:

     StreamSubscription? _subStepCount;
     
     @override
     void initState() {
         super.initState();
         _listenToSteps();
     }
     
     @override
     void dispose() {
         _subStepCount?.cancel();
         super.dispose();
     }
     
     _listenToSteps() {
         _subStepCount = Pedometer().stepCountStream().listen((steps) => print('Steps: $steps'));
     }
     

4. Real-time pedestrian status: Walking, Stopped (Stream)

   • Returns stopped or walking. On error it returns unknown.

     Behavior

   • The stream may not emit until the status changes. Assume stopped at start.

     Example:

     StreamSubscription? _subPedestrianStatus;
     
     @override
     void initState() {
         super.initState();
         _listenToStatus();
     }
     
     @override
     void dispose() {
         _subPedestrianStatus?.cancel();
         super.dispose();
     }
     
     _listenToStatus() {
         _subPedestrianStatus = Pedometer().pedestrianStatusStream().listen((status) => print('Status: $status'));
     }
     

5. [iOS] Real-time step count since a date (Stream)

   • Android alternative: combine getStepCount and stepCountStream. See the example app.
   • Returns steps from from to now(), then keeps streaming.

     Behavior

   • Same as stepCountStream: first call may be 0 until the user walks.
   • iOS stores at most 7 days.

     Example:

     StreamSubscription? _subStepFrom;
     
     @override
     void initState() {
         super.initState();
         _listenToSteps();
     }
     
     @override
     void dispose() {
         _subStepFrom?.cancel();
         super.dispose();
     }
     
     _listenToSteps() {
         DateTime now = DateTime.now();
         DateTime from = now.subtract(Duration(days: now.weekday - 1));
         _subStepFrom = Pedometer().stepCountStreamFrom(from: from).listen((steps) => print('Steps: $steps'));
     }
     

Things to consider #

The APIs may be missing or behave differently on some devices:

• Some Samsung phones do not support the Sensors API.
• Older iPhones do not support Pedestrian Status.
• OEMs use different sensors and OS policies, so step totals can differ (mainly Android).
• Without Google Play Services, Android getStepCount cannot reconstruct history from before the last reboot.

If the step sensor is not available, an error is thrown. The app must handle it.

Changelog #

See CHANGELOG.md / CHANGELOG_zh.md.

Thanks and credits #

This package was originally forked from:

• Pedometer_plus by akaboshinit.dev

Which was originally forked and inspired by:

• Pedometer by cachet.dk
• Simple_pedometer by bookm.me

The example app was inspired by Purrweb Agency - Dribbble.

Package status #

Pub v.	Points	Popularity