NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #4806 most downloaded on pub.dev
Native video player (AVPlayer on iOS, ExoPlayer on Android) with HLS, DRM, Chromecast & AirPlay casting, Picture-in-Picture, background playback, and fullscreen.
Latest stable
1.8.1
Last release 4 days ago
09 Nov 2026
Release timing varies
gaps range from 9 days to 4 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
85 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
State Restoration After Exiting PiP: Fixed issue where player state would not be properly restored after exiting Picture-in-Picture mode
emitCurrentState() method on both iOS and Android to re-emit all player states after PiP exitNativeVideoPlayerController
Code Quality (Android): Enhanced import organization in VideoPlayerMethodHandler
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Enhanced Initialization Handling: Improved controller initialization with better state tracking
Enhanced Initialization Handling: Improved controller initialization with better state tracking
_isInitialized and _isInitializing flags to prevent duplicate initializationisInitialized getter to check initialization status programmaticallyImmediate State Emission for New Listeners: Event listeners now receive current state immediately upon registration
Duration Persistence During AirPlay: Fixed duration being lost during AirPlay transitions
Unified Event Name Handling: Added support for both 'timeUpdate' and 'timeUpdated' event names
Buffering State Debounce: Added 400ms debounce to buffering state changes to prevent UI flicker
debugPrint statements from the package
releaseResources()
_overlayBuilder is now preserved across releaseResources() calls_state, _url) for quick resumptiondispose(), not on temporary releaseResources()Continuous Buffering State Reporting: Buffering state is now always reported in real-time
isBuffering boolean to timeUpdate events (sent every 500ms)player.playbackState == Player.STATE_BUFFERINGplayer.timeControlStatus == .waitingToPlayAtSpecifiedRatePlayerActivityState.buffering when buffering startsqualitiesCache storage to SharedPlayerManager on both iOS and AndroidreleaseResources() and re-initializingBuffering Not Visible During Playback: Fixed issue where video would buffer while in play state without indicating buffering status
Missing Qualities After Navigation: Fixed issue where video qualities would disappear after navigating away and back
SharedPlayerManager which survives view recreationgetAvailableQualities() automatically restores from cache when view instance is emptyOverlay Lock Feature: Added ability to lock custom overlay to always be visible
lockOverlay() method to keep overlay permanently visibleunlockOverlay() method to restore normal tap-to-hide behaviorisOverlayLocked getter to check current lock stateisOverlayLockedStream for reactive lock state updates_state.isAirplayConnected when receiving airPlayConnectionChanged eventsisAirplayConnectedStream emits correctly when connection state changesAutomatic Overlay Management for PiP: Custom overlays now automatically hide when entering PiP and show when exiting PiP on Android
Enhanced Picture-in-Picture Transitions (Android): Major improvements to PiP mode behavior
wasFullscreenBeforePip tracking to restore correct state after PiPShared Player Surface Reconnection: Enhanced surface handling for shared players
releaseResources() is calledPiP Availability Detection: Improved activity context handling for PiP feature detection
getActivity() helper method to properly unwrap ContextWrapper instancesCustom Overlay in PiP Window: Fixed issue where custom overlays would appear in the PiP window on Android
Fullscreen State After PiP: Fixed incorrect fullscreen state restoration after exiting PiP
Progress Bar Seek Jump: Fixed issue where progress bar would jump back briefly after seeking
_targetSeekPosition to track where we're seeking toQuality List Stream: Added qualitiesStream to track changes in available video qualities
Quality List Stream: Added qualitiesStream to track changes in available video qualities
List<NativeVideoPlayerQuality> whenever quality list changescustom_video_overlay.dart demonstrates reactive quality selector updatesAutomatic Orientation Restoration: Enhanced FullscreenManager with intelligent orientation tracking
setPreferredOrientations() helper method as optional drop-in replacement for SystemChrome.setPreferredOrientations()preferredOrientations parameter to NativeVideoPlayerController for easy orientation configurationTap-to-Hide Overlay: Enhanced custom overlay interaction
HitTestBehavior.deferToChild for proper gesture handling_isDisposed flag to prevent state updates after disposalisClosed checks before adding events to all stream controllersbufferedPositionController, durationController, playerStateController, positionController, speedController, isPipEnabledController, isPipAvailableController, isAirplayAvailableController, isAirplayConnectedController, isFullscreenController, qualityChangedController, and qualitiesControllerbufferedPositionStream for reactive buffer position updatesqualitiesStream for reactive quality list updatesdart:async import for StreamSubscription supportNativeVideoPlayerController documentation with preferredOrientations usage examplesFullscreenManager documentation explaining automatic orientation trackingHDR Control: Added enableHDR parameter to NativeVideoPlayerController
HDR Control: Added enableHDR parameter to NativeVideoPlayerController
false to prevent washed-out/too-white video appearance on HDR contenttrue to enable HDR playback when desiredAirPlay Connection State Tracking: Enhanced AirPlay monitoring with connection state
isAirplayConnected property to NativeVideoPlayerStateisAirplayConnected getter to NativeVideoPlayerControllerisAirplayConnectedStream for real-time connection state updatesPlayerControlState events: airPlayConnected and airPlayDisconnectedConvenience State Getters: Added direct property access to controller state
speed - Current playback speedisPipEnabled - Current Picture-in-Picture stateisPipAvailable - PiP device availabilityisAirplayAvailable - AirPlay device availabilityisAirplayConnected - Active AirPlay connection stateNativeVideoPlayerState model with isAirplayConnected propertyIndividual Property Streams: Added dedicated broadcast streams for convenient property monitoring
Individual Property Streams: Added dedicated broadcast streams for convenient property monitoring
bufferedPositionStream - Stream of buffered position changesdurationStream - Stream of duration changesplayerStateStream - Stream of player state changes (playing, paused, buffering, etc.)positionStream - Stream of playback position changesspeedStream - Stream of playback speed changesisPipEnabledStream - Stream of Picture-in-Picture state changesisPipAvailableStream - Stream of Picture-in-Picture availability changesisAirplayAvailableStream - Stream of AirPlay availability changesisFullscreenStream - Stream of fullscreen state changesqualityChangedStream - Stream of quality changesToggle Picture-in-Picture: Added togglePictureInPicture() method for easy PiP toggling
bool indicating success/failure of the operationtoggleFullScreen() for consistencyEnhanced State Model: Extended NativeVideoPlayerState with new properties
speed property to track playback speedisPipEnabled property to track current PiP stateisPipAvailable property to track PiP device availabilityisAirplayAvailable property to track AirPlay device availabilitycopyWith(), operator==, and hashCode to include new propertiesImproved Event Handling: Enhanced event processing to update state properties
togglePictureInPicture() usage examplesaddActivityListener, addControlListener) continue to work as beforedispose() method to prevent memory leaksEnhanced Player Disposal and Cleanup: Improved SharedPlayerManager on both iOS and Android platforms
stopAllViewsForController() method to properly stop playback and clear player from all views when disposingNativeVideoPlayerControllerCritical Controller Disposal Bug: Fixed incomplete resource cleanup in NativeVideoPlayerController.dispose() method
Critical Controller Disposal Bug: Fixed incomplete resource cleanup in NativeVideoPlayerController.dispose() method
Android Player Reinitialization Issue: Fixed critical bug where Android players could not be reinitialized after disposal
VideoPlayerMethodHandler.handleDispose() to properly remove player from SharedPlayerManagercontrollerId parameter to VideoPlayerMethodHandler constructorVideoPlayerMethodChannel with new dispose() method that calls native platform disposaldispose() to call native cleanup via method channeldispose() method documentation to reflect proper disposal of both Flutter and native platform resourcesAndroid Media Info Management: Refactored VideoPlayerNotificationHandler and VideoPlayerObserver for improved media information management
iOS Automatic Picture-in-Picture for Shared Controllers: Fixed critical issue where automatic PiP would not work correctly when multiple views share t
isPrimaryView() and getPrimaryViewId() methods to prevent observer conflictsFixed Dart formatting issues in native_video_player_controller.dart and fullscreen_manager.dart to comply with pub.dev static analysis requirements
native_video_player_controller.dart and fullscreen_manager.dart to comply with pub.dev static analysis requirementsWASM compatibility: Package now supports Web Assembly (WASM) runtime
dart:io only on native platformsPlatformUtils class for platform detection without direct dart:io dependencyPlatformUtils for users who need platform-agnostic codePlatform checks with PlatformUtils in fullscreen manager and controllerUpdated iOS podspec version to match package version (0.2.1)
AirPlay Support (iOS): Complete AirPlay integration for streaming to Apple TV and AirPlay-enabled devices
AirPlay Support (iOS): Complete AirPlay integration for streaming to Apple TV and AirPlay-enabled devices
isAirPlayAvailable() method to check for available AirPlay devicesshowAirPlayPicker() method to display native AirPlay device pickeraddAirPlayAvailabilityListener() to monitor when AirPlay devices become available/unavailableaddAirPlayConnectionListener() to track AirPlay connection state changesCustom Overlay Controls: Build your own video player UI on top of the native player
overlayBuilder parameter in NativeVideoPlayer widgetexample/lib/widgets/custom_video_overlay.dart with:
Dart-side Fullscreen Management: New FullscreenManager class for Flutter-based fullscreen
FullscreenVideoPlayer widget for fullscreen video playback in a Flutter overlayenterFullscreen() and exitFullscreen() methodsBuffered Position Tracking: Real-time buffered position updates
bufferedPosition property in controllertimeUpdated control eventsvideo_with_overlay_screen.dart demonstrating custom controlsFixed Dart SDK constraint to use proper version range (>=3.9.0 <4.0.0) instead of exact version, allowing compatibility with all Dart 3.9.x and 3.x ve
Fixed fullscreen exit handling on iOS when user dismisses by swiping down or tapping Done button
videoLoaded to loaded across all platforms for consistencyisFullscreen dataFixed iOS player state tracking by observing timeControlStatus instead of relying only on item observers
timeControlStatus instead of relying only on item observersFixed Android package name to match plugin name (com.huddlecommunity.better_native_video_player)
Updated Flutter SDK constraint to 3.9.2
Initial release of native_video_player plugin
One column per month.