🔧 Enhancements #

• Android 16K Page Size Support: Updated flutter_vlc_player to v7.4.4 to support Android 16KB page size
• Dependencies: Updated flutter_vlc_player from 7.4.3 to 7.4.4 for improved Android compatibility

🐛 Bug Fixes #

• Web Platform Support: Fixed audio playback on web platform by using UrlSource directly instead of cached file paths
• Cross-Platform Compatibility: Improved audio source handling to work correctly across all supported platforms

🔧 Enhancements #

• Platform Detection: Enhanced audio source creation logic with proper web platform detection
• Error Handling: Improved error handling in audio source creation process

🔧 Enhancements #

• Voice Visualizer Touch Handling: Completely redesigned touch interaction system for the voice visualizer
• Hidden Native Slider: Implemented hidden Flutter Slider behind visualizer bars for superior touch handling
• Improved Gesture Recognition: Replaced manual gesture detection with native Flutter slider behavior
• Better Seek Performance: Enhanced seeking accuracy and responsiveness using platform-optimized gestures
• Accessibility Support: Inherited native slider accessibility features for better screen reader support
• Smoother UX: Users now experience familiar Flutter slider behavior while maintaining custom visualizer appearance

🐛 Bug Fixes #

• Touch Precision: Fixed touch precision issues in voice visualizer seeking
• Gesture Conflicts: Resolved gesture detection conflicts and edge cases
• Performance: Eliminated manual position calculations that could cause lag

📱 User Experience #

• Native Feel: Voice visualizer now behaves exactly like standard Flutter sliders
• Visual Consistency: Maintained beautiful waveform visualization while improving functionality
• Touch Responsiveness: Significantly improved touch responsiveness and accuracy

Refactor: Extract audio, VLC, and cache services

This commit introduces three new service classes to improve the organization and maintainability of audio-related functionalities:

• VoiceAudioService: Manages standard audio playback using audioplayers.
• VoiceVlcService: Handles VLC-specific playback, particularly for WebM/Opus files on iOS.
• VoiceCacheService: Manages caching of audio files using flutter_cache_manager.

This refactoring separates concerns, making the codebase cleaner and easier to understand.

🚨 Breaking Changes #

• Configuration Classes: Reorganized parameters into configuration classes for better maintainability
• Parameter Migration: Individual styling parameters replaced with organized config objects
• API Changes: Old individual parameters are no longer supported (see migration guide in README)

✨ New Features #

• VoiceColorConfig: Centralized color management for active/inactive states
• VoiceContainerConfig: Container styling with background, padding, border radius
• VoiceTextConfig: Text styling with Flutter TextTheme support
• VoiceButtonConfig: Complete button appearance and behavior control
• VoiceSpeedConfig: Speed control button customization
• VoiceAvatarConfig: User avatar and mic icon configuration
• VoiceVisualizerConfig: Comprehensive visualizer appearance and behavior settings
• User Avatar Support: Display user profile images with listen status indicators
• Listen Status Tracking: Automatic visual indicators for played/unplayed messages
• Simple Play Icons: Choice between circular background or simple icon styles
• Icon Size Control: Independent sizing for simple icons and avatar elements
• Timer Theme Support: Integration with Flutter's TextTheme for consistent styling

🔧 Enhancements #

• Improved Code Organization: Better parameter grouping and class structure
• Enhanced State Management: More robust state tracking during seek operations
• Better Error Handling: Improved error handling for seek and playback operations
• Visualizer Gestures: Enhanced gesture handling for smoother interactions
• Seek Stability: Added delay after seek operations for better reliability
• Memory Management: Optimized resource cleanup and disposal
• Performance: Better state updates and reduced unnecessary rebuilds

🐛 Bug Fixes #

• Seek Behavior: Correctly preserves playing state across seek operations
• State Synchronization: Better state management during slider and visualizer interactions
• Icon Rendering: Fixed icon sizing issues in different configurations
• Animation Timing: Improved animation stability during state transitions

📖 Documentation #

