[image_picker] Add the ability to pick multiple videos - platform_interface (#9804)

This is the platform interface portion of #9775

Part of flutter/flutter#102283

## Pre-Review Checklist

**Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). 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.

[^1]: Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling.

Author: stuartmorgan-g

packages/image_picker/image_picker_platform_interface/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.11.0
 
+* Adds `getMultiVideoWithOptions` method.
 * Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.
 
 ## 2.10.1

packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart

@@ -322,6 +322,21 @@ abstract class ImagePickerPlatform extends PlatformInterface {
     return pickedImages ?? <XFile>[];
   }
 
+  /// Returns a [List<XFile>] with the videos that were picked.
+  ///
+  /// The videos come from the [ImageSource.gallery].
+  ///
+  /// The `options` argument controls additional settings that can be used when
+  /// picking a video. See [MultiVideoPickerOptions] for more details.
+  ///
+  /// If no videos were picked, returns an empty list.
+  Future<List<XFile>> getMultiVideoWithOptions({
+    MultiVideoPickerOptions options = const MultiVideoPickerOptions(),
+  }) {
+    throw UnimplementedError(
+        'getMultiVideoWithOptions() has not been implemented.');
+  }
+
   /// Returns true if the implementation supports [source].
   ///
   /// Defaults to true for the original image sources, `gallery` and `camera`,

packages/image_picker/image_picker_platform_interface/lib/src/types/multi_video_picker_options.dart

@@ -0,0 +1,23 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:flutter/foundation.dart';
+
+/// Specifies options for picking multiple videos.
+@immutable
+class MultiVideoPickerOptions {
+  /// Creates an instance with the given options.
+  const MultiVideoPickerOptions({
+    this.maxDuration,
+    this.limit,
+  });
+
+  /// The maximum duration of the picked video.
+  final Duration? maxDuration;
+
+  /// The maximum number of videos that can be selected.
+  ///
+  /// This value may be ignored by platforms that cannot support it.
+  final int? limit;
+}

packages/image_picker/image_picker_platform_interface/lib/src/types/types.dart

@@ -10,6 +10,7 @@ export 'lost_data_response.dart';
 export 'media_options.dart';
 export 'media_selection_type.dart';
 export 'multi_image_picker_options.dart';
+export 'multi_video_picker_options.dart';
 export 'picked_file/picked_file.dart';
 export 'retrieve_type.dart';
 

packages/image_picker/image_picker_platform_interface/pubspec.yaml

@@ -4,7 +4,7 @@ repository: https://github.com/flutter/packages/tree/main/packages/image_picker/
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+image_picker%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: 2.10.1
+version: 2.11.0
 
 environment:
   sdk: ^3.6.0

packages/image_picker/image_picker_platform_interface/test/image_picker_platform_test.dart

@@ -76,6 +76,18 @@ void main() {
           fakePath);
     });
   });
+
+  test(
+      'Default implementation of getMultiVideoWithOptions should throw '
+      'unimplemented error', () {
+    final FakeCameraDelegatingImagePickerPlatform implementation =
+        FakeCameraDelegatingImagePickerPlatform();
+
+    expect(
+      () => implementation.getMultiVideoWithOptions(),
+      throwsUnimplementedError,
+    );
+  });
 }
 
 class FakeImagePickerPlatform extends ImagePickerPlatform {}