java.lang.Object | |
↳ | android.hardware.camera2.CaptureFailure |
A report of failed capture for a single image capture from the image sensor.
CaptureFailures are produced by a CameraDevice
if processing a
CaptureRequest
fails, either partially or fully. Use getReason()
to determine the specific nature of the failed capture.
Receiving a CaptureFailure means that the metadata associated with that frame number
has been dropped -- no CaptureResult
with the same frame number will be
produced.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | REASON_ERROR | The CaptureResult has been dropped this frame only due to an error
in the framework. |
|||||||||
int | REASON_FLUSHED | The capture has failed due to a flush() call from the application. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Get the frame number associated with this failed capture.
| |||||||||||
Determine why the request was dropped, whether due to an error or to a user
action.
| |||||||||||
Get the request associated with this failed capture.
| |||||||||||
The sequence ID for this failed capture that was returned by the
capture(CaptureRequest, CameraDevice.CaptureListener, Handler) family of functions. | |||||||||||
Determine if the image was captured from the camera.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
The CaptureResult
has been dropped this frame only due to an error
in the framework.
The capture has failed due to a flush()
call from the application.
Get the frame number associated with this failed capture.
Whenever a request has been processed, regardless of failed capture or success, it gets a unique frame number assigned to its future result/failed capture.
This value monotonically increments, starting with 0,
for every new result or failure; and the scope is the lifetime of the
CameraDevice
.
Determine why the request was dropped, whether due to an error or to a user action.
REASON_*
integer constants.Get the request associated with this failed capture.
Whenever a request is unsuccessfully captured, with
onCaptureFailed(CameraDevice, CaptureRequest, CaptureFailure)
,
the failed capture
's getRequest()
will return that request
.
In particular,
cameraDevice.capture(someRequest, new CaptureListener() {
@Override
void onCaptureFailed(CaptureRequest myRequest, CaptureFailure myFailure) {
assert(myFailure.getRequest.equals(myRequest) == true);
}
};
null
.
The sequence ID for this failed capture that was returned by the
capture(CaptureRequest, CameraDevice.CaptureListener, Handler)
family of functions.
The sequence ID is a unique monotonically increasing value starting from 0, incremented every time a new group of requests is submitted to the CameraDevice.
Determine if the image was captured from the camera.
If the image was not captured, no image buffers will be available. If the image was captured, then image buffers may be available.