org.firstinspires.ftc.robotcore.external.hardware.camera

Interface Camera.StateCallback

All Known Implementing Classes:

Camera.StateCallbackDefault

Enclosing interface:

Camera

public static interface Camera.StateCallback

See Also:

android.hardware.camera2.CameraDevice.StateCallback

Method Summary

Modifier and Type	Method and Description
void	onClosed(Camera camera) The method called when a camera device has been closed with Camera.close().
void	onError(Camera camera, Camera.Error error) The method called when a camera device has encountered a serious error.
void	onOpened(Camera camera) The method called when a camera device has finished successfully opening.
void	onOpenFailed(CameraName cameraName, Camera.OpenFailure reason) A request to open a camera has failed.

Method Detail

onOpened

void onOpened(Camera camera)

The method called when a camera device has finished successfully opening.

At this point, the camera device is ready to use, and Camera.createCaptureSession(org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.hardware.camera.CameraCaptureSession.StateCallback>) can be called to set up a capture session.

Important: once this method is invoked, callee is responsible for calling Camera.close() when they are finished using the camera device.

Parameters:

camera - the camera device that has become opened

See Also:

CameraManager.asyncOpenCameraAssumingPermission(org.firstinspires.ftc.robotcore.external.hardware.camera.CameraName, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.hardware.camera.Camera.StateCallback>, long, java.util.concurrent.TimeUnit)

onOpenFailed

void onOpenFailed(CameraName cameraName,
                  Camera.OpenFailure reason)

A request to open a camera has failed.

Parameters:

cameraName - The identity of the camera that failed to open.

See Also:

CameraManager.asyncOpenCameraAssumingPermission(org.firstinspires.ftc.robotcore.external.hardware.camera.CameraName, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.hardware.camera.Camera.StateCallback>, long, java.util.concurrent.TimeUnit)

onClosed

void onClosed(Camera camera)

The method called when a camera device has been closed with Camera.close().

Any attempt to call methods on this Camera in the future will likely throw a RuntimeException.

Parameters:

camera - the camera device that has become closed

onError

void onError(Camera camera,
             Camera.Error error)

The method called when a camera device has encountered a serious error.

This indicates a failure of the camera device or camera service in some way. Any attempt to call methods on this Camera in the future will likely throw a CameraException

There may still be capture completion or camera stream callbacks that will be called after this error is received.

You should clean up the camera with Camera.close() after this happens. Further attempts at recovery are error-code specific.

Parameters:

camera - The device reporting the error

error - The error code