Package: android.hardware.camera.device@3.4

ICameraDeviceSession

interface ICameraDeviceSession extends @3.3::ICameraDeviceSession

Camera device active session interface.

Obtained via ICameraDevice::open(), this interface contains the methods to configure and request captures from an active camera device.

Methods

configureStreams_3_4

configureStreams_3_4 (@3.4::StreamConfiguration requestedConfiguration)
generates (Status status, @3.4::HalStreamConfiguration halConfiguration)

configureStreams_3_4:

Identical to@3.3::ICameraDeviceSession.configureStreams, except that:

- The requested configuration includes session parameters.

Details
Parameters
requestedConfiguration
Generates
status
halConfiguration
The stream parameters desired by the HAL for each stream, including maximum buffers, the usage flags, and the override format.

processCaptureRequest_3_4

processCaptureRequest_3_4 (vec<CaptureRequest> requests, vec<BufferCache> cachesToRemove)
generates (Status status, uint32_t numRequestProcessed)

processCaptureRequest_3_4:

Identical to@3.2::ICameraDeviceSession.processCaptureRequest, except that:

- The capture request can include individual settings for physical camera devices backing a logical multi-camera.

Details
Parameters
requests
cachesToRemove
Generates
status
Status code for the operation, one of:OK:On a successful start to processing the capture request ILLEGAL_ARGUMENT:If the input is malformed(the settings are empty when not allowed, the physical camera settings are invalid, there are 0 output buffers, etc)and capture processing cannot start.Failures during request processing must be handled by calling ICameraDeviceCallback::notify().In case of this error, the framework retains responsibility for the stream buffers' fences and the buffer handles;the HAL must not close the fences or return these buffers with ICameraDeviceCallback::processCaptureResult().INTERNAL_ERROR:If the camera device has encountered a serious error.After this error is returned, only the close() method can be successfully called by the framework.
numRequestProcessed
Number of requests successfully processed by camera HAL.When status is OK, this must be equal to the size of requests.When the call fails, this number is the number of requests that HAL processed successfully before HAL runs into an error.