public class CaptureFailure
extends Object
| java.lang.Object | |
| ↳ | android.hardware.camera2.CaptureFailure |
来自图像传感器的单个图像捕获失败的捕获报告。
如果处理CaptureRequest部分或全部失败，CaptureFailures将由CameraDevice生成。 使用getReason()来确定失败捕获的特定性质。
接收CaptureFailure意味着与该帧编号关联的元数据已被删除 - 不会 CaptureResult具有相同帧编号的 CaptureResult 。
Constants |
|
|---|---|
int |
REASON_ERROR 由于框架中的错误， |
int |
REASON_FLUSHED 由于来自应用程序的 |
Public methods |
|
|---|---|
long |
getFrameNumber() 获取与此失败捕获相关的帧号。 |
int |
getReason() 确定请求被删除的原因，无论是由于错误还是用户操作。 |
CaptureRequest |
getRequest() 获取与此失败捕获相关的请求。 |
int |
getSequenceId()
|
boolean |
wasImageCaptured() 确定图像是否从相机中捕获。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
int REASON_ERROR
由于框架中的错误， CaptureResult只能丢弃此帧。
也可以看看：
常量值：0（0x00000000）
int REASON_FLUSHED
由于来自应用程序的 abortCaptures()调用，捕获失败。
也可以看看：
常数值：1（0x00000001）
long getFrameNumber ()
获取与此失败捕获相关的帧号。
无论何时处理完请求，无论捕获失败或成功，它都会获得分配给其未来结果/失败捕获的唯一帧号。
对于每个新的结果或失败，该值从0开始单调递增; 范围是CameraDevice的使用CameraDevice 。
| Returns | |
|---|---|
long |
long frame number |
int getReason ()
确定请求被删除的原因，无论是由于错误还是用户操作。
| Returns | |
|---|---|
int |
int One of REASON_* integer constants. |
也可以看看：
CaptureRequest getRequest ()
获取与此失败捕获相关的请求。
每当一个请求被捕获失败，与 onCaptureFailed(CameraCaptureSession, CaptureRequest, CaptureFailure) ，该 failed capture的 getRequest()将返回 request 。
特别是
Android开发手册cameraDevice.capture(someRequest, new CaptureCallback() {
@Override
void onCaptureFailed(CaptureRequest myRequest, CaptureFailure myFailure) {
assert(myFailure.getRequest.equals(myRequest) == true);
}
};
| Returns | |
|---|---|
CaptureRequest |
The request associated with this failed capture. Never null. |
int getSequenceId ()
capture(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler)系列函数返回的失败捕获的序列ID。
序列ID是一个从0开始的唯一单调增加的值，每次向CameraDevice提交一组新请求时递增。
| Returns | |
|---|---|
int |
int The ID for the sequence of requests that this capture failure is the result of |
boolean wasImageCaptured ()
确定图像是否从相机中捕获。
如果图像未被捕获，则不会有图像缓冲区可用。 如果图像被捕获，则图像缓冲区可能可用。
| Returns | |
|---|---|
boolean |
boolean True if the image was captured, false otherwise. |