# video_player_avfoundation 2.12.1 iOS and macOS implementation of the video_player plugin. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com flutter pub add 'video_player_avfoundation:2.12.1' ``` Published: 2026-10-08T22:22:45.177749Z Expected archive SHA-256: 4f8a845173377ab250a50f9b9dfe4a43500cc76a7c49dd8410d02d8fc29dfd8b Available in cache; verification: upstream_checksum ## Direct dependencies - flutter: map[sdk:flutter] - meta: ^1.10.0 - video_player_platform_interface: ^6.8.0 ## Package README (untrusted upstream documentation) # video\_player\_avfoundation The iOS and macOS implementation of [`video_player`][1]. ## Usage This package is [endorsed][2], which means you can simply use `video_player` normally. This package will be automatically included in your app when you do, so you do not need to add it to your `pubspec.yaml`. However, if you `import` this package to use any of its APIs directly, you should add it to your `pubspec.yaml` as usual. [1]: https://pub.dev/packages/video_player [2]: https://flutter.dev/to/endorsed-federated-plugin ## Changelog ## 2.12.1 * Fixes a crash when a video track reports a zero `minFrameDuration`. * Updates minimum supported SDK version to Flutter 3.41/Dart 3.11. ## 2.12.0 * Routes video over AirPlay when an external screen is active, by setting `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. ## 2.11.1 * Updates pigeon dev_dependency to ^27.3.2 for analyzer 14 compatibility. ## 2.11.0 * Implements `setPreventsDisplaySleepDuringVideoPlayback` using `AVPlayer.preventsDisplaySleepDuringVideoPlayback`. ## 2.10.0 * Implements `getVideoTracks()` and `selectVideoTrack()` methods for video track (quality) selection using AVFoundation. * Video track selection requires iOS 15+ / macOS 12+ for HLS streams. ## 2.9.7 * Forces tone-mapping to SDR on iOS to prevent washed-out HDR video playback. ## 2.9.6 * Adds a Swift version to fix a potential build issue when using CocoaPods. ## 2.9.5 * Converts portions of the native code to Swift for improved maintainability. ## 2.9.4 * Ensures that the display link does not continue requesting frames after a player is disposed. ## 2.9.3 * Fixes a regression where HTTP headers were ignored. ## 2.9.2 * Refactors for improved testability. ## 2.9.1 * Refactors native code for improved testability. ## 2.9.0 * Implements `getAudioTracks()` and `selectAudioTrack()` methods. * Updates minimum supported SDK version to Flutter 3.29/Dart 3.7. ## 2.8.10 * Improves compatibility with `UIScene`. * Updates minimum supported SDK version to Flutter 3.38/Dart 3.10. ## 2.8.9 * Resolve `tracksWithMediaType:` deprecations. * Use `loadTracksWithMediaType:completionHandler:` for iOS 15.0+/macOS 12.0+. ## 2.8.8 * Refactors Dart internals for maintainability. ## 2.8.7 * Updates to Pigeon 26. ## 2.8.6 * Fixes a bug where the video player fails to initialize when `AVFoundation` reports a duration of zero. * Fixes a bug in the example app that some widgets stop updating after GlobalKey reparenting. * Updates the `VideoProgressIndicator` widget in the example app to handle zero-duration videos. ## 2.8.5 * Updates minimum supported version to iOS 13 and macOS 10.15. * Updates minimum supported SDK version to Flutter 3.35/Dart 3.9. ## 2.8.4 * Simplifies native code. ## 2.8.3 * Removes calls to self from init and dealloc, for maintainability. ## 2.8.2 * Restructure internals of Dart notification of video player events. ## 2.8.1 * Restructures internal logic to move more code to Dart. ## 2.8.0 * Adds platform view support for macOS. ## 2.7.3 * Restructures the communication between Dart and native code. ## 2.7.2 * Uses `CADisplayLink` on macOS 14.0+. * Updates minimum supported SDK version to Flutter 3.27/Dart 3.6. * Refactors native code for improved testing. ## 2.7.1 * Adds possibility to play videos at more than 30 FPS. * Fixes playing state not updating in some paths. ## 2.7.0 * Adds support for platform views as an optional way of displaying a video. ## 2.6.7 * Fixes playback speed resetting. ## 2.6.6 * Fixes changing global audio session category to be collision free across plugins. * Updates minimum supported SDK version to Flutter 3.22/Dart 3.4. ## 2.6.5 * Bugfix to allow the audio-only HLS (.m3u8) on iOS. ## 2.6.4 * Refactors native code structure. ## 2.6.3 * Fixes VideoPlayerController.initialize() future never resolving with invalid video file. * Adds more details to the error message returned by VideoPlayerController.initialize(). ## 2.6.2 * Updates Pigeon for non-nullable collection type support. * Updates minimum supported SDK version to Flutter 3.19/Dart 3.3. ## 2.6.1 * Adds files to make include directory permanent. ## 2.6.0 * Adds Swift Package Manager compatibility. ## 2.5.7 * Adds frame availability checks on iOS. * Simplifies internal platform channel interfaces. * Updates minimum iOS version to 12.0 and minimum Flutter version to 3.16.6. ## 2.5.6 * Adds privacy manifest. ## 2.5.5 * Fixes display of initial frame when paused. ## 2.5.4 * Fixes new lint warnings. ## 2.5.3 * Publishes an instance of the plugin to the registrar on macOS, as on iOS. ## 2.5.2 * Fixes flickering and seek-while-paused on macOS. ## 2.5.1 * Updates to Pigeon 13. ## 2.5.0 * Adds support for macOS. ## 2.4.11 * Updates Pigeon. * Changes Objective-C class prefixes to avoid future collisions. ## 2.4.10 * Adds pub topics to package metadata. * Updates minimum supported SDK version to Flutter 3.7/Dart 2.19. ## 2.4.9 * Fixes the iOS crash when using multiple players on the same screen. See: https://github.com/flutter/flutter/issues/124937 ## 2.4.8 * Fixes missing `isPlaybackLikelyToKeepUp` check for iOS video player `bufferingEnd` event and `bufferingStart` event. ## 2.4.7 * Updates minimum supported SDK version to Flutter 3.3/Dart 2.18. * Adds iOS exception on incorrect asset path ## 2.4.6 * Fixes hang when seeking to end of video. ## 2.4.5 * Updates functions without a prototype to avoid deprecation warning. ## 2.4.4 * Updates pigeon to fix warnings with clang 15. ## 2.4.3 * Synchronizes `VideoPlayerValue.isPlaying` with `AVPlayer`. ## 2.4.2 * Makes seekTo async and only complete when AVPlayer.seekTo completes. ## 2.4.1 * Clarifies explanation of endorsement in README. * Aligns Dart and Flutter SDK constraints. ## 2.4.0 * Updates minimum Flutter version to 3.3 and iOS 11. ## 2.3.9 * Updates links for the merge of flutter/plugins into flutter/packages. * Updates minimum Flutter version to 3.0. ## 2.3.8 * Adds compatibilty with version 6.0 of the platform interface. * Fixes file URI construction in example. * Updates code for new analysis options. * Adds an integration test for a bug where the aspect ratios of some HLS videos are incorrectly inverted. * Removes an unnecessary override in example code. ## 2.3.7 * Fixes a bug where the aspect ratio of some HLS videos are incorrectly inverted. * Updates code for `no_leading_underscores_for_local_identifiers` lint. ## 2.3.6 * Fixes a bug in iOS 16 where videos from protected live streams are not shown. * Updates minimum Flutter version to 2.10. * Fixes violations of new analysis option use_named_constants. * Fixes avoid_redundant_argument_values lint warnings and minor typos. * Ignores unnecessary import warnings in preparation for [upcoming Flutter changes](https://github.com/flutter/flutter/pull/106316). ## 2.3.5 * Updates references to the obsolete master branch. ## 2.3.4 * Removes unnecessary imports. * Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors lint warnings. ## 2.3.3 * Fix XCUITest based on the new voice over announcement for tooltips. See: https://github.com/flutter/flutter/pull/87684 ## 2.3.2 * Applies the standardized transform for videos with different orientations. ## 2.3.1 * Renames internal method channels to avoid potential confusion with the default implementation's method channel. * Updates Pigeon to 2.0.1. ## 2.3.0 * Updates Pigeon to ^1.0.16. ## 2.2.18 * Wait to initialize m3u8 videos until size is set, fixing aspect ratio. * Adjusts test timeouts for network-dependent native tests to avoid flake. ## 2.2.17 * Splits from `video_player` as a federated implementation.