[camera] Allow logical cameras to use all physical cameras via zoom on android 11+

packages/camera/camera_android/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.10.0+1
+
+* Fixes issues with Virtual cameras hiding physical cameras in android 11+.
+
 ## 0.10.0
 
 * **Breaking Change** Updates Android camera access permission error codes to be consistent with other platforms. If your app still handles the legacy `cameraPermission` exception, please update it to handle the new permission exception codes that are noted in the README.

packages/camera/camera_android/android/build.gradle

@@ -59,6 +59,7 @@ android {
 }
 
 dependencies {
+    testImplementation project(path: ':camera_android')
     compileOnly 'androidx.annotation:annotation:1.1.0'
     testImplementation 'junit:junit:4.13.2'
     testImplementation 'org.mockito:mockito-inline:4.6.1'

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

@@ -147,13 +147,35 @@ public interface CameraProperties {
    * height and crop region height, for @see android.scaler.cropRegion.
    *
    * <p>By default maps to the @see
-   * android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM key.
+   * android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM key
    *
    * @return Float Maximum ratio between both active area width and crop region width, and active
-   *     area height and crop region height
+   *     area height and crop region height.
    */
   Float getScalerAvailableMaxDigitalZoom();
 
+  /**
+   * Returns the minimum ratio between the default camera zoom setting and all of the available zoom
+   *
+   * <p>By default maps to the @see
+   * android.hardware.camera2.CameraCharacteristics#CONTROL_ZOOM_RATIO_RANGE key's lower value.
+   *
+   * @return Float Minimum ratio between the default zoom ratio and the maximum possible zoom
+   */
+  @RequiresApi(api = VERSION_CODES.R)
+  Float getScalerMinZoomRatio();
+
+  /**
+   * Returns the maximum ratio between the default camera zoom setting and all of the available zoom
+   *
+   * <p>By default maps to the @see
+   * android.hardware.camera2.CameraCharacteristics#CONTROL_ZOOM_RATIO_RANGE key's upper value.
+   *
+   * @return Float Maximum ratio between the default zoom ratio and the maximum possible zoom
+   */
+  @RequiresApi(api = VERSION_CODES.R)
+  Float getScalerMaxZoomRatio();
+
   /**
    * Returns the area of the image sensor which corresponds to active pixels after any geometric
    * distortion correction has been applied.
@@ -315,6 +337,18 @@ public Float getScalerAvailableMaxDigitalZoom() {
     return cameraCharacteristics.get(CameraCharacteristics.SCALER_AVAILABLE_MAX_DIGITAL_ZOOM);
   }
 
+  @RequiresApi(api = VERSION_CODES.R)
+  @Override
+  public Float getScalerMaxZoomRatio() {
+    return cameraCharacteristics.get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE).getUpper();
+  }
+
+  @RequiresApi(api = VERSION_CODES.R)
+  @Override
+  public Float getScalerMinZoomRatio() {
+    return cameraCharacteristics.get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE).getLower();
+  }
+
   @Override
   public Rect getSensorInfoActiveArraySize() {
     return cameraCharacteristics.get(CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE);

packages/camera/camera_android/android/src/main/java/io/flutter/plugins/camera/features/zoomlevel/ZoomLevelFeature.java

@@ -6,16 +6,17 @@
 
 import android.graphics.Rect;
 import android.hardware.camera2.CaptureRequest;
+import android.os.Build;
 import io.flutter.plugins.camera.CameraProperties;
 import io.flutter.plugins.camera.features.CameraFeature;
 
 /** Controls the zoom configuration on the {@link android.hardware.camera2} API. */
 public class ZoomLevelFeature extends CameraFeature<Float> {
-  private static final float MINIMUM_ZOOM_LEVEL = 1.0f;
   private final boolean hasSupport;
   private final Rect sensorArraySize;
-  private Float currentSetting = MINIMUM_ZOOM_LEVEL;
-  private Float maximumZoomLevel = MINIMUM_ZOOM_LEVEL;
+  private Float currentSetting = 1.0f;
+  private Float minimumZoomLevel = currentSetting;
+  private Float maximumZoomLevel;
 
   /**
    * Creates a new instance of the {@link ZoomLevelFeature}.
@@ -28,18 +29,24 @@ public ZoomLevelFeature(CameraProperties cameraProperties) {
     sensorArraySize = cameraProperties.getSensorInfoActiveArraySize();
 
     if (sensorArraySize == null) {
-      maximumZoomLevel = MINIMUM_ZOOM_LEVEL;
+      maximumZoomLevel = minimumZoomLevel;
       hasSupport = false;
       return;
     }
 
-    Float maxDigitalZoom = cameraProperties.getScalerAvailableMaxDigitalZoom();
-    maximumZoomLevel =
-        ((maxDigitalZoom == null) || (maxDigitalZoom < MINIMUM_ZOOM_LEVEL))
-            ? MINIMUM_ZOOM_LEVEL
-            : maxDigitalZoom;
+    if (Build.VERSION.SDK_INT > Build.VERSION_CODES.R) {
+      minimumZoomLevel = cameraProperties.getScalerMinZoomRatio();
+      maximumZoomLevel = cameraProperties.getScalerMaxZoomRatio();
+    } else {
+      minimumZoomLevel = 1.0f;
+      Float maxDigitalZoom = cameraProperties.getScalerAvailableMaxDigitalZoom();
+      maximumZoomLevel =
+          ((maxDigitalZoom == null) || (maxDigitalZoom < minimumZoomLevel))
+              ? minimumZoomLevel
+              : maxDigitalZoom;
+    }
 
-    hasSupport = (Float.compare(maximumZoomLevel, MINIMUM_ZOOM_LEVEL) > 0);
+    hasSupport = (Float.compare(maximumZoomLevel, minimumZoomLevel) > 0);
   }
 
   @Override
@@ -67,11 +74,16 @@ public void updateBuilder(CaptureRequest.Builder requestBuilder) {
     if (!checkIsSupported()) {
       return;
     }
-
-    final Rect computedZoom =
-        ZoomUtils.computeZoom(
-            currentSetting, sensorArraySize, MINIMUM_ZOOM_LEVEL, maximumZoomLevel);
-    requestBuilder.set(CaptureRequest.SCALER_CROP_REGION, computedZoom);
+    if (Build.VERSION.SDK_INT > Build.VERSION_CODES.R) {
+      requestBuilder.set(
+          CaptureRequest.CONTROL_ZOOM_RATIO,
+          ZoomUtils.computeZoomRatio(currentSetting, minimumZoomLevel, maximumZoomLevel));
+    } else {
+      final Rect computedZoom =
+          ZoomUtils.computeZoomRect(
+              currentSetting, sensorArraySize, minimumZoomLevel, maximumZoomLevel);
+      requestBuilder.set(CaptureRequest.SCALER_CROP_REGION, computedZoom);
+    }
   }
 
   /**
@@ -80,7 +92,7 @@ public void updateBuilder(CaptureRequest.Builder requestBuilder) {
    * @return The minimum zoom level.
    */
   public float getMinimumZoomLevel() {
-    return MINIMUM_ZOOM_LEVEL;
+    return minimumZoomLevel;
   }
 
   /**

packages/camera/camera_android/android/src/main/java/io/flutter/plugins/camera/features/zoomlevel/ZoomUtils.java

@@ -26,7 +26,7 @@ final class ZoomUtils {
    * @param maximumZoomLevel The maximim supported zoom level.
    * @return An image sensor area based on the supplied zoom settings
    */
-  static Rect computeZoom(
+  static Rect computeZoomRect(
       float zoom, @NonNull Rect sensorArraySize, float minimumZoomLevel, float maximumZoomLevel) {
     final float newZoom = MathUtils.clamp(zoom, minimumZoomLevel, maximumZoomLevel);
 
@@ -37,4 +37,8 @@ static Rect computeZoom(
 
     return new Rect(centerX - deltaX, centerY - deltaY, centerX + deltaX, centerY + deltaY);
   }
+
+  static Float computeZoomRatio(float zoom, float minimumZoomLevel, float maximumZoomLevel) {
+    return MathUtils.clamp(zoom, minimumZoomLevel, maximumZoomLevel);
+  }
 }

packages/camera/camera_android/android/src/test/java/io/flutter/plugins/camera/CameraPropertiesImplTest.java

@@ -201,6 +201,30 @@ public void getScalerAvailableMaxDigitalZoomTest() {
     assertEquals(actualDigitalZoom, expectedDigitalZoom);
   }
 
+  @Test
+  public void getScalerGetScalerMinZoomRatioTest() {
+    Range zoomRange = mock(Range.class);
+    when(mockCharacteristics.get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE))
+        .thenReturn(zoomRange);
+
+    Float minZoom = cameraProperties.getScalerMinZoomRatio();
+
+    verify(mockCharacteristics, times(1)).get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE);
+    assertEquals(zoomRange.getLower(), minZoom);
+  }
+
+  @Test
+  public void getScalerGetScalerMaxZoomRatioTest() {
+    Range zoomRange = mock(Range.class);
+    when(mockCharacteristics.get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE))
+        .thenReturn(zoomRange);
+
+    Float maxZoom = cameraProperties.getScalerMaxZoomRatio();
+
+    verify(mockCharacteristics, times(1)).get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE);
+    assertEquals(zoomRange.getUpper(), maxZoom);
+  }
+
   @Test
   public void getSensorInfoActiveArraySizeTest() {
     Rect expectedArraySize = mock(Rect.class);

packages/camera/camera_android/android/src/test/java/io/flutter/plugins/camera/features/zoomlevel/ZoomLevelFeatureTest.java

@@ -40,7 +40,7 @@ public void before() {
     mockSensorArray = mock(Rect.class);
 
     mockedStaticCameraZoom
-        .when(() -> ZoomUtils.computeZoom(anyFloat(), any(), anyFloat(), anyFloat()))
+        .when(() -> ZoomUtils.computeZoomRect(anyFloat(), any(), anyFloat(), anyFloat()))
         .thenReturn(mockZoomArea);
   }