[camera] add custom path ouput to recording

packages/camera/camera/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.13.0
 
+* Adds `videoOutputPath` support to `startVideoRecording`.
 * Updates minimum supported SDK version to Flutter 3.38/Dart 3.10.
 
 ## 0.12.0+1

packages/camera/camera/README.md

@@ -6,9 +6,9 @@
 
 A Flutter plugin for iOS, Android and Web allowing access to the device cameras.
 
-|                | Android | iOS       | Web                    |
-|----------------|---------|-----------|------------------------|
-| **Support**    | SDK 24+ | iOS 13.0+ | [See `camera_web `][1] |
+|             | Android | iOS       | Web                    |
+| ----------- | ------- | --------- | ---------------------- |
+| **Support** | SDK 24+ | iOS 13.0+ | [See `camera_web `][1] |
 
 ## Features
 
@@ -92,6 +92,24 @@ Here is a list of all permission error codes that can be thrown:
 
 - `AudioAccessRestricted`: iOS only for now. Thrown when audio access is restricted and users cannot grant permission (parental control).
 
+### Custom Video Recording Path
+
+You can optionally specify a `videoOutputPath` when calling `startVideoRecording()` to save the recorded video directly to a custom absolute file path on the device.
+
+```dart
+// Always ensure the path ends with the .mp4 extension
+await controller.startVideoRecording(
+  videoOutputPath: '/path/to/your/custom_video.mp4',
+);
+```
+
+#### Platform-Specific Considerations
+
+For platform-specific considerations when saving videos, please see the READMEs on pub.dev for their respective platforms:
+- [Android](https://pub.dev/packages/camera_android)
+- [iOS](https://pub.dev/packages/camera_avfoundation)
+- [Windows](https://pub.dev/packages/camera_windows)
+
 ### Example
 
 Here is a small example flutter app displaying a full screen camera preview.

packages/camera/camera/example/ios/Runner/Info.plist

@@ -2,6 +2,12 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
+	<key>LSSupportsOpeningDocumentsInPlace</key>
+	<true/>
+	<key>UISupportsDocumentBrowser</key>
+	<true/>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 	<key>CFBundleDisplayName</key>
@@ -28,6 +34,8 @@
 	<string>Can I use the camera please? Only for demo purpose of the app</string>
 	<key>NSMicrophoneUsageDescription</key>
 	<string>Only for demo purpose of the app</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
 	<key>UILaunchStoryboardName</key>
 	<string>LaunchScreen</string>
 	<key>UIMainStoryboardFile</key>
@@ -46,9 +54,5 @@
 		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
 	</array>
-	<key>CADisableMinimumFrameDurationOnPhone</key>
-	<true/>
-	<key>UIApplicationSupportsIndirectInputEvents</key>
-	<true/>
 </dict>
 </plist>

packages/camera/camera/example/pubspec.yaml

@@ -31,3 +31,10 @@ dev_dependencies:
 
 flutter:
   uses-material-design: true
+# 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:
+  camera_android_camerax: {path: ../../../../packages/camera/camera_android_camerax}
+  camera_avfoundation: {path: ../../../../packages/camera/camera_avfoundation}
+  camera_platform_interface: {path: ../../../../packages/camera/camera_platform_interface}
+  camera_web: {path: ../../../../packages/camera/camera_web}

packages/camera/camera/lib/src/camera_controller.dart

@@ -569,6 +569,7 @@ class CameraController extends ValueNotifier<CameraValue> {
   Future<void> startVideoRecording({
     onLatestImageAvailable? onAvailable,
     bool enablePersistentRecording = true,
+    String? videoOutputPath,
   }) async {
     _throwIfNotInitialized('startVideoRecording');
     if (value.isRecordingVideo) {
@@ -578,6 +579,13 @@ class CameraController extends ValueNotifier<CameraValue> {
       );
     }
 
+    if (videoOutputPath != null) {
+      final String lowerPath = videoOutputPath.toLowerCase();
+      if (!lowerPath.endsWith('.mp4')) {
+        throw CameraException('InvalidFilePath', 'Invalid video extension. Supported: .mp4');
+      }
+    }
+
     void Function(CameraImageData image)? streamCallback;
     if (onAvailable != null) {
       streamCallback = (CameraImageData imageData) {
@@ -591,6 +599,7 @@ class CameraController extends ValueNotifier<CameraValue> {
           _cameraId,
           streamCallback: streamCallback,
           enablePersistentRecording: enablePersistentRecording,
+          videoOutputPath: videoOutputPath,
         ),
       );
       value = value.copyWith(

packages/camera/camera/pubspec.yaml

@@ -4,7 +4,7 @@ description: A Flutter plugin for controlling the camera. Supports previewing
   Dart.
 repository: https://github.com/flutter/packages/tree/main/packages/camera/camera
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+camera%22
-version: 0.12.0+1
+version: 0.13.0
 
 environment:
   sdk: ^3.10.0
@@ -23,7 +23,7 @@ flutter:
 dependencies:
   camera_android_camerax: ^0.7.0
   camera_avfoundation: ^0.10.0
-  camera_platform_interface: ^2.12.0
+  camera_platform_interface: ^2.14.0
   camera_web: ^0.3.3
   flutter:
     sdk: flutter
@@ -38,3 +38,10 @@ dev_dependencies:
 
 topics:
   - camera
+# 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:
+  camera_android_camerax: {path: ../../../packages/camera/camera_android_camerax}
+  camera_avfoundation: {path: ../../../packages/camera/camera_avfoundation}
+  camera_platform_interface: {path: ../../../packages/camera/camera_platform_interface}
+  camera_web: {path: ../../../packages/camera/camera_web}

packages/camera/camera/test/camera_image_stream_test.dart

@@ -235,10 +235,14 @@ class MockStreamingCameraPlatform extends MockCameraPlatform {
   }
 
   @override
-  Future<void> startVideoRecording(int cameraId, {Duration? maxVideoDuration}) {
+  Future<void> startVideoRecording(
+    int cameraId, {
+    Duration? maxVideoDuration,
+    String? videoOutputPath,
+  }) {
     streamCallLog.add('startVideoRecording');
     // Ignore maxVideoDuration, as it is unimplemented and deprecated.
-    return super.startVideoRecording(cameraId);
+    return super.startVideoRecording(cameraId, videoOutputPath: videoOutputPath);
   }
 
   @override

packages/camera/camera/test/camera_preview_test.dart

@@ -112,6 +112,7 @@ class FakeController extends ValueNotifier<CameraValue> implements CameraControl
   Future<void> startVideoRecording({
     onLatestImageAvailable? onAvailable,
     bool enablePersistentRecording = true,
+    String? videoOutputPath,
   }) async {}
 
   @override

packages/camera/camera/test/camera_test.dart

@@ -3493,9 +3493,13 @@ class MockCameraPlatform extends Mock with MockPlatformInterfaceMixin implements
       super.noSuchMethod(Invocation.method(#prepareForVideoRecording, null));
 
   @override
-  Future<void> startVideoRecording(int cameraId, {Duration? maxVideoDuration}) {
+  Future<void> startVideoRecording(
+    int cameraId, {
+    Duration? maxVideoDuration,
+    String? videoOutputPath,
+  }) {
     // Ignore maxVideoDuration, as it is unimplemented and deprecated.
-    return startVideoCapturing(VideoCaptureOptions(cameraId));
+    return startVideoCapturing(VideoCaptureOptions(cameraId, videoOutputPath: videoOutputPath));
   }
 
   @override

packages/camera/camera_android/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.10.11
+
+* Adds support for custom video output path in video recording.
+
 ## 0.10.10+18
 
 * Bumps the androidx group across 10 directories with 1 update.

packages/camera/camera_android/README.md

@@ -16,6 +16,23 @@ $ flutter pub add camera_android
 when recording a video with sound enabled and trying to play it back, the duration won't be correct and
 you will only see the first frame.
 
+## Custom Video Recording Path
+
+Although it is possible to use an absolute path like `/storage/emulated/0/Download/video.mp4`, this is a fragile practice and may fail on many devices or Android versions due to **Scoped Storage** restrictions.
+
+- **Best Practice:** Always use the [path_provider](https://pub.dev/packages/path_provider) package to fetch a safe, writable directory.
+- **Recommended Directory:** Use `getTemporaryDirectory()` or `getApplicationDocumentsDirectory()`.
+
+```dart
+import 'package:path/path.dart' as p;
+import 'package:path_provider/path_provider.dart';
+
+final directory = await getTemporaryDirectory();
+final videoPath = p.join(directory.path, 'my_video.mp4');
+
+await controller.startVideoRecording(videoOutputPath: videoPath);
+```
+
 [1]: https://pub.dev/packages/camera
 [2]: https://flutter.dev/to/endorsed-federated-plugin
 [3]: https://pub.dev/packages/camera_android_camerax

packages/camera/camera_android/android/src/main/java/io/flutter/plugins/camera/Camera.java

@@ -869,8 +869,9 @@ void unlockAutoFocus() {
             dartMessenger.error(flutterResult, errorCode, errorMessage, null));
   }
 
-  public void startVideoRecording(@Nullable EventChannel imageStreamChannel) {
-    prepareRecording();
+  public void startVideoRecording(
+      @Nullable EventChannel imageStreamChannel, @Nullable String videoOutputPath) {
+    prepareRecording(videoOutputPath);
 
     if (imageStreamChannel != null) {
       setStreamHandler(imageStreamChannel);
@@ -1296,13 +1297,19 @@ public void onError(@NonNull String errorCode, @NonNull String errorMessage) {
   }
 
   @VisibleForTesting
-  void prepareRecording() {
-    final File outputDir = applicationContext.getCacheDir();
-    try {
-      captureFile = File.createTempFile("REC", ".mp4", outputDir);
-    } catch (IOException | SecurityException e) {
-      throw new Messages.FlutterError("cannotCreateFile", e.getMessage(), null);
+  void prepareRecording(@Nullable String videoOutputPath) {
+    if (videoOutputPath != null) {
+      validateOutputPath(videoOutputPath);
+      captureFile = new File(videoOutputPath);
+    } else {
+      final File outputDir = applicationContext.getCacheDir();
+      try {
+        captureFile = File.createTempFile("REC", ".mp4", outputDir);
+      } catch (IOException | SecurityException e) {
+        throw new Messages.FlutterError("cannotCreateFile", e.getMessage(), null);
+      }
     }
+
     try {
       prepareMediaRecorder(captureFile.getAbsolutePath());
     } catch (IOException e) {
@@ -1317,6 +1324,23 @@ void prepareRecording() {
     setFpsCameraFeatureForRecording(cameraProperties);
   }
 
+  private void validateOutputPath(String path) {
+    File file = new File(path);
+    if (file.isDirectory()) {
+      throw new Messages.FlutterError("IOError", "The output path is a directory: " + path, null);
+    }
+    File parent = file.getParentFile();
+    if (parent != null && !parent.exists()) {
+      throw new Messages.FlutterError(
+          "IOError", "The parent directory does not exist: " + parent.getAbsolutePath(), null);
+    }
+
+    String lowerPath = path.toLowerCase(Locale.ROOT);
+    if (!lowerPath.endsWith(".mp4")) {
+      throw new Messages.FlutterError("IOError", "Invalid video extension. Supported: .mp4", null);
+    }
+  }
+
   private void setStreamHandler(EventChannel imageStreamChannel) {
     imageStreamChannel.setStreamHandler(
         new EventChannel.StreamHandler() {

packages/camera/camera_android/android/src/main/java/io/flutter/plugins/camera/CameraApiImpl.java

@@ -175,8 +175,8 @@ public void takePicture(@NonNull Messages.Result<String> result) {
   }
 
   @Override
-  public void startVideoRecording(@NonNull Boolean enableStream) {
-    camera.startVideoRecording(enableStream ? imageStreamChannel : null);
+  public void startVideoRecording(@NonNull Boolean enableStream, @Nullable String videoOutputPath) {
+    camera.startVideoRecording(enableStream ? imageStreamChannel : null, videoOutputPath);
   }
 
   @NonNull