audio_player_manager 1.0.1

audio_player_manager: ^1.0.1 copied to clipboard

🔧 Improvements & Bug Fixes #

Enhanced Cache Manager Integration

• Flutter App Cache Manager: Full integration with flutter_app_cache_manager v1.0.1
• Cache State Streaming: Added real-time cache state monitoring with AudioCacheState enum
• Cache Example Page: New comprehensive example demonstrating cache manager setup and usage
• Cache Configuration: Improved cache configuration options and validation

Exception Handling Enhancements

• Comprehensive Exception System: Extended exception hierarchy with specific error types
• Error Code Support: Added error codes for better debugging and error categorization
• Stack Trace Preservation: Improved error handling with proper stack trace preservation using Error.throwWithStackTrace
• Exception Utilities: Added AudioPlayerExceptions utility class for common exception creation

Factory Pattern Improvements

• Enhanced Factory Methods: Improved AudioPlayerFactory with better initialization patterns
• Service Integration: Better separation of concerns with dedicated service initialization methods
• Player Type Selection: Enhanced player type detection and recommendation system
• Validation Results: Added comprehensive validation system with detailed error reporting

Audio Utilities Expansion

• Enhanced Audio Format Detection: Improved format detection from URLs and file paths
• Bitrate Calculations: Added utilities for bitrate estimation and file size calculations
• Volume Utilities: Enhanced volume normalization and decibel conversion functions
• Fade Effects: Added fade in/out calculation utilities for smooth audio transitions

Developer Experience

• Better Documentation: Enhanced inline documentation and code comments
• Type Safety: Improved type safety throughout the codebase
• Error Messages: More descriptive error messages for easier debugging
• Example Improvements: Enhanced example app with cache integration demonstration

Dependencies

• flutter_app_cache_manager: Updated to v1.0.1 for advanced caching capabilities
• flutter_shared_utilities: Updated to v1.0.5 for enhanced utility functions
• audioplayers: Updated to v6.5.0 for better stability
• just_audio: Updated to v0.10.4 for improved performance

🎉 Initial Release #

Core Features

• Abstract Audio Player Interface: Comprehensive interface for audio playback operations
• Multiple Player Support: Factory pattern supporting just_audio and audioplayers
• Audio Player Enums: Complete set of enums for audio states, formats, and configurations
• Exception Handling: Comprehensive exception system with specific error types

Data Models

• AudioTrack: Complete audio track model with metadata support
• Playlist: Full playlist management with track operations
• PlaybackState: Detailed playback state tracking
• AudioMetadata: Comprehensive audio metadata handling
• AudioPlayerConfig: Flexible configuration system

Services

• AudioSessionService: Audio session and interruption management
• CacheService: Intelligent audio caching with LRU eviction
• MetadataService: Audio metadata extraction and management
• NotificationService: Rich media notifications with custom actions
• PlaylistService: Complete playlist CRUD operations with import/export

Utilities

• AudioUtils: Audio validation, format detection, and calculations
• AudioPlayerFactory: Smart factory with auto-selection and feature detection

Advanced Features

• Background playback support
• Crossfade transitions
• Gapless playback
• Variable speed playback
• Audio effects and equalizer support
• Multiple audio format support (MP3, AAC, FLAC, WAV, OGG, etc.)
• Streaming and local file support
• Audio focus management
• Media controls integration

Architecture

• Clean Architecture principles
• Dependency inversion with abstract interfaces
• Safe data parsing with BaseDataModel integration
• Comprehensive error handling
• Event-driven architecture with streams

Developer Experience

• Type-safe API design
• Comprehensive documentation
• Example usage patterns
• Validation utilities
• Factory patterns for easy instantiation