Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 38569bd5 authored by Ravneet Dhanjal's avatar Ravneet Dhanjal Committed by Android (Google) Code Review
Browse files

Merge "Camera: Add AE priority mode tags" into main

parents 1d965560 04106bb8

core/api/current.txt

+6 −0
Original line number Diff line number Diff line
@@ -19373,6 +19373,7 @@ package android.hardware.camera2 { 
    field @FlaggedApi("com.android.internal.camera.flags.color_temperature") @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<android.util.Range<java.lang.Integer>> COLOR_CORRECTION_COLOR_TEMPERATURE_RANGE;

    field @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<int[]> CONTROL_AE_AVAILABLE_ANTIBANDING_MODES;

    field @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<int[]> CONTROL_AE_AVAILABLE_MODES;

    field @FlaggedApi("com.android.internal.camera.flags.ae_priority") @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<int[]> CONTROL_AE_AVAILABLE_PRIORITY_MODES;

    field @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<android.util.Range<java.lang.Integer>[]> CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES;

    field @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<android.util.Range<java.lang.Integer>> CONTROL_AE_COMPENSATION_RANGE;

    field @NonNull public static final android.hardware.camera2.CameraCharacteristics.Key<android.util.Rational> CONTROL_AE_COMPENSATION_STEP;
@@ -19690,6 +19691,9 @@ package android.hardware.camera2 { 
    field public static final int CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL = 2; // 0x2

    field public static final int CONTROL_AE_PRECAPTURE_TRIGGER_IDLE = 0; // 0x0

    field public static final int CONTROL_AE_PRECAPTURE_TRIGGER_START = 1; // 0x1

    field @FlaggedApi("com.android.internal.camera.flags.ae_priority") public static final int CONTROL_AE_PRIORITY_MODE_OFF = 0; // 0x0

    field @FlaggedApi("com.android.internal.camera.flags.ae_priority") public static final int CONTROL_AE_PRIORITY_MODE_SENSOR_EXPOSURE_TIME_PRIORITY = 2; // 0x2

    field @FlaggedApi("com.android.internal.camera.flags.ae_priority") public static final int CONTROL_AE_PRIORITY_MODE_SENSOR_SENSITIVITY_PRIORITY = 1; // 0x1

    field public static final int CONTROL_AE_STATE_CONVERGED = 2; // 0x2

    field public static final int CONTROL_AE_STATE_FLASH_REQUIRED = 4; // 0x4

    field public static final int CONTROL_AE_STATE_INACTIVE = 0; // 0x0
@@ -19974,6 +19978,7 @@ package android.hardware.camera2 { 
    field @NonNull public static final android.hardware.camera2.CaptureRequest.Key<java.lang.Boolean> CONTROL_AE_LOCK;

    field @NonNull public static final android.hardware.camera2.CaptureRequest.Key<java.lang.Integer> CONTROL_AE_MODE;

    field @NonNull public static final android.hardware.camera2.CaptureRequest.Key<java.lang.Integer> CONTROL_AE_PRECAPTURE_TRIGGER;

    field @FlaggedApi("com.android.internal.camera.flags.ae_priority") @NonNull public static final android.hardware.camera2.CaptureRequest.Key<java.lang.Integer> CONTROL_AE_PRIORITY_MODE;

    field @NonNull public static final android.hardware.camera2.CaptureRequest.Key<android.hardware.camera2.params.MeteringRectangle[]> CONTROL_AE_REGIONS;

    field @NonNull public static final android.hardware.camera2.CaptureRequest.Key<android.util.Range<java.lang.Integer>> CONTROL_AE_TARGET_FPS_RANGE;

    field @NonNull public static final android.hardware.camera2.CaptureRequest.Key<java.lang.Integer> CONTROL_AF_MODE;
@@ -20067,6 +20072,7 @@ package android.hardware.camera2 { 
    field @NonNull public static final android.hardware.camera2.CaptureResult.Key<java.lang.Boolean> CONTROL_AE_LOCK;

    field @NonNull public static final android.hardware.camera2.CaptureResult.Key<java.lang.Integer> CONTROL_AE_MODE;

    field @NonNull public static final android.hardware.camera2.CaptureResult.Key<java.lang.Integer> CONTROL_AE_PRECAPTURE_TRIGGER;

    field @FlaggedApi("com.android.internal.camera.flags.ae_priority") @NonNull public static final android.hardware.camera2.CaptureResult.Key<java.lang.Integer> CONTROL_AE_PRIORITY_MODE;

    field @NonNull public static final android.hardware.camera2.CaptureResult.Key<android.hardware.camera2.params.MeteringRectangle[]> CONTROL_AE_REGIONS;

    field @NonNull public static final android.hardware.camera2.CaptureResult.Key<java.lang.Integer> CONTROL_AE_STATE;

    field @NonNull public static final android.hardware.camera2.CaptureResult.Key<android.util.Range<java.lang.Integer>> CONTROL_AE_TARGET_FPS_RANGE;

core/java/android/hardware/camera2/CameraCharacteristics.java

+18 −0
Original line number Diff line number Diff line
@@ -1435,6 +1435,24 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
    public static final Key<android.util.Range<Float>> CONTROL_LOW_LIGHT_BOOST_INFO_LUMINANCE_RANGE =

            new Key<android.util.Range<Float>>("android.control.lowLightBoostInfoLuminanceRange", new TypeReference<android.util.Range<Float>>() {{ }});



    /**

     * <p>List of auto-exposure priority modes for {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode}

     * that are supported by this camera device.</p>

     * <p>This entry lists the valid modes for

     * {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} for this camera device.

     * If no AE priority modes are available for a device, this will only list OFF.</p>

     * <p><b>Range of valid values:</b><br>

     * Any value listed in {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode}</p>

     * <p><b>Optional</b> - The value for this key may be {@code null} on some devices.</p>

     *

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     */

    @PublicKey

    @NonNull

    @FlaggedApi(Flags.FLAG_AE_PRIORITY)

    public static final Key<int[]> CONTROL_AE_AVAILABLE_PRIORITY_MODES =

            new Key<int[]>("android.control.aeAvailablePriorityModes", int[].class);



    /**

     * <p>List of edge enhancement modes for {@link CaptureRequest#EDGE_MODE android.edge.mode} that are supported by this camera

     * device.</p>

core/java/android/hardware/camera2/CameraMetadata.java

+42 −0
Original line number Diff line number Diff line
@@ -3396,6 +3396,48 @@ public abstract class CameraMetadata<TKey> { 
    @FlaggedApi(Flags.FLAG_ZOOM_METHOD)

    public static final int CONTROL_ZOOM_METHOD_ZOOM_RATIO = 1;



    //

    // Enumeration values for CaptureRequest#CONTROL_AE_PRIORITY_MODE

    //



    /**

     * <p>Disable AE priority mode. This is the default value.</p>

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     */

    @FlaggedApi(Flags.FLAG_AE_PRIORITY)

    public static final int CONTROL_AE_PRIORITY_MODE_OFF = 0;



    /**

     * <p>The camera device's auto-exposure routine is active and

     * prioritizes the application-selected ISO ({@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}).</p>

     * <p>The application has control over {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity} while

     * the application's values for {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime} and

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration} are ignored.</p>

     *

     * @see CaptureRequest#SENSOR_EXPOSURE_TIME

     * @see CaptureRequest#SENSOR_FRAME_DURATION

     * @see CaptureRequest#SENSOR_SENSITIVITY

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     */

    @FlaggedApi(Flags.FLAG_AE_PRIORITY)

    public static final int CONTROL_AE_PRIORITY_MODE_SENSOR_SENSITIVITY_PRIORITY = 1;



    /**

     * <p>The camera device's auto-exposure routine is active and

     * prioritizes the application-selected exposure time

     * ({@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}).</p>

     * <p>The application has control over {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime} while

     * the application's values for {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity} and

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration} are ignored.</p>

     *

     * @see CaptureRequest#SENSOR_EXPOSURE_TIME

     * @see CaptureRequest#SENSOR_FRAME_DURATION

     * @see CaptureRequest#SENSOR_SENSITIVITY

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     */

    @FlaggedApi(Flags.FLAG_AE_PRIORITY)

    public static final int CONTROL_AE_PRIORITY_MODE_SENSOR_EXPOSURE_TIME_PRIORITY = 2;



    //

    // Enumeration values for CaptureRequest#EDGE_MODE

    //

core/java/android/hardware/camera2/CaptureRequest.java

+52 −3
Original line number Diff line number Diff line
@@ -1406,7 +1406,9 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * application's selected exposure time, sensor sensitivity,

     * and frame duration ({@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime},

     * {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}, and

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}). If one of the FLASH modes

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}). If {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} is

     * enabled, the relevant priority CaptureRequest settings will not be overridden.

     * See {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} for more details. If one of the FLASH modes

     * is selected, the camera device's flash unit controls are

     * also overridden.</p>

     * <p>The FLASH modes are only available if the camera device
@@ -1440,6 +1442,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     *

     * @see CameraCharacteristics#CONTROL_AE_AVAILABLE_MODES

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CameraCharacteristics#FLASH_INFO_AVAILABLE

     * @see CaptureRequest#FLASH_MODE
@@ -2705,6 +2708,46 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    public static final Key<Integer> CONTROL_ZOOM_METHOD =

            new Key<Integer>("android.control.zoomMethod", int.class);



    /**

     * <p>Turn on AE priority mode.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_MODE android.control.mode} is

     * AUTO and {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} is set to one of its

     * ON modes, with the exception of ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY.</p>

     * <p>When a priority mode is enabled, the camera device's

     * auto-exposure routine will maintain the application's

     * selected parameters relevant to the priority mode while overriding

     * the remaining exposure parameters

     * ({@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}, {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}, and

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}). For example, if

     * SENSOR_SENSITIVITY_PRIORITY mode is enabled, the camera device will

     * maintain the application-selected {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}

     * while adjusting {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}

     * and {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}. The overridden fields for a

     * given capture will be available in its CaptureResult.</p>

     * <p><b>Possible values:</b></p>

     * <ul>

     *   <li>{@link #CONTROL_AE_PRIORITY_MODE_OFF OFF}</li>

     *   <li>{@link #CONTROL_AE_PRIORITY_MODE_SENSOR_SENSITIVITY_PRIORITY SENSOR_SENSITIVITY_PRIORITY}</li>

     *   <li>{@link #CONTROL_AE_PRIORITY_MODE_SENSOR_EXPOSURE_TIME_PRIORITY SENSOR_EXPOSURE_TIME_PRIORITY}</li>

     * </ul>

     *

     * <p><b>Optional</b> - The value for this key may be {@code null} on some devices.</p>

     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CaptureRequest#SENSOR_EXPOSURE_TIME

     * @see CaptureRequest#SENSOR_FRAME_DURATION

     * @see CaptureRequest#SENSOR_SENSITIVITY

     * @see #CONTROL_AE_PRIORITY_MODE_OFF

     * @see #CONTROL_AE_PRIORITY_MODE_SENSOR_SENSITIVITY_PRIORITY

     * @see #CONTROL_AE_PRIORITY_MODE_SENSOR_EXPOSURE_TIME_PRIORITY

     */

    @PublicKey

    @NonNull

    @FlaggedApi(Flags.FLAG_AE_PRIORITY)

    public static final Key<Integer> CONTROL_AE_PRIORITY_MODE =

            new Key<Integer>("android.control.aePriorityMode", int.class);



    /**

     * <p>Operation mode for edge

     * enhancement.</p>
@@ -3527,7 +3570,9 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * duration exposed to the nearest possible value (rather than expose longer).

     * The final exposure time used will be available in the output capture result.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} or {@link CaptureRequest#CONTROL_MODE android.control.mode} is set to

     * OFF; otherwise the auto-exposure algorithm will override this value.</p>

     * OFF; otherwise the auto-exposure algorithm will override this value. However, in the

     * case that {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} is set to SENSOR_EXPOSURE_TIME_PRIORITY, this

     * control will be effective and not controlled by the auto-exposure algorithm.</p>

     * <p><b>Units</b>: Nanoseconds</p>

     * <p><b>Range of valid values:</b><br>

     * {@link CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE android.sensor.info.exposureTimeRange}</p>
@@ -3537,6 +3582,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel} key</p>

     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL

     * @see CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE
@@ -3645,7 +3691,9 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * value. The final sensitivity used will be available in the

     * output capture result.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} or {@link CaptureRequest#CONTROL_MODE android.control.mode} is set to

     * OFF; otherwise the auto-exposure algorithm will override this value.</p>

     * OFF; otherwise the auto-exposure algorithm will override this value. However, in the

     * case that {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} is set to SENSOR_SENSITIVITY_PRIORITY, this

     * control will be effective and not controlled by the auto-exposure algorithm.</p>

     * <p>Note that for devices supporting postRawSensitivityBoost, the total sensitivity applied

     * to the final processed image is the combination of {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity} and

     * {@link CaptureRequest#CONTROL_POST_RAW_SENSITIVITY_BOOST android.control.postRawSensitivityBoost}. In case the application uses the sensor
@@ -3661,6 +3709,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel} key</p>

     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CaptureRequest#CONTROL_POST_RAW_SENSITIVITY_BOOST

     * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL

core/java/android/hardware/camera2/CaptureResult.java

+52 −3
Original line number Diff line number Diff line
@@ -807,7 +807,9 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
     * application's selected exposure time, sensor sensitivity,

     * and frame duration ({@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime},

     * {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}, and

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}). If one of the FLASH modes

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}). If {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} is

     * enabled, the relevant priority CaptureRequest settings will not be overridden.

     * See {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} for more details. If one of the FLASH modes

     * is selected, the camera device's flash unit controls are

     * also overridden.</p>

     * <p>The FLASH modes are only available if the camera device
@@ -841,6 +843,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
     *

     * @see CameraCharacteristics#CONTROL_AE_AVAILABLE_MODES

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CameraCharacteristics#FLASH_INFO_AVAILABLE

     * @see CaptureRequest#FLASH_MODE
@@ -2952,6 +2955,46 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
    public static final Key<Integer> CONTROL_ZOOM_METHOD =

            new Key<Integer>("android.control.zoomMethod", int.class);



    /**

     * <p>Turn on AE priority mode.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_MODE android.control.mode} is

     * AUTO and {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} is set to one of its

     * ON modes, with the exception of ON_LOW_LIGHT_BOOST_BRIGHTNESS_PRIORITY.</p>

     * <p>When a priority mode is enabled, the camera device's

     * auto-exposure routine will maintain the application's

     * selected parameters relevant to the priority mode while overriding

     * the remaining exposure parameters

     * ({@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}, {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}, and

     * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}). For example, if

     * SENSOR_SENSITIVITY_PRIORITY mode is enabled, the camera device will

     * maintain the application-selected {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}

     * while adjusting {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}

     * and {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}. The overridden fields for a

     * given capture will be available in its CaptureResult.</p>

     * <p><b>Possible values:</b></p>

     * <ul>

     *   <li>{@link #CONTROL_AE_PRIORITY_MODE_OFF OFF}</li>

     *   <li>{@link #CONTROL_AE_PRIORITY_MODE_SENSOR_SENSITIVITY_PRIORITY SENSOR_SENSITIVITY_PRIORITY}</li>

     *   <li>{@link #CONTROL_AE_PRIORITY_MODE_SENSOR_EXPOSURE_TIME_PRIORITY SENSOR_EXPOSURE_TIME_PRIORITY}</li>

     * </ul>

     *

     * <p><b>Optional</b> - The value for this key may be {@code null} on some devices.</p>

     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CaptureRequest#SENSOR_EXPOSURE_TIME

     * @see CaptureRequest#SENSOR_FRAME_DURATION

     * @see CaptureRequest#SENSOR_SENSITIVITY

     * @see #CONTROL_AE_PRIORITY_MODE_OFF

     * @see #CONTROL_AE_PRIORITY_MODE_SENSOR_SENSITIVITY_PRIORITY

     * @see #CONTROL_AE_PRIORITY_MODE_SENSOR_EXPOSURE_TIME_PRIORITY

     */

    @PublicKey

    @NonNull

    @FlaggedApi(Flags.FLAG_AE_PRIORITY)

    public static final Key<Integer> CONTROL_AE_PRIORITY_MODE =

            new Key<Integer>("android.control.aePriorityMode", int.class);



    /**

     * <p>Operation mode for edge

     * enhancement.</p>
@@ -4237,7 +4280,9 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
     * duration exposed to the nearest possible value (rather than expose longer).

     * The final exposure time used will be available in the output capture result.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} or {@link CaptureRequest#CONTROL_MODE android.control.mode} is set to

     * OFF; otherwise the auto-exposure algorithm will override this value.</p>

     * OFF; otherwise the auto-exposure algorithm will override this value. However, in the

     * case that {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} is set to SENSOR_EXPOSURE_TIME_PRIORITY, this

     * control will be effective and not controlled by the auto-exposure algorithm.</p>

     * <p><b>Units</b>: Nanoseconds</p>

     * <p><b>Range of valid values:</b><br>

     * {@link CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE android.sensor.info.exposureTimeRange}</p>
@@ -4247,6 +4292,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
     * {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel} key</p>

     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL

     * @see CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE
@@ -4355,7 +4401,9 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
     * value. The final sensitivity used will be available in the

     * output capture result.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} or {@link CaptureRequest#CONTROL_MODE android.control.mode} is set to

     * OFF; otherwise the auto-exposure algorithm will override this value.</p>

     * OFF; otherwise the auto-exposure algorithm will override this value. However, in the

     * case that {@link CaptureRequest#CONTROL_AE_PRIORITY_MODE android.control.aePriorityMode} is set to SENSOR_SENSITIVITY_PRIORITY, this

     * control will be effective and not controlled by the auto-exposure algorithm.</p>

     * <p>Note that for devices supporting postRawSensitivityBoost, the total sensitivity applied

     * to the final processed image is the combination of {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity} and

     * {@link CaptureRequest#CONTROL_POST_RAW_SENSITIVITY_BOOST android.control.postRawSensitivityBoost}. In case the application uses the sensor
@@ -4371,6 +4419,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> { 
     * {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel} key</p>

     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AE_PRIORITY_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see CaptureRequest#CONTROL_POST_RAW_SENSITIVITY_BOOST

     * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL