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

Class Camera.StateCallbackDefault

java.lang.Object

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

All Implemented Interfaces:

Camera.StateCallback

Enclosing interface:

Camera

public static class Camera.StateCallbackDefault
extends java.lang.Object
implements Camera.StateCallback

An implementation of StateCallback that does nothing by default

Constructor Summary

Constructors

Constructor and Description
StateCallbackDefault()

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 failureReason) A request to open a camera has failed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StateCallbackDefault

public StateCallbackDefault()

Method Detail

onOpened

public void onOpened(Camera camera)

Description copied from interface: Camera.StateCallback

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.

Specified by:

onOpened in interface Camera.StateCallback

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

public void onOpenFailed(CameraName cameraName,
                         Camera.OpenFailure failureReason)

Description copied from interface: Camera.StateCallback

A request to open a camera has failed.

Specified by:

onOpenFailed in interface Camera.StateCallback

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

public void onClosed(Camera camera)

Description copied from interface: Camera.StateCallback

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.

Specified by:

onClosed in interface Camera.StateCallback

Parameters:

camera - the camera device that has become closed

onError

public void onError(Camera camera,
                    Camera.Error error)

Description copied from interface: Camera.StateCallback

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.

Specified by:

onError in interface Camera.StateCallback

Parameters:

camera - The device reporting the error

error - The error code