CameraOfflineSession.CameraOfflineSessionCallback
public
static
abstract
class
CameraOfflineSession.CameraOfflineSessionCallback
extends Object
java.lang.Object | |
↳ | android.hardware.camera2.CameraOfflineSession.CameraOfflineSessionCallback |
Summary
Constants | |
---|---|
int |
STATUS_INTERNAL_ERROR
This status code indicates unexpected and fatal internal camera error. |
Public constructors | |
---|---|
CameraOfflineSessionCallback()
|
Public methods | |
---|---|
abstract
void
|
onClosed(CameraOfflineSession session)
This method is called when the offline session is closed. |
abstract
void
|
onError(CameraOfflineSession session, int status)
This method is called when the offline session encounters an unexpected error. |
abstract
void
|
onIdle(CameraOfflineSession session)
This method indicates that all pending offline requests were processed. |
abstract
void
|
onReady(CameraOfflineSession session)
This method indicates that the offline switch call
|
abstract
void
|
onSwitchFailed(CameraOfflineSession session)
This method indicates that the offline switch call
|
Inherited methods | |
---|---|
Constants
STATUS_INTERNAL_ERROR
public static final int STATUS_INTERNAL_ERROR
This status code indicates unexpected and fatal internal camera error.
Pending offline requests will be discarded and the respective registered capture callbacks may not get triggered.
See also:
Constant Value: 0 (0x00000000)
Public constructors
CameraOfflineSessionCallback
public CameraOfflineSessionCallback ()
Public methods
onClosed
public abstract void onClosed (CameraOfflineSession session)
This method is called when the offline session is closed.
An offline session will be closed after a call to
CameraOfflineSession.close
.
In case of failure to switch to offline mode, only onSwitchFailed(CameraOfflineSession)
will be
called and onClosed(CameraOfflineSession)
will not be.
In case there was no previous onIdle(CameraOfflineSession)
notification any in-progress
offline capture requests within the offline session will be discarded
and further result callbacks will not be triggered.
Parameters | |
---|---|
session |
CameraOfflineSession : the session returned by CameraCaptureSession.switchToOffline
This value cannot be null . |
onError
public abstract void onError (CameraOfflineSession session, int status)
This method is called when the offline session encounters an unexpected error.
This notification will only be invoked for sessions that reached the ready state.
Clients will need to call CameraOfflineSession.close
to close and release all
resources. onClosed(CameraOfflineSession)
will not be triggered automatically in error scenarios.
Parameters | |
---|---|
session |
CameraOfflineSession : the current offline session
This value cannot be null . |
status |
int : error status
Value is STATUS_INTERNAL_ERROR |
onIdle
public abstract void onIdle (CameraOfflineSession session)
This method indicates that all pending offline requests were processed.
This callback will be invoked once the offline session finishes processing all of its pending offline capture requests.
Parameters | |
---|---|
session |
CameraOfflineSession : the currently ready offline session
This value cannot be null . |
onReady
public abstract void onReady (CameraOfflineSession session)
This method indicates that the offline switch call
CameraCaptureSession.switchToOffline
was successful.
This callback will be invoked once the offline session moves to the ready state.
Calls to CameraDevice.close
will not have impact on the processing of offline
requests once the offline session moves in ready state.
Parameters | |
---|---|
session |
CameraOfflineSession : the currently ready offline session
This value cannot be null . |
onSwitchFailed
public abstract void onSwitchFailed (CameraOfflineSession session)
This method indicates that the offline switch call
CameraCaptureSession.switchToOffline
was not able to complete successfully.
The offline switch can fail either due to internal camera error during the switch sequence or because the camera implementation was not able to find any pending capture requests that can be migrated to offline mode.
Calling CameraOfflineSession.close
is not necessary and clients will not
receive any further offline session notifications.
Parameters | |
---|---|
session |
CameraOfflineSession : the offline session that failed to switch to ready state
This value cannot be null . |