[video_player_platform_interface] Add preventsDisplaySleepDuringVideoPlayback option (#11546)

## Description

Adds the `preventsDisplaySleepDuringVideoPlayback` field to `VideoPlayerOptions` and a `setPreventsDisplaySleepDuringVideoPlayback` method to `VideoPlayerPlatform`, allowing platform implementations to control whether the display sleeps during video playback.

Platform interface breakout PR for #11225.

## Changes

- Adds `preventsDisplaySleepDuringVideoPlayback` field to `VideoPlayerOptions` (defaults to `true` to preserve existing behavior).
- Adds `setPreventsDisplaySleepDuringVideoPlayback(int playerId, bool preventsDisplaySleepDuringVideoPlayback)` method to `VideoPlayerPlatform` with a default no-op implementation so existing platform implementations continue to compile without changes.
- Updates CHANGELOG (6.7.0) and pubspec version.
- Adds unit test covering the default value of `preventsDisplaySleepDuringVideoPlayback`.

## Related

- Parent PR: #11225
- Fixes: flutter/flutter#183520

Author: shrabanti722

packages/video_player/video_player_platform_interface/CHANGELOG.md

@@ -1,5 +1,9 @@
-## NEXT
+## 6.8.0
 
+* Adds `preventsDisplaySleepDuringVideoPlayback` to `VideoPlayerOptions` and
+  `setPreventsDisplaySleepDuringVideoPlayback` to `VideoPlayerPlatform`. The
+  default implementation is a no-op so platforms that do not support
+  controlling display sleep silently fall back to their default behavior.
 * Updates minimum supported SDK version to Flutter 3.38/Dart 3.10.
 
 ## 6.7.0

packages/video_player/video_player_platform_interface/lib/video_player_platform_interface.dart

@@ -122,6 +122,15 @@ abstract class VideoPlayerPlatform extends PlatformInterface {
     throw UnimplementedError('setAllowBackgroundPlayback() has not been implemented.');
   }
 
+  /// Sets whether the screen is prevented from sleeping during video playback.
+  ///
+  /// The default implementation is a no-op, so platforms that do not support
+  /// controlling display sleep will silently use their default behavior.
+  Future<void> setPreventsDisplaySleepDuringVideoPlayback(
+    int playerId,
+    bool preventsDisplaySleepDuringVideoPlayback,
+  ) async {}
+
   /// Sets additional options on web.
   Future<void> setWebOptions(int playerId, VideoPlayerWebOptions options) {
     throw UnimplementedError('setWebOptions() has not been implemented.');
@@ -461,6 +470,7 @@ class VideoPlayerOptions {
   VideoPlayerOptions({
     this.mixWithOthers = false,
     this.allowBackgroundPlayback = false,
+    this.preventsDisplaySleepDuringVideoPlayback = true,
     this.webOptions,
   });
 
@@ -475,6 +485,13 @@ class VideoPlayerOptions {
   /// currently no way to implement this feature in this platform).
   final bool mixWithOthers;
 
+  /// Whether the screen is prevented from sleeping during video playback.
+  ///
+  /// Defaults to `true`.
+  ///
+  /// This option may not be supported on all platforms.
+  final bool preventsDisplaySleepDuringVideoPlayback;
+
   /// Additional web controls
   final VideoPlayerWebOptions? webOptions;
 }

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.7.0
+version: 6.8.0
 
 environment:
   sdk: ^3.10.0

packages/video_player/video_player_platform_interface/test/video_player_options_test.dart

@@ -14,4 +14,8 @@ void main() {
     final options = VideoPlayerOptions();
     expect(options.mixWithOthers, false);
   });
+  test('VideoPlayerOptions preventsDisplaySleepDuringVideoPlayback defaults to true', () {
+    final options = VideoPlayerOptions();
+    expect(options.preventsDisplaySleepDuringVideoPlayback, true);
+  });
 }