diff --git a/core/java/android/hardware/camera2/CaptureRequest.java b/core/java/android/hardware/camera2/CaptureRequest.java index 1cf8f0314980d..279d73d215e36 100644 --- a/core/java/android/hardware/camera2/CaptureRequest.java +++ b/core/java/android/hardware/camera2/CaptureRequest.java @@ -1662,9 +1662,13 @@ public final class CaptureRequest extends CameraMetadata> *

The output images for request B may have contents captured before the output images for * request A, and the result metadata for request B may be older than the result metadata for * request A.

- *

Note that when enableZsl is true, it is not guaranteed to get output images captured in the - * past for requests with STILL_CAPTURE capture intent.

- *

The value of enableZsl in capture templates is always false if present.

+ *

Note that when enableZsl is true, it is not guaranteed to get output images captured in + * the past for requests with STILL_CAPTURE capture intent.

+ *

For applications targeting SDK versions O and newer, the value of enableZsl in + * TEMPLATE_STILL_CAPTURE template may be true. The value in other templates is always + * false if present.

+ *

For applications targeting SDK versions older than O, the value of enableZsl in all + * capture templates is always false if present.

*

Optional - This value may be {@code null} on some devices.

* * @see CaptureRequest#CONTROL_CAPTURE_INTENT diff --git a/core/java/android/hardware/camera2/CaptureResult.java b/core/java/android/hardware/camera2/CaptureResult.java index 419e3e28d36d9..aedfc4b702a71 100644 --- a/core/java/android/hardware/camera2/CaptureResult.java +++ b/core/java/android/hardware/camera2/CaptureResult.java @@ -2167,9 +2167,13 @@ public class CaptureResult extends CameraMetadata> { *

The output images for request B may have contents captured before the output images for * request A, and the result metadata for request B may be older than the result metadata for * request A.

- *

Note that when enableZsl is true, it is not guaranteed to get output images captured in the - * past for requests with STILL_CAPTURE capture intent.

- *

The value of enableZsl in capture templates is always false if present.

+ *

Note that when enableZsl is true, it is not guaranteed to get output images captured in + * the past for requests with STILL_CAPTURE capture intent.

+ *

For applications targeting SDK versions O and newer, the value of enableZsl in + * TEMPLATE_STILL_CAPTURE template may be true. The value in other templates is always + * false if present.

+ *

For applications targeting SDK versions older than O, the value of enableZsl in all + * capture templates is always false if present.

*

Optional - This value may be {@code null} on some devices.

* * @see CaptureRequest#CONTROL_CAPTURE_INTENT