Added in API level 31

StateCallback


abstract class StateCallback
kotlin.Any
   ↳ android.hardware.camera2.CameraExtensionSession.StateCallback

A callback object for receiving updates about the state of a camera extension session.

Summary

Public constructors

Public methods
open Unit

This method is called when the session is closed.

abstract Unit

This method is called if the session cannot be configured as requested.

abstract Unit

This method is called when the camera device has finished configuring itself, and the session can start processing capture requests.

Public constructors

StateCallback

StateCallback()

Public methods

onClosed

Added in API level 31
open fun onClosed(session: CameraExtensionSession): Unit

This method is called when the session is closed.

A session is closed when a new session is created by the parent camera device, or when the parent camera device is closed (either by the user closing the device, or due to a camera device disconnection or fatal error).

Once a session is closed, all methods on it will throw an IllegalStateException, and any repeating requests are stopped (as if stopRepeating() was called). However, any in-progress capture requests submitted to the session will be completed as normal.

Parameters
session CameraExtensionSession: the session received during StateCallback#onConfigured(CameraExtensionSession) This value cannot be null.

onConfigureFailed

Added in API level 31
abstract fun onConfigureFailed(session: CameraExtensionSession): Unit

This method is called if the session cannot be configured as requested.

This can happen if the set of requested outputs contains unsupported sizes, too many outputs are requested at once or when trying to initialize multiple concurrent extension sessions from two (or more) separate camera devices or the camera device encounters an unrecoverable error during configuration.

The session is considered to be closed, and all methods called on it after this callback is invoked will throw an IllegalStateException.

Parameters
session CameraExtensionSession: the session instance that failed to configure This value cannot be null.

onConfigured

Added in API level 31
abstract fun onConfigured(session: CameraExtensionSession): Unit

This method is called when the camera device has finished configuring itself, and the session can start processing capture requests.

If the camera device configuration fails, then onConfigureFailed will be invoked instead of this callback.

Parameters
session CameraExtensionSession: A valid extension session This value cannot be null.