feat: Support focus depth/distance on android

Author: HugoGresse

package/android/src/main/java/com/mrousavy/camera/core/CameraSession.kt

@@ -5,12 +5,17 @@ import android.annotation.SuppressLint
 import android.content.Context
 import android.content.pm.PackageManager
 import android.graphics.BitmapFactory
+import android.hardware.camera2.CameraMetadata
+import android.hardware.camera2.CaptureRequest
 import android.media.AudioManager
 import android.util.Log
 import android.util.Range
 import android.util.Size
 import androidx.annotation.MainThread
 import androidx.annotation.OptIn
+import androidx.camera.camera2.interop.Camera2CameraControl
+import androidx.camera.camera2.interop.CaptureRequestOptions
+import androidx.camera.camera2.interop.ExperimentalCamera2Interop
 import androidx.camera.core.Camera
 import androidx.camera.core.CameraControl
 import androidx.camera.core.CameraSelector
@@ -652,6 +657,26 @@ class CameraSession(private val context: Context, private val callback: Callback
     }
   }
 
+  @ExperimentalCamera2Interop
+  @SuppressLint("RestrictedApi")
+  fun focusDepth(depth: Double) {
+    val camera = camera ?: throw CameraNotReadyError()
+
+    try {
+      Camera2CameraControl.from(camera.cameraControl).let {
+        CaptureRequestOptions.Builder().apply {
+          val distance = depth.toFloat()
+          setCaptureRequestOption(CaptureRequest.LENS_FOCUS_DISTANCE, distance)
+          setCaptureRequestOption(CaptureRequest.CONTROL_AF_MODE, CameraMetadata.CONTROL_AF_MODE_OFF)
+        }.let { builder ->
+          it.addCaptureRequestOptions(builder.build())
+        }
+      }
+    } catch (e: CameraControl.OperationCanceledException) {
+      throw FocusCanceledError()
+    }
+  }
+
   interface Callback {
     fun onError(error: Throwable)
     fun onFrame(frame: Frame)

package/android/src/main/java/com/mrousavy/camera/react/CameraView+FocusDepth.kt

@@ -0,0 +1,8 @@
+package com.mrousavy.camera.react
+
+import androidx.camera.camera2.interop.ExperimentalCamera2Interop
+
+@ExperimentalCamera2Interop
+fun CameraView.focusDepth(distance: Double) {
+  cameraSession.focusDepth(distance)
+}

package/android/src/main/java/com/mrousavy/camera/react/CameraViewModule.kt

@@ -3,6 +3,7 @@ package com.mrousavy.camera.react
 import android.Manifest
 import android.content.pm.PackageManager
 import android.util.Log
+import androidx.camera.camera2.interop.ExperimentalCamera2Interop
 import androidx.core.content.ContextCompat
 import com.facebook.react.bridge.Callback
 import com.facebook.react.bridge.Promise
@@ -188,6 +189,18 @@ class CameraViewModule(reactContext: ReactApplicationContext) : ReactContextBase
     }
   }
 
+  @ExperimentalCamera2Interop
+  @ReactMethod
+  fun focusDepth(viewTag: Int, distance: Double, promise: Promise) {
+    backgroundCoroutineScope.launch {
+      val view = findCameraView(viewTag)
+      withPromise(promise) {
+        view.focusDepth(distance)
+        return@withPromise null
+      }
+    }
+  }
+
   private fun canRequestPermission(permission: String): Boolean {
     val activity = currentActivity as? PermissionAwareActivity
     return activity?.shouldShowRequestPermissionRationale(permission) ?: false

package/src/Camera.tsx

@@ -372,6 +372,27 @@ export class Camera extends React.PureComponent<CameraProps, CameraState> {
       throw tryParseNativeCameraError(e)
     }
   }
+
+  /**
+   * Focus the camera to a specific distance.
+   * @param {number} distance The distance to focus to. It should be lower than the minFocusDistance. Lower the value (closer to 0.001f), further the distance, higher the value (closer to the minFocusDistance), more macro the focus will be.
+   *
+   * Make sure the value doesn't exceed the device.minFocusDistance.
+   *
+   * @throws {@linkcode CameraRuntimeError} When any kind of error occured while focussing.
+   * Use the {@linkcode CameraRuntimeError.code | code} property to get the actual error
+   * @example
+   * ```ts
+   * await camera.current.focusDepth(5)
+   * ```
+   */
+  public async focusDepth(distance: number): Promise<void> {
+    try {
+      return await CameraModule.focusDepth(this.handle, distance)
+    } catch (e) {
+      throw tryParseNativeCameraError(e)
+    }
+  }
   //#endregion
 
   //#region Static Functions (NativeModule)