NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #199 most downloaded on pub.dev
iOS and macOS implementation of the video_player plugin.
Latest stable
2.12.4
Last release 9 days ago
13 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
71 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Converts FVPVideoEventListener and the FVPEventBridge implementation from Obj-C to Swift, and now that it uses Swift, adopts Pigeon's Swift event chan
Converts FVPVideoEventListener and the FVPEventBridge implementation from Obj-C to Swift, and now that it uses Swift, adopts Pigeon's Swift event channel support to eliminate the use of stringly-typed data.
The overhauled Dart unit test code is taken directly from the rewrite that I did previously for video_player_android's Kotlin Pigeon event channel conversion, with minimal changes to match the iOS test cases.
Also includes a minor adjustment to video_player_android to add missing unregistration code to avoid a minor native object leak, matching changes made on the iOS side during review. This requires a Pigeon update to pick up the functionality needed to unregister.
Part of flutter/flutter#119105
[video_player] Fix crash regression with async calls on iOS/macOS ( #1 …
Your coding agent can read these notes before it upgrades. Set up the MCP server →
[video_player] Fix crash regression with async calls on iOS/macOS (#1…
…as the AV* class wrappers, in order to replace deprecated methods with newer, Swift-friendlier alternatives. As part of the conversion, adopts Swift P…
Converts VideoPlayer and TextureBasedVideoPlayer to Swift. Also converts AVAssetTrackUtils since it simplifies calling from Swift, and that's a very simple conversion, as well as the AV* class wrappers, in order to replace deprecated methods with newer, Swift-friendlier alternatives. As part of the conversion, adopts Swift Pigeon for the instance-level APIs, so that all of the Pigeon generation in Swift-based (and combines the Pigeon definition files now that they can share a single config). Also adopts Pigeon's new async support to make handling async code simpler, so does require some test changes for the API surface change.
Intentionally left to later PRs, to limit scope:
video_player_avfoundation_objc subtarget (although these should be relatively simple)video_player_avfoundation_ios and video_player_avfoundation_macosAs part of the conversion, the minimum Flutter version has been changed to 3.47, which allows dropping versions of iOS and macOS that are no longer supported in 3.47, and thus avoiding the need to convert legacy codepaths that only existing for those no-longer-supported versions.
Updates CI's iOS version to target for deprecation checks to iOS 15, rather than 14, to allow using things that require iOS 15 without failing that check (which overrides the deployment version, but is intended to raise it, not lower it).
Also replaces a number of methods that are deprecated in iOS 16, but for which the replacements were added in iOS 15.
Part of flutter/flutter#119105
[video_player] Fix crash when videoTrack has zero-duration minFrameDu…
[video_player] Fix crash when videoTrack has zero-duration minFrameDu…
minFrameDuration.usesExternalPlaybackWhileExternalScreenIsActive defaults to NO, so an AVPlayer keeps the picture on the device whenever an external screen is active.
usesExternalPlaybackWhileExternalScreenIsActive defaults to NO, so an AVPlayer keeps the picture on the device whenever an external screen is active. Selecting an AirPlay route therefore moved only the audio, while the receiver showed a mirrored copy of the screen rather than playing the stream itself.
allowsExternalPlayback already defaults to YES, so the two together were incoherent: external playback was permitted but never used. AVKit's own AVPlayerViewController routes to AirPlay out of the box; this brings the plugin in line with it.
Verified on an Apple TV from iOS 26.6.
Fixes: flutter/flutter#191227
Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.
usesExternalPlaybackWhileExternalScreenIsActive on the AVPlayer. Selecting
an AirPlay route previously moved only the audio, leaving the video on the
device while the receiver showed a mirrored screen.Updates pigeon dev_dependency constraint to ^27.3.2 across first-party packages to ensure compatibility with analyzer: ^14.0.0 during pub downgrade re
Updates pigeon dev_dependency constraint to ^27.3.2 across first-party packages to ensure compatibility with analyzer: ^14.0.0 during pub downgrade resolution.
test dev_dependencies from plugin packages that already depend on flutter_test.pigeon constraint to ^27.3.2 across all 36 first-party plugin packages.in_app_purchase_storekit to rename SK2ProductMessage.description to localizedDescription for Swift Pigeon 27.0+ compatibility.CHANGELOG.md files.Implements setPreventsDisplaySleepDuringVideoPlayback using AVPlayer.preventsDisplaySleepDuringVideoPlayback.
setPreventsDisplaySleepDuringVideoPlayback using
AVPlayer.preventsDisplaySleepDuringVideoPlayback.Implements getVideoTracks() and selectVideoTrack() methods for video track (quality) selection using AVFoundation.
getVideoTracks() and selectVideoTrack() methods for video track (quality) selection using AVFoundation.Forces tone-mapping to SDR on iOS to prevent washed-out HDR video playback.
Adds a Swift version to fix a potential build issue when using CocoaPods.
Converts portions of the native code to Swift for improved maintainability.
Ensures that the display link does not continue requesting frames after a player is disposed.
Fixes a regression where HTTP headers were ignored.
Refactors for improved testability.
Refactors native code for improved testability.
Implements getAudioTracks() and selectAudioTrack() methods.
getAudioTracks() and selectAudioTrack() methods.Improves compatibility with UIScene.
UIScene.Resolve tracksWithMediaType: deprecations.
tracksWithMediaType: deprecations.loadTracksWithMediaType:completionHandler: for iOS 15.0+/macOS 12.0+.Refactors Dart internals for maintainability.
* Updates to Pigeon 26.
Fixes a bug where the video player fails to initialize when AVFoundation reports a duration of zero.
AVFoundation reports a duration of zero.VideoProgressIndicator widget in the example app to handle zero-duration videos.Updates minimum supported version to iOS 13 and macOS 10.15.
* Simplifies native code.
Removes calls to self from init and dealloc, for maintainability.
Restructure internals of Dart notification of video player events.
Restructures internal logic to move more code to Dart.
Adds platform view support for macOS.
Restructures the communication between Dart and native code.
Uses CADisplayLink on macOS 14.0+.
CADisplayLink on macOS 14.0+.Adds possibility to play videos at more than 30 FPS.
Adds support for platform views as an optional way of displaying a video.
Fixes playback speed resetting.
Fixes changing global audio session category to be collision free across plugins.
Bugfix to allow the audio-only HLS (.m3u8) on iOS.
Refactors native code structure.
Fixes VideoPlayerController.initialize() future never resolving with invalid video file.
Updates Pigeon for non-nullable collection type support.
Adds files to make include directory permanent.
Adds Swift Package Manager compatibility.
Adds frame availability checks on iOS.
* Adds privacy manifest.
Fixes display of initial frame when paused.
* Fixes new lint warnings.
Publishes an instance of the plugin to the registrar on macOS, as on iOS.
Fixes flickering and seek-while-paused on macOS.
* Updates to Pigeon 13.
* Adds support for macOS.
Changes Objective-C class prefixes to avoid future collisions.
Adds pub topics to package metadata.
Fixes the iOS crash when using multiple players on the same screen. See: https://github.com/flutter/flutter/issues/124937
Fixes missing isPlaybackLikelyToKeepUp check for iOS video player bufferingEnd event and bufferingStart event.
isPlaybackLikelyToKeepUp check for iOS video player bufferingEnd event and bufferingStart event.Updates minimum supported SDK version to Flutter 3.3/Dart 2.18.
Fixes hang when seeking to end of video.
Updates functions without a prototype to avoid deprecation warning.
Updates pigeon to fix warnings with clang 15.
Synchronizes VideoPlayerValue.isPlaying with AVPlayer.
VideoPlayerValue.isPlaying with AVPlayer.Makes seekTo async and only complete when AVPlayer.seekTo completes.
Clarifies explanation of endorsement in README.
Updates minimum Flutter version to 3.3 and iOS 11.
Updates links for the merge of flutter/plugins into flutter/packages.
One column per quarter.