• Migration Guide: Comprehensive guide for upgrading from v3.0.x
• Configuration Examples: Detailed examples for all configuration classes
• API Reference: Updated documentation with new class structures
• Usage Examples: Enhanced examples showing different customization approaches

🔄 Migration Notes #

See the migration section in README.md for detailed upgrade instructions from v3.0.x to v3.1.0.

🔧 Enhancements #

• Smart Seek Functionality: Improved seek behavior that preserves playback state
• Auto-Resume: When seeking while playing, audio automatically resumes from new position
• Pause Preservation: When seeking while paused, audio remains paused at new position
• User Experience: Eliminated need for manual resume after seeking operations

🚨 Breaking Changes #

• Audio Engine: Migrated from just_audio to audioplayers package for better stability
• API Changes: Some method signatures updated for consistency

✨ New Features #

• VoiceStateModel: Comprehensive state management system
• Enhanced Error Handling: Robust error handling and recovery mechanisms
• Stream Management: Improved audio stream handling and cleanup
• VLC Support: Maintained VLC player support for iOS WebM files
• Speed Controls: Enhanced playback speed controls with cleaner API
• Animation System: Improved UI responsiveness and smooth animations

🔧 Enhancements #

• Performance: Significant performance improvements and optimization
• Memory Management: Better resource cleanup and memory usage
• Code Structure: Improved code organization and maintainability
• Documentation: Enhanced documentation and utility methods
• Deprecation Fixes: Removed deprecated withOpacity usage

🐛 Bug Fixes #

• State Consistency: Fixed various state synchronization issues
• Resource Leaks: Resolved memory leaks in audio player cleanup
• Platform Compatibility: Enhanced cross-platform compatibility

🔧 Enhancements #

• Dependencies: Updated all package dependencies to latest versions
• Compatibility: Improved compatibility with latest Flutter SDK versions

🔧 Enhancements #

• Dependencies: Updated package dependencies for better stability
• Performance: Minor performance optimizations

✨ New Features #

• Audio Waveforms: Added flutter_audio_waveforms integration
• Visual Enhancement: Improved audio visualization capabilities

🔧 Enhancements #

• Dependencies: Upgraded core packages to latest stable versions
• Compatibility: Enhanced Flutter version compatibility

🐛 Bug Fixes #

• Slider Issues: Fixed various slider interaction and rendering issues
• UI Consistency: Improved UI consistency across different platforms

🔧 Enhancements #

• Package Updates: Upgraded dependencies for better performance and security

🚨 Breaking Changes #

• Flutter Support: Updated minimum Flutter version to 3.22
• Dart Requirements: Updated Dart SDK requirements

🔧 Enhancements #

• Compatibility: Full compatibility with Flutter 3.22 and latest features
• Performance: Leveraged new Flutter optimizations for better performance

🚨 Breaking Changes #

• Dart 3 Support: Updated to support Dart 3 with null safety improvements
• API Stability: Marked API as stable with semantic versioning

🔧 Enhancements #

• Type Safety: Enhanced type safety with Dart 3 features
• Performance: Improved performance with latest Dart optimizations

✨ New Features #

• Internationalization: Full localization support with multiple languages
• Accessibility: Enhanced accessibility features for screen readers
• RTL Support: Right-to-left language support

✨ New Features #

• Web Support: Added comprehensive web platform support
• Cross-Platform: Enhanced cross-platform compatibility

🔧 Enhancements #

• V Chat Utils: Updated v_chat_utils dependency to v0.0.3
• Web Optimization: Optimized performance for web platforms

🔧 Enhancements #

• Dependencies: Updated v_chat_utils to version 0.0.3
• Stability: Improved overall package stability

🎉 Initial Release #

• Basic Playback: Core audio playback functionality
• Simple UI: Basic voice message player interface
• Flutter Integration: Initial Flutter package implementation

Legend #

• 🚨 Breaking Changes: Changes that require code modifications
• ✨ New Features: New functionality and capabilities
• 🔧 Enhancements: Improvements to existing features
• 🐛 Bug Fixes: Fixed issues and problems
• 📖 Documentation: Documentation improvements
• 🔄 Migration Notes: Information for upgrading versions