accurate_step_counter 1.0.0
accurate_step_counter: ^1.0.0 copied to clipboard
A highly accurate step counter plugin using accelerometer-based detection with low-pass filtering and peak detection. Supports foreground, background, and terminated state tracking.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2025-01-20 #
Added #
- ✨ Initial release of Accurate Step Counter plugin
- 📱 Accelerometer-based step detection with advanced filtering algorithms
- 🔧 Configurable sensitivity with preset modes (walking, running)
- 📊 Real-time step count event stream
- 🛡️ Comprehensive state management:
- Foreground tracking with real-time updates
- Background tracking support
- Terminated state recovery (syncs steps taken while app was closed)
- 🔒 Validated step data with safety checks:
- Maximum reasonable step count (50,000)
- Maximum step rate validation (3 steps/second)
- Device reboot detection
- Time validation
- 📱 Android native integration:
- OS-level step counter synchronization
- SharedPreferences for state persistence
- TYPE_STEP_COUNTER sensor support
- 📚 Complete documentation:
- Comprehensive README with examples
- API reference documentation
- Integration tests
- Example application
- 🎯 Core features:
- Low-pass filtering to reduce noise
- Peak detection algorithm
- Minimum time between steps validation
- Configurable threshold and filter parameters
- Battery-efficient implementation
Supported Platforms #
- ✅ Android (Full support)
- 🚧 iOS (Planned for future release)
Requirements #
- Flutter SDK: >=3.3.0
- Dart SDK: ^3.9.0
- Android: API 19+ (Android 4.4 KitKat)
Dependencies #
sensors_plus: ^6.0.1 - For accelerometer accessplugin_platform_interface: ^2.0.2 - For plugin architecture
Known Limitations #
- iOS support not yet implemented
- Requires ACTIVITY_RECOGNITION permission on Android 10+
- Background tracking may be limited by device-specific battery optimization settings
Breaking Changes #
- None (initial release)
Migration Guide #
- None (initial release)
Future Roadmap #
Planned for v1.1.0 #
- 📊 Step history tracking with daily/weekly summaries
- 🔔 Configurable step goal notifications
- 📈 Calorie estimation based on step count
- 🎨 Additional preset configurations (stairs, hiking, etc.)
Planned for v2.0.0 #
- 🍎 iOS support with CoreMotion integration
- 🔄 Cloud sync capabilities
- 📊 Advanced analytics and insights
- 🏃 Activity type detection (walking, running, cycling)
Contributing #
Found a bug or have a feature request? Please open an issue.
Want to contribute? Check out our contributing guidelines.
Version History #
- 1.0.0 (2025-01-20) - Initial release with Android support