feat: Add manual iso/exposureDuration props

Author: mrousavy

package/ios/Core/CameraConfiguration.swift

@@ -46,12 +46,18 @@ final class CameraConfiguration {
 
   // Exposure
   var exposure: Float?
+  var exposureDuration: Double?
+  var iso: Float?
 
   // isActive (Start/Stop)
   var isActive = false
 
   // Audio Session
   var audio: OutputConfiguration<Audio> = .disabled
+  
+  var isManualExposure: Bool {
+    return exposureDuration != nil || iso != nil
+  }
 
   init(copyOf other: CameraConfiguration?) {
     if let other {
@@ -83,7 +89,6 @@ final class CameraConfiguration {
   /**
    Throw this to abort calls to configure { ... } and apply no changes.
    */
-  @frozen
   enum AbortThrow: Error {
     case abort
   }
@@ -131,7 +136,7 @@ final class CameraConfiguration {
       // format (depends on cameraId)
       formatChanged = inputChanged || left?.format != right.format
       // side-props (depends on format)
-      sidePropsChanged = formatChanged || left?.minFps != right.minFps || left?.maxFps != right.maxFps || left?.enableLowLightBoost != right.enableLowLightBoost
+      sidePropsChanged = formatChanged || left?.minFps != right.minFps || left?.maxFps != right.maxFps || left?.enableLowLightBoost != right.enableLowLightBoost || left?.exposureDuration != right.exposureDuration || left?.iso != right.iso
       // torch (depends on isActive)
       let wasInactiveAndNeedsToEnableTorchAgain = left?.isActive == false && right.isActive == true && right.torch == .on
       torchChanged = inputChanged || wasInactiveAndNeedsToEnableTorchAgain || left?.torch != right.torch
@@ -148,7 +153,6 @@ final class CameraConfiguration {
     }
   }
 
-  @frozen
   enum OutputConfiguration<T: Equatable>: Equatable {
     case disabled
     case enabled(config: T)

package/ios/Core/CameraSession+Configuration.swift

@@ -273,19 +273,29 @@ extension CameraSession {
       }
       device.automaticallyEnablesLowLightBoostWhenAvailable = configuration.enableLowLightBoost
     }
-
+    
     // Configure auto-focus
     if device.isFocusModeSupported(.continuousAutoFocus) {
       if device.isFocusPointOfInterestSupported {
         device.focusPointOfInterest = CGPoint(x: 0.5, y: 0.5)
       }
       device.focusMode = .continuousAutoFocus
     }
-    if device.isExposureModeSupported(.continuousAutoExposure) {
-      if device.isExposurePointOfInterestSupported {
-        device.exposurePointOfInterest = CGPoint(x: 0.5, y: 0.5)
+    
+    
+    if configuration.isManualExposure {
+      // Lock exposure to manual
+      let duration = CMTime(seconds: configuration.exposureDuration ?? AVCaptureDevice.currentExposureDuration.seconds, preferredTimescale: 1)
+      let iso = configuration.iso ?? AVCaptureDevice.currentISO
+      device.setExposureModeCustom(duration: duration, iso: iso)
+    } else {
+      // Configure auto-exposure
+      if device.isExposureModeSupported(.continuousAutoExposure) {
+        if device.isExposurePointOfInterestSupported {
+          device.exposurePointOfInterest = CGPoint(x: 0.5, y: 0.5)
+        }
+        device.exposureMode = .continuousAutoExposure
       }
-      device.exposureMode = .continuousAutoExposure
     }
   }
 

package/ios/Core/Types/CameraDeviceFormat.swift

@@ -24,6 +24,9 @@ struct CameraDeviceFormat: Equatable, CustomStringConvertible {
 
   let minISO: Float
   let maxISO: Float
+  
+  let minExposureDuration: Double
+  let maxExposureDuration: Double
 
   let fieldOfView: Float
 
@@ -44,6 +47,8 @@ struct CameraDeviceFormat: Equatable, CustomStringConvertible {
     maxFps = format.maxFps
     minISO = format.minISO
     maxISO = format.maxISO
+    minExposureDuration = format.minExposureDuration.seconds
+    maxExposureDuration = format.maxExposureDuration.seconds
     fieldOfView = format.videoFieldOfView
     videoStabilizationModes = format.videoStabilizationModes.map { VideoStabilizationMode(from: $0) }
     autoFocusSystem = AutoFocusSystem(fromFocusSystem: format.autoFocusSystem)
@@ -62,6 +67,8 @@ struct CameraDeviceFormat: Equatable, CustomStringConvertible {
     maxFps = jsValue["maxFps"] as! Double
     minISO = jsValue["minISO"] as! Float
     maxISO = jsValue["maxISO"] as! Float
+    minExposureDuration = jsValue["minExposureDuration"] as! Double
+    maxExposureDuration = jsValue["minExposureDuration"] as! Double
     fieldOfView = jsValue["fieldOfView"] as! Float
     let jsVideoStabilizationModes = jsValue["videoStabilizationModes"] as! [String]
     videoStabilizationModes = try jsVideoStabilizationModes.map { try VideoStabilizationMode(jsValue: $0) }
@@ -88,6 +95,8 @@ struct CameraDeviceFormat: Equatable, CustomStringConvertible {
       "videoWidth": videoWidth,
       "minISO": minISO,
       "maxISO": maxISO,
+      "minExposureDuration": minExposureDuration,
+      "maxExposureDuration": maxExposureDuration,
       "fieldOfView": fieldOfView,
       "supportsVideoHdr": supportsVideoHdr,
       "supportsPhotoHdr": supportsPhotoHdr,

package/ios/React/CameraViewManager.m

@@ -53,6 +53,8 @@ @interface RCT_EXTERN_REMAP_MODULE (CameraView, CameraViewManager, RCTViewManage
 RCT_EXPORT_VIEW_PROPERTY(torch, NSString);
 RCT_EXPORT_VIEW_PROPERTY(zoom, NSNumber);
 RCT_EXPORT_VIEW_PROPERTY(exposure, NSNumber);
+RCT_EXPORT_VIEW_PROPERTY(iso, NSNumber);
+RCT_EXPORT_VIEW_PROPERTY(exposureDuration, NSNumber);
 RCT_EXPORT_VIEW_PROPERTY(enableZoomGesture, BOOL);
 RCT_EXPORT_VIEW_PROPERTY(outputOrientation, NSString);
 RCT_EXPORT_VIEW_PROPERTY(resizeMode, NSString);

package/src/types/CameraDevice.ts

@@ -78,6 +78,14 @@ export interface CameraDeviceFormat {
    * Minimum supported ISO value
    */
   minISO: number
+  /**
+   * Minimum supported exposure duration, in seconds
+   */
+  minExposureDuration: number
+  /**
+   * Maximum supported exposure duration, in seconds
+   */
+  maxExposureDuration: number
   /**
    * The video field of view in degrees
    */

package/src/types/CameraProps.ts

@@ -149,6 +149,23 @@ export interface CameraProps extends ViewProps {
    * The value between min- and max supported exposure is considered the default, neutral value.
    */
   exposure?: number
+
+  /**
+   * Manually configures the ISO value of the Camera.
+   *
+   * If either {@linkcode iso} or {@linkcode exposureDuration} is set, the Camera will be locked to manual exposure.
+   *
+   * @default undefined
+   */
+  iso?: number
+  /**
+   * Manually configures the exposure duration (in seconds) of the Camera.
+   *
+   * If either {@linkcode exposureDuration} or {@linkcode iso} is set, the Camera will be locked to manual exposure.
+   *
+   * @default undefined
+   */
+  exposureDuration?: number
   //#endregion
 
   //#region Format/Preset selection