# video_player_android 2.12.2 Android implementation of the video_player plugin. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir flutter pub add video_player_android ``` Published: 2026-09-02T18:40:48.450928Z Expected archive SHA-256: d27054dea34d748a44f06d433a57005d2aac69944485b0abbaed3303dbcfa3f1 Available in cache; verification: upstream_checksum ## Direct dependencies - flutter: map[sdk:flutter] - meta: ^1.10.0 - video_player_platform_interface: ^6.9.0 ## Package README (untrusted upstream documentation) # video\_player\_android The Android 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. ## Known issues Using `VideoViewType.platformView` is not currently recommended on Android due to a known [issue][3] affecting platform views on Android. [1]: https://pub.dev/packages/video_player [2]: https://flutter.dev/to/endorsed-federated-plugin [3]: https://github.com/flutter/flutter/issues/164899 ## Changelog ## 2.12.2 * Fixes a [bug](https://github.com/flutter/flutter/issues/132934) where videos with a pixel aspect ratio other than 1.0 (anamorphic content) reported their coded size instead of their display size, causing them to be rendered stretched. ## 2.12.1 * Updates pigeon dev_dependency to ^27.3.2 for analyzer 14 compatibility. ## 2.12.0 * Fixes a [bug](https://github.com/flutter/flutter/issues/176575) where some videos report an incorrect duration when initialized without a video duration. ## 2.11.0 * Adds `backBufferDurationMs` to `CreationOptions` to configure ExoPlayer `DefaultLoadControl` back buffer duration. ## 2.10.0 * Implements `getVideoTracks()` and `selectVideoTrack()` methods for video track (quality) selection using ExoPlayer. ## 2.9.7 * Fixes a [bug](https://github.com/flutter/flutter/issues/184241) where the video freezes after returning from a full-screen transition on Android. ## 2.9.6 * Migrates to Built-in Kotlin to support AGP 9. * Updates minimum supported SDK version to Flutter 3.44/Dart 3.12. ## 2.9.5 * Updates build files from Groovy to Kotlin. ## 2.9.4 * Updates `androidx.media3` to 1.9.2. ## 2.9.3 * Updates `androidx.media3` to 1.9.1. ## 2.9.2 * Bumps kotlin_version to 2.3.0. ## 2.9.1 * Updates to Pigeon 26.1.5. ## 2.9.0 * Implements `getAudioTracks()` and `selectAudioTrack()` methods for Android using ExoPlayer. ## 2.8.22 * Bumps kotlin_version to 2.2.21. ## 2.8.21 * Bumps com.android.tools.build:gradle from 8.12.1 to 8.13.1. ## 2.8.20 * Bumps `exoplayer_version` from 1.5.1 to 1.8.0. ## 2.8.19 * Updates to Pigeon 26. ## 2.8.18 * Removed mockito-inline and updated to mockito-core 5.17.0. ## 2.8.17 * Moves video event processing logic to Dart, and fixes an issue where buffer range would not be updated for a paused video. * Switches to Kotlin for Pigeon-generated code. * Adopts type-safe event channels for internal communication. ## 2.8.16 * Updates Java compatibility version to 17 and minimum supported SDK version to Flutter 3.35/Dart 3.9. ## 2.8.15 * Resolves Gradle 9 deprecations. ## 2.8.14 * Restructures internal logic for player creation and tracking. ## 2.8.13 * Bumps com.android.tools.build:gradle to 8.12.1. ## 2.8.12 * Moves buffer position update event generation to Dart. ## 2.8.11 * Updates kotlin version to 2.2.0 to enable gradle 8.11 support. ## 2.8.10 * Restructures internal logic to move more code to Dart. ## 2.8.9 * Restructures the communication between Dart and Java code. ## 2.8.8 * * Updates Media3-ExoPlayer to 1.5.1. ## 2.8.7 * Adds note about known issue regarding platform views to the README. ## 2.8.6 * Fixes a [bug](https://github.com/flutter/flutter/issues/165149) where the `isBuffering` flag always returns true after seeking to any position. ## 2.8.5 * Replaces deprecated `onSurfaceDestroyed` with `onSurfaceCleanup`. * Restores background playback support. ## 2.8.4 * Fixes incorrect width/height swap ([bug](https://github.com/flutter/flutter/issues/166097)). The swap was originally required for the uncorrected width/height of `Format` but was mistakenly retained after [switching to `VideoSize`](https://github.com/flutter/packages/pull/6535), which already accounts for rotation. * Fixes example app layout issue caused by `Transform.rotate` not affecting space calculation (following [#8685](https://github.com/flutter/packages/pull/8685)). ## 2.8.3 * Changes plugin to use `TextureRegistry.SurfaceProducer.handlesCropAndRotation` to detect whether or not the video player rotation needs to be corrected. ## 2.8.2 * Fixes a [bug](https://github.com/flutter/flutter/issues/164689) that can cause video to disappear after an app is suspended and resumed. ## 2.8.1 * Updates compileSdk 34 to flutter.compileSdkVersion. ## 2.8.0 * Adds support for platform views as an optional way of displaying a video. * Suppresses deprecation and removal warnings for `TextureRegistry.SurfaceProducer.onSurfaceDestroyed`. ## 2.7.17 * Replaces deprecated Android embedder APIs (`onSurfaceCreated` -> `onSurfaceAvailable`). * Updates minimum supported SDK version to Flutter 3.22/Dart 3.4. ## 2.7.16 * Updates internal Pigeon API to use newer features. ## 2.7.15 * Changes the rotation correction calculation for Android API 29+ to use the one that is reported by the video's format instead of the unapplied rotation degrees that Exoplayer does not report on Android API 21+. * Changes the rotation correction calculation for Android APIs 21-28 to 0 because the Impeller backend used on those API versions correctly rotates the video being played automatically. ## 2.7.14 * Removes SSL workaround for API 19, which is no longer supported. ## 2.7.13 * When `AndroidVideoPlayer` attempts to operate on a `textureId` that is not active (i.e. it was previously disposed or never created), the resulting platform exception is more informative than a "NullPointerException". ## 2.7.12 * Fixes a [bug](https://github.com/flutter/flutter/issues/156451) where additional harmless but annoying warnings in the form of native stack traces would be printed when the app was backgrounded. There may be additional warnings that are not yet fixed, but this should address the most common case. ## 2.7.11 * Fixes a [bug](https://github.com/flutter/flutter/issues/156158) where a harmless but annoying warning in the form of a native stack trace would be printed when a previously disposed video player received a trim memory event (i.e. by backgrounding). ## 2.7.10 * Fixes a [bug](https://github.com/flutter/flutter/issues/156158) where disposing a video player (including implicitly by switching tabs or views in a running app) would cause native stack traces. ## 2.7.9 * Updates Java compatibility version to 11. ## 2.7.8 * Updates Pigeon for non-nullable collection type support. ## 2.7.7 * Removes the flag to treat warnings as errors in client builds. ## 2.7.6 * Fixes a [bug](https://github.com/flutter/flutter/issues/154602) where resuming a video player would cause a `Bad state: Future already completed`. ## 2.7.5 * Add a deprecation suppression in advance of a new `SurfaceProducer` API. ## 2.7.4 * Fixes a [bug](https://github.com/flutter/flutter/issues/154559) where resuming (or using a plugin like `share_plus` that implicitly resumes the activity where) a video player would cause a `DecoderInitializationException`. ## 2.7.3 * Updates Media3-ExoPlayer to 1.4.1. ## 2.7.2 * Updates minimum supported SDK version to Flutter 3.24/Dart 3.5. * Re-adds Impeller support. ## 2.7.1 * Revert Impeller support. ## 2.7.0 * Re-adds [support for Impeller](https://docs.flutter.dev/release/breaking-changes/android-surface-plugins). ## 2.6.0 * Adds RTSP support. ## 2.5.4 * Updates Media3-ExoPlayer to 1.4.0. ## 2.5.3 * Updates lint checks to ignore NewerVersionAvailable. ## 2.5.2 * Updates Android Gradle plugin to 8.5.0. ## 2.5.1 * Removes additional references to the v1 Android embedding. ## 2.5.0 * Migrates ExoPlayer to Media3-ExoPlayer 1.3.1. ## 2.4.17 * Revert Impeller support. ## 2.4.16 * [Supports Impeller](https://docs.flutter.dev/release/breaking-changes/android-surface-plugins). ## 2.4.15 * Updates minimum supported SDK version to Flutter 3.22/Dart 3.4. * Removes support for apps using the v1 Android embedding. ## 2.4.14 * Calls `onDestroy` instead of `initialize` in onDetachedFromEngine. ## 2.4.13 * Updates minSdkVersion to 19. * Updates minimum supported SDK version to Flutter 3.16/Dart 3.2. ## 2.4.12 * Updates compileSdk version to 34. * Adds error handling for `BehindLiveWindowException`, which may occur upon live-video playback failure. ## 2.4.11 * Updates minimum supported SDK version to Flutter 3.10/Dart 3.0. * Fixes new lint warnings. ## 2.4.10 * Adds pub topics to package metadata. * Updates minimum supported SDK version to Flutter 3.7/Dart 2.19. ## 2.4.9 * Bumps ExoPlayer version to 2.18.7. ## 2.4.8 * Bumps ExoPlayer version to 2.18.6. ## 2.4.7 * Fixes Java warnings. ## 2.4.6 * Fixes compatibility with AGP versions older than 4.2. ## 2.4.5 * Adds a namespace for compatibility with AGP 8.0. ## 2.4.4 * Synchronizes `VideoPlayerValue.isPlaying` with `ExoPlayer`. * Updates minimum Flutter version to 3.3. ## 2.4.3 * Bumps ExoPlayer version to 2.18.5. ## 2.4.2 * Bumps ExoPlayer version to 2.18.4. ## 2.4.1 * Changes the severity of `javac` warnings so that they are treated as errors and fixes the violations. ## 2.4.0 * Allows setting the ExoPlayer user agent by passing a User-Agent HTTP header. ## 2.3.12 * Clarifies explanation of endorsement in README. * Aligns Dart and Flutter SDK constraints. * Updates compileSdkVersion to 33. ## 2.3.11 * Updates links for the merge of flutter/plugins into flutter/packages. * Updates minimum Flutter version to 3.0. ## 2.3.10 * Adds compatibilty with version 6.0 of the platform interface. * Fixes file URI construction in example. * Updates code for new analysis options. * Updates code for `no_leading_underscores_for_local_identifiers` lint. * Updates minimum Flutter version to 2.10. * Fixes violations of new analysis option use_named_constants. * Removes an unnecessary override in example code. ## 2.3.9 * Updates ExoPlayer to 2.18.1. * Fixes avoid_redundant_argument_values lint warnings and minor typos. ## 2.3.8 * Updates ExoPlayer to 2.18.0. ## 2.3.7 * Bumps gradle version to 7.2.1. * Ignores unnecessary import warnings in preparation for [upcoming Flutter changes](https://github.com/flutter/flutter/pull/106316). ## 2.3.6 * Updates references to the obsolete master branch. ## 2.3.5 * Sets rotationCorrection for videos recorded in landscapeRight (https://github.com/flutter/flutter/issues/60327). ## 2.3.4 * Updates ExoPlayer to 2.17.1. ## 2.3.3 * Removes unnecessary imports. * Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors lint warnings. ## 2.3.2 * Updates ExoPlayer to 2.17.0. ## 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.17 * Splits from `video_player` as a federated implementation.