diff --git a/core/java/android/hardware/camera2/CameraCharacteristics.java b/core/java/android/hardware/camera2/CameraCharacteristics.java index afea4e5f35e38..96a18dcac92a7 100644 --- a/core/java/android/hardware/camera2/CameraCharacteristics.java +++ b/core/java/android/hardware/camera2/CameraCharacteristics.java @@ -1325,7 +1325,7 @@ public final class CameraCharacteristics extends CameraMetadata + * The value for this key will be null for devices with no flash unit.

*

Optional - The value for this key may be {@code null} on some devices.

*/ @PublicKey @@ -1337,14 +1337,15 @@ public final class CameraCharacteristics extends CameraMetadataDefault flashlight brightness level to be set via * {android.hardware.camera2.CameraManager#setTorchStrengthLevel}.

*

If flash unit is available this will be greater than or equal to 1 and less - * or equal to {@link CameraCharacteristics#FLASH_INFO_STRENGTH_MAXIMUM_LEVEL android.flash.info.strengthMaximumLevel}. - * If flash unit is not available this will be set to -1.

+ * or equal to {@link CameraCharacteristics#FLASH_INFO_STRENGTH_MAXIMUM_LEVEL android.flash.info.strengthMaximumLevel}.

*

Setting flashlight brightness above the default level * (i.e.{@link CameraCharacteristics#FLASH_INFO_STRENGTH_DEFAULT_LEVEL android.flash.info.strengthDefaultLevel}) may make the device more * likely to reach thermal throttling conditions and slow down, or drain the * battery quicker than normal. To minimize such issues, it is recommended to * start the flashlight at this default brightness until a user explicitly requests - * a brighter level.

+ * a brighter level. + * Note that the value for this key will be null for devices with no flash unit. + * The default level should always be > 0.

*

Optional - The value for this key may be {@code null} on some devices.

* * @see CameraCharacteristics#FLASH_INFO_STRENGTH_DEFAULT_LEVEL