See Also: CaptureRequest Members
An immutable package of settings and outputs needed to capture a single image from the camera device.
Contains the configuration for the capture hardware (sensor, lens, flash), the processing pipeline, the control algorithms, and the output buffers. Also contains the list of target Surfaces to send image data to for this capture.
CaptureRequests can be created by using a NoType:android/hardware/camera2/CaptureRequest$Builder;Href=../../../../reference/android/hardware/camera2/CaptureRequest.Builder.html instance, obtained by calling CameraDevice.CreateCaptureRequest(CameraTemplate)
CaptureRequests are given to CameraCaptureSession.Capture(CaptureRequest, .CaptureCallback, .CaptureCallback) or CameraCaptureSession.SetRepeatingRequest(CaptureRequest, .CaptureCallback, .CaptureCallback) to capture images from a camera.
Each request can specify a different subset of target Surfaces for the camera to send the captured data to. All the surfaces used in a request must be part of the surface list given to the last call to CameraDevice.createCaptureSession(java.util.List<android.view.Surface>, android.hardware.camera2.CameraCaptureSession.StateCallback, android.os.Handler), when the request is submitted to the session.
For example, a request meant for repeating preview might only include the Surface for the preview SurfaceView or SurfaceTexture, while a high-resolution still capture would also include a Surface from a ImageReader configured for high-resolution JPEG images.