Android 12 Developer Preview is here! Try it out, and give us your feedback!


public static abstract class ImageCapture.OnImageCapturedCallback
extends Object


Callback for when an image capture has completed.


Public constructors


Public methods

void onCaptureSuccess(ImageProxy image)

Callback for when the image has been captured.

void onError(ImageCaptureException exception)

Callback for when an error occurred during image capture.

Inherited methods

Public constructors


public OnImageCapturedCallback ()

Public methods


public void onCaptureSuccess (ImageProxy image)

Callback for when the image has been captured.

The application is responsible for calling ImageProxy.close() to close the image.

The image is of format ImageFormat.JPEG, queryable via ImageProxy.getFormat().

The image is provided as captured by the underlying ImageReader without rotation applied. The value in image.getImageInfo().getRotationDegrees() describes the magnitude of clockwise rotation, which if applied to the image will make it match the currently configured target rotation.

For example, if the current target rotation is set to the display rotation, rotationDegrees is the rotation to apply to the image to match the display orientation. A rotation of 90 degrees would mean rotating the image 90 degrees clockwise produces an image that will match the display orientation.

See also ImageCapture.setTargetRotation(int) and ImageCapture.setTargetRotation(int).

Timestamps are in nanoseconds and monotonic and can be compared to timestamps from images produced from UseCases bound to the same camera instance. More detail is available depending on the implementation. For example with CameraX using a implementation additional detail can be found in CameraDevice documentation.

image ImageProxy: The captured image


public void onError (ImageCaptureException exception)

Callback for when an error occurred during image capture.

exception ImageCaptureException: An ImageCaptureException that contains the type of error, the error message and the throwable that caused it.