jbh_ringtone 1.0.3
jbh_ringtone: ^1.0.3 copied to clipboard
A Flutter plugin that provides easy access to device ringtones on Android and iOS platforms. Get real ringtone names, IDs, and URIs with a simple API.
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-11 #
Added #
- Initial release of jbh_ringtone plugin
- Cross-platform support for Android and iOS
getRingtones()method to retrieve all available ringtonesgetPlatformVersion()method to get platform information- Comprehensive error handling with meaningful error messages
- Real ringtone names extraction from device
- Support for both system and custom ringtones
- Automatic permission handling for Android
- Example app with complete UI implementation
- Comprehensive test coverage
- Full API documentation
Features #
- Android Support: Full support for Android API level 21+
- iOS Support: Complete iOS compatibility
- Real Names: Extracts actual ringtone names as they appear on device
- Comprehensive Data: Provides ID, title, and URI for each ringtone
- Easy Integration: Simple API with no complex setup required
- Error Handling: Robust error handling with detailed error messages
- Lightweight: Minimal external dependencies
Technical Details #
- Uses
RingtoneManagerfor Android implementation - Implements platform interface pattern for extensibility
- Provides JSON-based data structure for easy integration
- Includes comprehensive unit tests
- Follows Flutter plugin best practices
Documentation #
- Complete README with usage examples
- API reference documentation
- Platform-specific setup instructions
- Error handling guide
- Contributing guidelines
[Unreleased] #
Planned Features #
- Ringtone playback functionality
- Ringtone preview capability
- Custom ringtone selection UI
- Ringtone categorization (system, custom, etc.)
- Volume control integration
- Background audio support
Planned Improvements #
- Enhanced error messages
- Performance optimizations
- Additional platform support
- More comprehensive testing