CameraAccessException

public class CameraAccessException
extends AndroidException

java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ android.util.AndroidException
         ↳ android.hardware.camera2.CameraAccessException


CameraAccessException is thrown if a camera device could not be queried or opened by the CameraManager, or if the connection to an opened CameraDevice is no longer valid.

Summary

Constants

int CAMERA_DISABLED

The camera is disabled due to a device policy, and cannot be opened.

int CAMERA_DISCONNECTED

The camera device is removable and has been disconnected from the Android device, or the camera id used with CameraManager.openCamera(String, StateCallback, Handler) is no longer valid, or the camera service has shut down the connection due to a higher-priority access request for the camera device.

int CAMERA_ERROR

The camera device is currently in the error state.

int CAMERA_IN_USE

The camera device is in use already.

int MAX_CAMERAS_IN_USE

The system-wide limit for number of open cameras or camera resources has been reached, and more camera devices cannot be opened or torch mode cannot be turned on until previous instances are closed.

Public constructors

CameraAccessException(int problem)
CameraAccessException(int problem, String message)
CameraAccessException(int problem, String message, Throwable cause)
CameraAccessException(int problem, Throwable cause)

Public methods

final int getReason()

The reason for the failure to access the camera.

Inherited methods

Constants

CAMERA_DISABLED

Added in API level 21
public static final int CAMERA_DISABLED

The camera is disabled due to a device policy, and cannot be opened.

Constant Value: 1 (0x00000001)

CAMERA_DISCONNECTED

Added in API level 21
public static final int CAMERA_DISCONNECTED

The camera device is removable and has been disconnected from the Android device, or the camera id used with CameraManager.openCamera(String, StateCallback, Handler) is no longer valid, or the camera service has shut down the connection due to a higher-priority access request for the camera device.

Constant Value: 2 (0x00000002)

CAMERA_ERROR

Added in API level 21
public static final int CAMERA_ERROR

The camera device is currently in the error state.

The camera has failed to open or has failed at a later time as a result of some non-user interaction. Refer to CameraDevice.StateCallback#onError for the exact nature of the error.

No further calls to the camera will succeed. Clean up the camera with CameraDevice#close and try handling the error in order to successfully re-open the camera.

Constant Value: 3 (0x00000003)

CAMERA_IN_USE

Added in API level 23
public static final int CAMERA_IN_USE

The camera device is in use already.

Constant Value: 4 (0x00000004)

MAX_CAMERAS_IN_USE

Added in API level 23
public static final int MAX_CAMERAS_IN_USE

The system-wide limit for number of open cameras or camera resources has been reached, and more camera devices cannot be opened or torch mode cannot be turned on until previous instances are closed.

Constant Value: 5 (0x00000005)

Public constructors

CameraAccessException

Added in API level 21
public CameraAccessException (int problem)

Parameters
problem int: Value is CAMERA_IN_USE, MAX_CAMERAS_IN_USE, CAMERA_DISABLED, CAMERA_DISCONNECTED, or CAMERA_ERROR

CameraAccessException

Added in API level 21
public CameraAccessException (int problem, 
                String message)

Parameters
problem int: Value is CAMERA_IN_USE, MAX_CAMERAS_IN_USE, CAMERA_DISABLED, CAMERA_DISCONNECTED, or CAMERA_ERROR

message String

CameraAccessException

Added in API level 21
public CameraAccessException (int problem, 
                String message, 
                Throwable cause)

Parameters
problem int: Value is CAMERA_IN_USE, MAX_CAMERAS_IN_USE, CAMERA_DISABLED, CAMERA_DISCONNECTED, or CAMERA_ERROR

message String

cause Throwable

CameraAccessException

Added in API level 21
public CameraAccessException (int problem, 
                Throwable cause)

Parameters
problem int: Value is CAMERA_IN_USE, MAX_CAMERAS_IN_USE, CAMERA_DISABLED, CAMERA_DISCONNECTED, or CAMERA_ERROR

cause Throwable

Public methods

getReason

Added in API level 21
public final int getReason ()

The reason for the failure to access the camera.

Returns
int Value is CAMERA_IN_USE, MAX_CAMERAS_IN_USE, CAMERA_DISABLED, CAMERA_DISCONNECTED, or CAMERA_ERROR