feat: add support for specifying a video path

packages/react-native-vision-camera/android/src/main/java/com/margelo/nitro/camera/hybrids/outputs/HybridVideoOutput.kt

@@ -145,8 +145,15 @@ class HybridVideoOutput(
   @SuppressLint("MissingPermission")
   override fun createRecorder(settings: RecorderSettings): Promise<HybridRecorderSpec> {
     return Promise.async {
-      // Create .mp4 file in temp directory
-      val file = File.createTempFile("VisionCamera_", "mp4")
+      val file =
+        if (settings.filePath != null) {
+          File(settings.filePath)
+        } else {
+          // Create .mp4 file in temp directory
+          File.createTempFile("VisionCamera_", "mp4")
+        }
+      // Create all parent directories if they don't exist yet.
+      file.parentFile?.mkdirs()
 
       // Prepare output options
       val fileOutputOptions =

packages/react-native-vision-camera/ios/Hybrid Objects/Recording/HybridVideoRecorder.swift

@@ -23,7 +23,16 @@ class HybridVideoRecorder: HybridRecorderSpec {
   ) throws {
     self.videoOutput = videoOutput
     self.queue = queue
-    self.fileURL = try URL.createTempURL(fileType: fileType.toUTType())
+    if let customFilePath = settings.filePath {
+      self.fileURL = URL(fileURLWithPath: customFilePath)
+    } else {
+      self.fileURL = try URL.createTempURL(fileType: fileType.toUTType())
+    }
+    // Create all parent directories if they don't exist yet.
+    try FileManager.default.createDirectory(
+      at: self.fileURL.deletingLastPathComponent(),
+      withIntermediateDirectories: true
+    )
     self.settings = settings
     super.init()
   }

packages/react-native-vision-camera/src/specs/outputs/CameraVideoOutput.nitro.ts

@@ -143,6 +143,17 @@ export interface RecorderSettings {
    * into the video metadata using the ISO-6709 standard.
    */
   location?: Location
+  /**
+   * The absolute path (including file name and extension) where
+   * the recording file should be written to, or `undefined` to
+   * create a file in the device's temporary directory.
+   * 
+   * All parent directories in this {@linkcode filePath} will
+   * be automatically created if they do not yet exist.
+   * 
+   * @default undefined
+   */
+  filePath?: string
   /**
    * If set, the recording automatically stops once it reaches
    * this duration, in seconds.
@@ -210,8 +221,9 @@ export interface CameraVideoOutput extends CameraOutput {
    * Creates and prepares a new {@linkcode Recorder}
    * instance with the given {@linkcode RecorderSettings}.
    *
-   * The {@linkcode Recorder} will record to a temporary
-   * file, and can only record once.
+   * The {@linkcode Recorder} will record to the configured
+   * file path, or to a temporary file if no path was provided.
+   * It can only record once.
    *
    * If you want to create a second recording,
    * you must create a new {@linkcode Recorder}.