widget_recorder_plus 1.0.0

widget_recorder_plus: ^1.0.0 copied to clipboard

✨ Initial Release #

Features

• 🎥 Record any Flutter widget as MP4 video
• ⚡ Simple 3-line API integration
• 🎯 Configurable FPS (15-60, default 60)
• 📱 Cross-platform support (Android API 21+, iOS 13+)
• 🔧 Automatic file path management
• 💾 Built-in success and error callbacks
• 🎬 High-quality H.264 encoding (10 Mbps/megapixel)

Android Implementation

• Uses MediaCodec for hardware-accelerated H.264 encoding
• Proper YUV420 color space conversion with 2x2 subsampling
• Handles hardware stride/padding requirements via Image API
• Synchronous file finalization with CountDownLatch
• Robust error handling and resource cleanup
• Supports devices with MediaTek, Qualcomm, and other encoders

iOS Implementation

• Uses AVAssetWriter for native video encoding
• H.264 codec with high profile level
• CABAC entropy mode for better compression
• Proper RGBA to BGRA conversion
• Synchronous finalization with DispatchSemaphore
• Supports iOS 13.0+

Dart Layer

• RepaintBoundary-based frame capture
• Automatic dimension rounding to multiples of 16 (H.264 macroblock requirement)
• 2x pixel ratio capture for better quality
• Proper image resizing to match encoded dimensions
• Smooth frame timing and synchronization

Quality Improvements

• High bitrate encoding (10 Mbps per megapixel)
• 60 FPS default for smooth animations
• Proper YUV420 conversion with correct color coefficients
• Stride-aware buffer handling
• No distortion or color artifacts

Fixes

• ✅ Fixed array index out of bounds crash
• ✅ Fixed video distortion from stride mismatch
• ✅ Fixed "unsupported media" error for long videos
• ✅ Fixed incomplete file finalization
• ✅ Fixed color space conversion issues
• ✅ Fixed frame timing and synchronization

Documentation

• Comprehensive README with examples
• API reference documentation
• Troubleshooting guide
• Performance tips
• Platform-specific setup instructions
• App Store compliance notes

Example App

• Complete working example with UI
• Animation recording demo
• Error handling demonstration
• Video playback integration

Version 1.0.0 - Production Ready