holy_beacon_sdk 0.1.0
holy_beacon_sdk: ^0.1.0 copied to clipboard
A comprehensive Flutter SDK for scanning and detecting iBeacon and Eddystone beacons with Holy devices prioritization. Designed for integration into larger systems with robust UUID processing capabilities.
0.1.0 #
โจ Initial Release - Core UUID Processor #
Features:
- ๐ง Core UUID Processor: Single and batch UUID processing with validation
- ๐ฏ Holy Device Detection: Intelligent categorization (Shun, Jin, Kronos)
- ๐ Trust Level System: Confidence scoring for device authenticity
- ๐ Format Conversion: Bytes to UUID, normalization, validation
- ๐ก๏ธ Error Handling: Comprehensive error types and messages
- ๐งช 100+ Tests: Complete test coverage for reliability
- ๐ BLE Scanning: Real-time iBeacon and Eddystone detection
- ๐ Holy Devices Prioritization: Automatic filtering and ranking
- ๐ฑ Cross-platform: Android & iOS support
- ๐ Permission Management: Automatic BLE/location permissions
Core Components:
UuidProcessor: Heart of the system - processes UUIDs with intelligenceHolyBeaconScanner: BLE scanning service with Holy device priorityBeaconDevicemodels: Comprehensive beacon data structures- Error handling with specific types and recovery suggestions
Integration Ready:
- Designed for larger systems as independent module
- Consistent API across all components
- Performance optimized for batch processing
- Memory efficient with minimal footprint
1.0.0 #
โจ Previous Release #
Features:
- ๐ Complete BLE beacon scanning for iBeacon and Eddystone protocols
- ๐ Holy devices prioritization system
- ๐ฏ Advanced filtering with configurable whitelists
- ๐ฑ Cross-platform support (Android & iOS)
- ๐ Automatic permission management
- ๐ ๏ธ Easy integration with simple API
- ๐ Real-time reactive streams for UI updates
- ๐ Detailed scanning statistics and metrics
Platforms:
- โ Android 5.0+ (API 21+)
- โ iOS 12.0+
Holy Device Support:
- Holy-Shun (FDA50693-A4E2-4FB1-AFCF-C6EB07647825)
- Holy-IOT Jin (E2C56DB5-DFFB-48D2-B060-D0F5A7100000)
- Kronos Blaze BLE (F7826DA6-4FA2-4E98-8024-BC5B71E0893E)
API Highlights:
HolyBeaconScanner- Main scanner serviceBeaconDevice- Comprehensive device modelBeaconScanConfig- Flexible scanning configurationBeaconWhitelist- Advanced filtering systemPermissionManager- Cross-platform permission handlingBeaconUtils- Utility functions for beacon operations
Example Integration:
final scanner = HolyBeaconScanner();
await scanner.initialize(config: BeaconScanConfig.holyOptimized());
scanner.devices.listen((devices) => updateUI(devices));
await scanner.startScanning();
Dependencies:
- flutter_reactive_ble: ^5.4.0
- permission_handler: ^11.4.0
Documentation:
- Complete API documentation
- Integration examples for Android & iOS
- Best practices guide
- Troubleshooting section