[video_player] Add html 5 video poster support (thumbnail) as a VideoPlayerWebOptions

packages/video_player/video_player/pubspec.yaml

@@ -38,3 +38,8 @@ dev_dependencies:
 topics:
   - video
   - video-player
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  video_player_platform_interface: {path: ../../../packages/video_player/video_player_platform_interface}
+  video_player_web: {path: ../../../packages/video_player/video_player_web}

packages/video_player/video_player_platform_interface/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 6.4.0
 
+* Adds HTML5 video poster support as a VideoPlayerWebOptions.
 * Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.
 
 ## 6.3.0

packages/video_player/video_player_platform_interface/lib/video_player_platform_interface.dart

@@ -429,6 +429,7 @@ class VideoPlayerWebOptions {
     this.controls = const VideoPlayerWebOptionsControls.disabled(),
     this.allowContextMenu = true,
     this.allowRemotePlayback = true,
+    this.poster,
   });
 
   /// Additional settings for how control options are displayed
@@ -439,6 +440,9 @@ class VideoPlayerWebOptions {
 
   /// Whether remote playback is allowed
   final bool allowRemotePlayback;
+
+  /// The URL of the poster image to be displayed before the video starts
+  final Uri? poster;
 }
 
 /// [VideoPlayerWebOptions] can be used to set how control options are displayed

packages/video_player/video_player_platform_interface/pubspec.yaml

@@ -4,7 +4,7 @@ repository: https://github.com/flutter/packages/tree/main/packages/video_player/
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+video_player%22
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 6.3.0
+version: 6.4.0
 
 environment:
   sdk: ^3.6.0

packages/video_player/video_player_platform_interface/test/video_player_web_options_test.dart

@@ -29,4 +29,24 @@ void main() {
       expect(options.allowRemotePlayback, isTrue);
     },
   );
+
+  group('VideoPlayerOptions poster', () {
+    test(
+      'defaults to null',
+      () {
+        const VideoPlayerWebOptions options = VideoPlayerWebOptions();
+        expect(options.poster, null);
+      },
+    );
+
+    test(
+      'with a value',
+      () {
+        final VideoPlayerWebOptions options = VideoPlayerWebOptions(
+          poster: Uri.parse('https://example.com/poster.jpg'),
+        );
+        expect(options.poster, Uri.parse('https://example.com/poster.jpg'));
+      },
+    );
+  });
 }

packages/video_player/video_player_web/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.3.6
 
+* Add html 5 video poster support as a VideoPlayerWebOptions.
 * Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.
 
 ## 2.3.5

packages/video_player/video_player_web/example/pubspec.yaml

@@ -18,3 +18,7 @@ dev_dependencies:
     sdk: flutter
   integration_test:
     sdk: flutter
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  video_player_platform_interface: {path: ../../../../packages/video_player/video_player_platform_interface}

packages/video_player/video_player_web/lib/src/video_player.dart

@@ -262,6 +262,10 @@ class VideoPlayer {
     if (!options.allowRemotePlayback) {
       _videoElement.disableRemotePlayback = true;
     }
+
+    if (options.poster != null) {
+      _videoElement.poster = options.poster!.toString();
+    }
   }
 
   void _resetOptions() {

packages/video_player/video_player_web/pubspec.yaml

@@ -21,7 +21,7 @@ dependencies:
     sdk: flutter
   flutter_web_plugins:
     sdk: flutter
-  video_player_platform_interface: ^6.3.0
+  video_player_platform_interface: ^6.3.1
   web: ">=0.5.1 <2.0.0"
 
 dev_dependencies:
@@ -31,3 +31,7 @@ dev_dependencies:
 topics:
   - video
   - video-player
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  video_player_platform_interface: {path: ../../../packages/video_player/video_player_platform_interface}