CameraDevice | API reference | Android Developers (original) (raw)

public abstract class CameraDevice
extends [Object](/reference/java/lang/Object) implements[AutoCloseable](/reference/java/lang/AutoCloseable)

The CameraDevice class is a representation of a single camera connected to an Android device, allowing for fine-grain control of image capture and post-processing at high frame rates.

Your application must declare the[Camera](/reference/android/Manifest.permission#CAMERA) permission in its manifest in order to access camera devices.

A given camera device may provide support at one of several levels defined in [CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL). If a device supports [LEGACY](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLEGACY) level, the camera device is running in backward compatibility mode and has minimum camera2 API support. If a device supports the [LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) level, then Camera2 exposes a feature set that is roughly equivalent to the older[Camera](/reference/android/hardware/Camera) API, although with a cleaner and more efficient interface. If a device supports the [EXTERNAL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FEXTERNAL) level, then the device is a removable camera that provides similar but slightly less features as the [LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) level. Devices that implement the [FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL) or[LEVEL3](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5F3) level of support provide substantially improved capabilities over the older camera API. If your application requires a full-level device for proper operation, declare the "android.hardware.camera.level.full" feature in your manifest.

See also:

[CameraManager.openCamera](/reference/android/hardware/camera2/CameraManager#openCamera%28java.lang.String,%20android.hardware.camera2.CameraDevice.StateCallback,%20android.os.Handler%29)
[Manifest.permission.CAMERA](/reference/android/Manifest.permission#CAMERA)
[CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL)

Summary

Nested classes
class	CameraDevice.CameraDeviceSetup CameraDeviceSetup is a limited representation of CameraDevice that can be used to query device specific information which would otherwise need a CameraDevice instance.
class	CameraDevice.StateCallback A callback objects for receiving updates about the state of a camera device.

Constants
int	AUDIO_RESTRICTION_NONE No vibration or sound muting for this camera device.
int	AUDIO_RESTRICTION_VIBRATION Mute vibration from ringtones, alarms or notifications while this camera device is in use.
int	AUDIO_RESTRICTION_VIBRATION_SOUND Mute vibration and sound from ringtones, alarms or notifications while this camera device is in use.
int	TEMPLATE_MANUAL A basic template for direct application control of capture parameters.
int	TEMPLATE_PREVIEW Create a request suitable for a camera preview window.
int	TEMPLATE_RECORD Create a request suitable for video recording.
int	TEMPLATE_STILL_CAPTURE Create a request suitable for still image capture.
int	TEMPLATE_VIDEO_SNAPSHOT Create a request suitable for still image capture while recording video.
int	TEMPLATE_ZERO_SHUTTER_LAG Create a request suitable for zero shutter lag still capture.

Public methods
abstract void	close() Close the connection to this camera device as quickly as possible.
CaptureRequest.Builder	createCaptureRequest(int templateType, Set<String> physicalCameraIdSet) Create a CaptureRequest.Builder for new capture requests, initialized with template for a target use case.
abstractCaptureRequest.Builder	createCaptureRequest(int templateType) Create a CaptureRequest.Builder for new capture requests, initialized with template for a target use case.
void	createCaptureSession(SessionConfiguration config) Create a new CameraCaptureSession using a SessionConfiguration helper object that aggregates all supported parameters.
abstract void	createCaptureSession(List<Surface> outputs, CameraCaptureSession.StateCallback callback, Handler handler) This method was deprecated in API level 30. Please use createCaptureSession(android.hardware.camera2.params.SessionConfiguration) for the full set of configuration options available.
abstract void	createCaptureSessionByOutputConfigurations(List<OutputConfiguration> outputConfigurations, CameraCaptureSession.StateCallback callback, Handler handler) This method was deprecated in API level 30. Please use createCaptureSession(android.hardware.camera2.params.SessionConfiguration) for the full set of configuration options available.
abstract void	createConstrainedHighSpeedCaptureSession(List<Surface> outputs, CameraCaptureSession.StateCallback callback, Handler handler) This method was deprecated in API level 30. Please use createCaptureSession(android.hardware.camera2.params.SessionConfiguration) for the full set of configuration options available.
void	createExtensionSession(ExtensionSessionConfiguration extensionConfiguration) Initialize a specific device-specific extension augmented camera capture session.
abstractCaptureRequest.Builder	createReprocessCaptureRequest(TotalCaptureResult inputResult) Create a CaptureRequest.Builder for a new reprocess CaptureRequest from aTotalCaptureResult.
abstract void	createReprocessableCaptureSession(InputConfiguration inputConfig, List<Surface> outputs, CameraCaptureSession.StateCallback callback, Handler handler) This method was deprecated in API level 30. Please use createCaptureSession(android.hardware.camera2.params.SessionConfiguration) for the full set of configuration options available.
abstract void	createReprocessableCaptureSessionByConfigurations(InputConfiguration inputConfig, List<OutputConfiguration> outputs, CameraCaptureSession.StateCallback callback, Handler handler) This method was deprecated in API level 30. Please use createCaptureSession(android.hardware.camera2.params.SessionConfiguration) for the full set of configuration options available.
int	getCameraAudioRestriction() Get currently applied global camera audio restriction mode.
abstractString	getId() Get the ID of this camera device.
boolean	isSessionConfigurationSupported(SessionConfiguration sessionConfig) Checks whether a particular SessionConfiguration is supported by the camera device.
void	setCameraAudioRestriction(int mode) Set audio restriction mode when this CameraDevice is being used.

Inherited methods
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. finalClass<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
From interface java.lang.AutoCloseable abstract void close() Closes this resource, relinquishing any underlying resources.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. finalClass<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

From interface java.lang.AutoCloseable abstract void close() Closes this resource, relinquishing any underlying resources.

Constants

AUDIO_RESTRICTION_NONE

public static final int AUDIO_RESTRICTION_NONE

No vibration or sound muting for this camera device. This is the default mode for all camera devices.

Constant Value: 0 (0x00000000)

AUDIO_RESTRICTION_VIBRATION

public static final int AUDIO_RESTRICTION_VIBRATION

Mute vibration from ringtones, alarms or notifications while this camera device is in use.

Constant Value: 1 (0x00000001)

AUDIO_RESTRICTION_VIBRATION_SOUND

public static final int AUDIO_RESTRICTION_VIBRATION_SOUND

Mute vibration and sound from ringtones, alarms or notifications while this camera device is in use.

As of API level 37, this option will also turn off any lights on the device if they are bright enough to interfere with camera photos or recordings.

Constant Value: 3 (0x00000003)

TEMPLATE_MANUAL

public static final int TEMPLATE_MANUAL

A basic template for direct application control of capture parameters. All automatic control is disabled (auto-exposure, auto-white balance, auto-focus), and post-processing parameters are set to preview quality. The manual capture parameters (exposure, sensitivity, and so on) are set to reasonable defaults, but should be overridden by the application depending on the intended use case. This template is guaranteed to be supported on camera devices that support the[MANUAL_SENSOR](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FMANUAL%5FSENSOR) capability.

Constant Value: 6 (0x00000006)

TEMPLATE_PREVIEW

public static final int TEMPLATE_PREVIEW

Create a request suitable for a camera preview window. Specifically, this means that high frame rate is given priority over the highest-quality post-processing. These requests would normally be used with the[CameraCaptureSession.setRepeatingRequest](/reference/android/hardware/camera2/CameraCaptureSession#setRepeatingRequest%28android.hardware.camera2.CaptureRequest,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29) method. This template is guaranteed to be supported on all camera devices.

Constant Value: 1 (0x00000001)

TEMPLATE_RECORD

public static final int TEMPLATE_RECORD

Create a request suitable for video recording. Specifically, this means that a stable frame rate is used, and post-processing is set for recording quality. These requests would commonly be used with the[CameraCaptureSession.setRepeatingRequest](/reference/android/hardware/camera2/CameraCaptureSession#setRepeatingRequest%28android.hardware.camera2.CaptureRequest,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29) method. This template is guaranteed to be supported on all camera devices except[DEPTH_OUTPUT](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FDEPTH%5FOUTPUT) devices that are not [BACKWARD_COMPATIBLE](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FBACKWARD%5FCOMPATIBLE).

Constant Value: 3 (0x00000003)

TEMPLATE_STILL_CAPTURE

public static final int TEMPLATE_STILL_CAPTURE

Create a request suitable for still image capture. Specifically, this means prioritizing image quality over frame rate. These requests would commonly be used with the [CameraCaptureSession.capture](/reference/android/hardware/camera2/CameraCaptureSession#capture%28android.hardware.camera2.CaptureRequest,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29) method. This template is guaranteed to be supported on all camera devices except[DEPTH_OUTPUT](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FDEPTH%5FOUTPUT) devices that are not [BACKWARD_COMPATIBLE](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FBACKWARD%5FCOMPATIBLE).

Constant Value: 2 (0x00000002)

TEMPLATE_ZERO_SHUTTER_LAG

public static final int TEMPLATE_ZERO_SHUTTER_LAG

Create a request suitable for zero shutter lag still capture. This means means maximizing image quality without compromising preview frame rate. AE/AWB/AF should be on auto mode. This is intended for application-operated ZSL. For device-operated ZSL, use [CaptureRequest.CONTROL_ENABLE_ZSL](/reference/android/hardware/camera2/CaptureRequest#CONTROL%5FENABLE%5FZSL) if available. This template is guaranteed to be supported on camera devices that support the[PRIVATE_REPROCESSING](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FPRIVATE%5FREPROCESSING) capability or the[YUV_REPROCESSING](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FYUV%5FREPROCESSING) capability.

Constant Value: 5 (0x00000005)

Public methods

close

public abstract void close ()

Close the connection to this camera device as quickly as possible.

Immediately after this call, all calls to the camera device or active session interface will throw a [IllegalStateException](/reference/java/lang/IllegalStateException), except for calls to close(). Once the device has fully shut down, the [StateCallback.onClosed](/reference/android/hardware/camera2/CameraDevice.StateCallback#onClosed%28android.hardware.camera2.CameraDevice%29) callback will be called, and the camera is free to be re-opened.

Immediately after this call, besides the final [StateCallback.onClosed](/reference/android/hardware/camera2/CameraDevice.StateCallback#onClosed%28android.hardware.camera2.CameraDevice%29) calls, no further callbacks from the device or the active session will occur, and any remaining submitted capture requests will be discarded, as if[CameraCaptureSession.abortCaptures](/reference/android/hardware/camera2/CameraCaptureSession#abortCaptures%28%29) had been called, except that no success or failure callbacks will be invoked.

createCaptureSession

public void createCaptureSession (SessionConfiguration config)

Create a new [CameraCaptureSession](/reference/android/hardware/camera2/CameraCaptureSession) using a [SessionConfiguration](/reference/android/hardware/camera2/params/SessionConfiguration) helper object that aggregates all supported parameters.

The active capture session determines the set of potential output Surfaces for the camera device for each capture request. A given request may use all or only some of the outputs. Once the CameraCaptureSession is created, requests can be submitted with [capture](/reference/android/hardware/camera2/CameraCaptureSession#capture%28android.hardware.camera2.CaptureRequest,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29),[captureBurst](/reference/android/hardware/camera2/CameraCaptureSession#captureBurst%28java.util.List<android.hardware.camera2.CaptureRequest>,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29),[setRepeatingRequest](/reference/android/hardware/camera2/CameraCaptureSession#setRepeatingRequest%28android.hardware.camera2.CaptureRequest,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29), or[setRepeatingBurst](/reference/android/hardware/camera2/CameraCaptureSession#setRepeatingBurst%28java.util.List<android.hardware.camera2.CaptureRequest>,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29).

Surfaces suitable for inclusion as a camera output can be created for various use cases and targets:

For drawing to a [SurfaceView](/reference/android/view/SurfaceView): Once the SurfaceView's Surface is [created](/reference/android/view/SurfaceHolder.Callback#surfaceCreated%28android.view.SurfaceHolder%29), set the size of the Surface with [SurfaceHolder.setFixedSize(int, int)](/reference/android/view/SurfaceHolder#setFixedSize%28int,%20int%29) to be one of the sizes returned by [getOutputSizes(SurfaceHolder.class)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28java.lang.Class<T>%29) and then obtain the Surface by calling [SurfaceHolder.getSurface()](/reference/android/view/SurfaceHolder#getSurface%28%29). If the size is not set by the application, it will be rounded to the nearest supported size less than 1080p, by the camera device.
For accessing through an OpenGL texture via a [SurfaceTexture](/reference/android/graphics/SurfaceTexture): Set the size of the SurfaceTexture with [SurfaceTexture.setDefaultBufferSize(int, int)](/reference/android/graphics/SurfaceTexture#setDefaultBufferSize%28int,%20int%29) to be one of the sizes returned by[getOutputSizes(SurfaceTexture.class)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28java.lang.Class<T>%29) before creating a Surface from the SurfaceTexture with[Surface.Surface(SurfaceTexture)](/reference/android/view/Surface#Surface%28android.graphics.SurfaceTexture%29). If the size is not set by the application, it will be set to be the smallest supported size less than 1080p, by the camera device.
For recording with [MediaCodec](/reference/android/media/MediaCodec): Call[MediaCodec.createInputSurface()](/reference/android/media/MediaCodec#createInputSurface%28%29) after configuring the media codec to use one of the sizes returned by[getOutputSizes(MediaCodec.class)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28java.lang.Class<T>%29)
For recording with [MediaRecorder](/reference/android/media/MediaRecorder): Call[MediaRecorder.getSurface()](/reference/android/media/MediaRecorder#getSurface%28%29) after configuring the media recorder to use one of the sizes returned by[getOutputSizes(MediaRecorder.class)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28java.lang.Class<T>%29), or configuring it to use one of the supported[CamcorderProfiles](/reference/android/media/CamcorderProfile).
For access to RAW, uncompressed YUV, or compressed JPEG data in the application: Create an[ImageReader](/reference/android/media/ImageReader) object with one of the supported output formats given by[StreamConfigurationMap.getOutputFormats()](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputFormats%28%29), setting its size to one of the corresponding supported sizes by passing the chosen output format into[StreamConfigurationMap.getOutputSizes(int)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29). Then obtain a[Surface](/reference/android/view/Surface) from it with [ImageReader.getSurface()](/reference/android/media/ImageReader#getSurface%28%29). If the ImageReader size is not set to a supported size, it will be rounded to a supported size less than 1080p by the camera device.

The camera device will query each Surface's size and formats upon this call, so they must be set to a valid setting at this time.

It can take several hundred milliseconds for the session's configuration to complete, since camera hardware may need to be powered on or reconfigured. Once the configuration is complete and the session is ready to actually capture data, the provided[CameraCaptureSession.StateCallback](/reference/android/hardware/camera2/CameraCaptureSession.StateCallback)'s[CameraCaptureSession.StateCallback.onConfigured](/reference/android/hardware/camera2/CameraCaptureSession.StateCallback#onConfigured%28android.hardware.camera2.CameraCaptureSession%29) callback will be called.

If a prior CameraCaptureSession already exists when this method is called, the previous session will no longer be able to accept new capture requests and will be closed. Any in-progress capture requests made on the prior session will be completed before it's closed.[CameraCaptureSession.StateCallback.onConfigured](/reference/android/hardware/camera2/CameraCaptureSession.StateCallback#onConfigured%28android.hardware.camera2.CameraCaptureSession%29) for the new session may be invoked before [CameraCaptureSession.StateCallback.onClosed](/reference/android/hardware/camera2/CameraCaptureSession.StateCallback#onClosed%28android.hardware.camera2.CameraCaptureSession%29) is invoked for the prior session. Once the new session is [configured](/reference/android/hardware/camera2/CameraCaptureSession.StateCallback#onConfigured%28android.hardware.camera2.CameraCaptureSession%29), it is able to start capturing its own requests. To minimize the transition time, the [CameraCaptureSession.abortCaptures](/reference/android/hardware/camera2/CameraCaptureSession#abortCaptures%28%29) call can be used to discard the remaining requests for the prior capture session before a new one is created. Note that once the new session is created, the old one can no longer have its captures aborted.

Using larger resolution outputs, or more outputs, can result in slower output rate from the device.

Configuring a session with an empty or null list will close the current session, if any. This can be used to release the current session's target surfaces for another use.

This function throws an IllegalArgumentException if called with a SessionConfiguration lacking state callbacks or valid output surfaces. The only exceptions are deferred SurfaceView or SurfaceTexture outputs. See [OutputConfiguration.OutputConfiguration(Size,Class)](/reference/android/hardware/camera2/params/OutputConfiguration#OutputConfiguration%28android.util.Size,%20java.lang.Class<T>%29) for details.

Regular capture

While any of the sizes from [StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) can be used when a single output stream is configured, a given camera device may not be able to support all combination of sizes, formats, and targets when multiple outputs are configured at once. The tables below list the maximum guaranteed resolutions for combinations of streams and targets, given the capabilities of the camera device. These are valid for when the[input configuration](/reference/android/hardware/camera2/params/SessionConfiguration#setInputConfiguration%28android.hardware.camera2.params.InputConfiguration%29) is not set and therefore no reprocessing is active.

If an application tries to create a session using a set of targets that exceed the limits described in the below tables, one of three possibilities may occur. First, the session may be successfully created and work normally. Second, the session may be successfully created, but the camera device won't meet the frame rate guarantees as described in[StreamConfigurationMap.getOutputMinFrameDuration](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputMinFrameDuration%28int,%20android.util.Size%29). Or third, if the output set cannot be used at all, session creation will fail entirely, with[CameraCaptureSession.StateCallback.onConfigureFailed](/reference/android/hardware/camera2/CameraCaptureSession.StateCallback#onConfigureFailed%28android.hardware.camera2.CameraCaptureSession%29) being invoked.

For the type column, PRIV refers to any target whose available sizes are found using [StreamConfigurationMap.getOutputSizes(Class)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28java.lang.Class<T>%29) with no direct application-visible format, YUV refers to a target Surface using the[ImageFormat.YUV_420_888](/reference/android/graphics/ImageFormat#YUV%5F420%5F888) format, JPEG refers to the[ImageFormat.JPEG](/reference/android/graphics/ImageFormat#JPEG) format, and RAW refers to the[ImageFormat.RAW_SENSOR](/reference/android/graphics/ImageFormat#RAW%5FSENSOR) format.

For the maximum size column, PREVIEW refers to the best size match to the device's screen resolution, or to 1080p (1920x1080), whichever is smaller. RECORD refers to the camera device's maximum supported recording resolution, as determined by [CamcorderProfile](/reference/android/media/CamcorderProfile). And MAXIMUM refers to the camera device's maximum output resolution for that format or target from[StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29).

To use these tables, determine the number and the formats/targets of outputs needed, and find the row(s) of the table with those targets. The sizes indicate the maximum set of sizes that can be used; it is guaranteed that for those targets, the listed sizes and anything smaller from the list given by [StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) can be successfully used to create a session. For example, if a row indicates that a 8 megapixel (MP) YUV_420_888 output can be used together with a 2 MP PRIV output, then a session can be created with targets [8 MP YUV, 2 MP PRIV] or targets [2 MP YUV, 2 MP PRIV]; but a session with targets [8 MP YUV, 4 MP PRIV], targets [4 MP YUV, 4 MP PRIV], or targets [8 MP PRIV, 2 MP YUV] would not be guaranteed to work, unless some other row of the table lists such a combination.

LEGACY-level guaranteed configurations

Legacy devices ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [LEGACY](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLEGACY)) support at least the following stream combinations:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
PRIV	MAXIMUM	Simple preview, GPU video processing, or no-preview video recording.
JPEG	MAXIMUM	No-viewfinder still image capture.
YUV	MAXIMUM	In-application video/image processing.
PRIV	PREVIEW	JPEG	MAXIMUM	Standard still imaging.
YUV	PREVIEW	JPEG	MAXIMUM	In-app processing plus still capture.
PRIV	PREVIEW	PRIV	PREVIEW	Standard recording.
PRIV	PREVIEW	YUV	PREVIEW	Preview plus in-app processing.
PRIV	PREVIEW	YUV	PREVIEW	JPEG	MAXIMUM	Still capture plus in-app processing.

LIMITED-level additional guaranteed configurations

Limited-level ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED)) devices support at least the following stream combinations in addition to those for[LEGACY](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLEGACY) devices:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
PRIV	PREVIEW	PRIV	RECORD	High-resolution video recording with preview.
PRIV	PREVIEW	YUV	RECORD	High-resolution in-app video processing with preview.
YUV	PREVIEW	YUV	RECORD	Two-input in-app video processing.
PRIV	PREVIEW	PRIV	RECORD	JPEG	RECORD	High-resolution recording with video snapshot.
PRIV	PREVIEW	YUV	RECORD	JPEG	RECORD	High-resolution in-app processing with video snapshot.
YUV	PREVIEW	YUV	PREVIEW	JPEG	MAXIMUM	Two-input in-app processing with still capture.

FULL-level additional guaranteed configurations

FULL-level ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL)) devices support at least the following stream combinations in addition to those for[LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) devices:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
PRIV	PREVIEW	PRIV	MAXIMUM	Maximum-resolution GPU processing with preview.
PRIV	PREVIEW	YUV	MAXIMUM	Maximum-resolution in-app processing with preview.
YUV	PREVIEW	YUV	MAXIMUM	Maximum-resolution two-input in-app processing.
PRIV	PREVIEW	PRIV	PREVIEW	JPEG	MAXIMUM	Video recording with maximum-size video snapshot
YUV	640x480	PRIV	PREVIEW	YUV	MAXIMUM	Standard video recording plus maximum-resolution in-app processing.
YUV	640x480	YUV	PREVIEW	YUV	MAXIMUM	Preview plus two-input maximum-resolution in-app processing.

RAW-capability additional guaranteed configurations

RAW-capability ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) includes[RAW](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FRAW)) devices additionally support at least the following stream combinations on both[FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL) and[LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) devices:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
RAW	MAXIMUM	No-preview DNG capture.
PRIV	PREVIEW	RAW	MAXIMUM	Standard DNG capture.
YUV	PREVIEW	RAW	MAXIMUM	In-app processing plus DNG capture.
PRIV	PREVIEW	PRIV	PREVIEW	RAW	MAXIMUM	Video recording with DNG capture.
PRIV	PREVIEW	YUV	PREVIEW	RAW	MAXIMUM	Preview with in-app processing and DNG capture.
YUV	PREVIEW	YUV	PREVIEW	RAW	MAXIMUM	Two-input in-app processing plus DNG capture.
PRIV	PREVIEW	JPEG	MAXIMUM	RAW	MAXIMUM	Still capture with simultaneous JPEG and DNG.
YUV	PREVIEW	JPEG	MAXIMUM	RAW	MAXIMUM	In-app processing with simultaneous JPEG and DNG.

BURST-capability additional guaranteed configurations

BURST-capability ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) includes[BURST_CAPTURE](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FBURST%5FCAPTURE)) devices support at least the below stream combinations in addition to those for[LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) devices. Note that all FULL-level devices support the BURST capability, and the below list is a strict subset of the list for FULL-level devices, so this table is only relevant for LIMITED-level devices that support the BURST_CAPTURE capability.

Target 1	Target 2	Sample use case(s)
Type	Max size	Type	Max size
PRIV	PREVIEW	PRIV	MAXIMUM	Maximum-resolution GPU processing with preview.
PRIV	PREVIEW	YUV	MAXIMUM	Maximum-resolution in-app processing with preview.
YUV	PREVIEW	YUV	MAXIMUM	Maximum-resolution two-input in-app processing.

LEVEL-3 additional guaranteed configurations

LEVEL-3 ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [LEVEL_3](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5F3)) support at least the following stream combinations in addition to the combinations for[FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL) and for RAW capability ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) includes[RAW](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FRAW)):

Target 1	Target 2	Target 3	Target 4	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size
PRIV	PREVIEW	PRIV	640x480	YUV	MAXIMUM	RAW	MAXIMUM	In-app viewfinder analysis with dynamic selection of output format.
PRIV	PREVIEW	PRIV	640x480	JPEG	MAXIMUM	RAW	MAXIMUM	In-app viewfinder analysis with dynamic selection of output format.

Concurrent stream guaranteed configurations

BACKWARD_COMPATIBLE devices capable of streaming concurrently with other devices as described by [CameraManager.getConcurrentCameraIds()](/reference/android/hardware/camera2/CameraManager#getConcurrentCameraIds%28%29) have the following guaranteed streams (when streaming concurrently with other devices)

Note: The sizes mentioned for these concurrent streams are the maximum sizes guaranteed to be supported. Sizes smaller than these, obtained by [StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) for a particular format, are supported as well.

Target 1	Target 2	Sample use case(s)
Type	Max size	Type	Max size
YUV	s1440p	In-app video / image processing.
PRIV	s1440p	In-app viewfinder analysis.
JPEG	s1440p	No viewfinder still image capture.
YUV / PRIV	s720p	JPEG	s1440p	Standard still imaging.
YUV / PRIV	s720p	YUV / PRIV	s1440p	In-app video / processing with preview.

Devices which are not backwards-compatible, support a mandatory single stream of size sVGA with image format DEPTH16 during concurrent operation.

For guaranteed concurrent stream configurations:

sVGA refers to the camera device's maximum resolution for that format from [StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) or VGA resolution (640X480) whichever is lower.

s720p refers to the camera device's maximum resolution for that format from [StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) or 720p(1280X720) whichever is lower.

s1440p refers to the camera device's maximum resolution for that format from [StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) or 1440p(1920X1440) whichever is lower.

MONOCHROME-capability ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) includes [MONOCHROME](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FMONOCHROME)) devices supporting [Y8](/reference/android/graphics/ImageFormat#Y8) support substituting YUV streams with Y8 in all guaranteed stream combinations for the device's hardware level and capabilities.

Clients can access the above mandatory stream combination tables via[MandatoryStreamCombination](/reference/android/hardware/camera2/params/MandatoryStreamCombination).

Devices capable of outputting HEIC formats ([StreamConfigurationMap.getOutputFormats](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputFormats%28%29) contains [ImageFormat.HEIC](/reference/android/graphics/ImageFormat#HEIC)) will support substituting JPEG streams with HEIC in all guaranteed stream combinations for the device's hardware level and capabilities. Calling createCaptureSession with both JPEG and HEIC outputs is not supported.

LEGACY-level additional guaranteed combinations with multi-resolution outputs

Devices capable of multi-resolution output for a particular format ([MultiResolutionStreamConfigurationMap.getOutputInfo(int)](/reference/android/hardware/camera2/params/MultiResolutionStreamConfigurationMap#getOutputInfo%28int%29) returns a non-empty list) support using [MultiResolutionImageReader](/reference/android/hardware/camera2/MultiResolutionImageReader) for MAXIMUM resolution streams of that format for all mandatory stream combinations. For example, if a LIMITED camera device supports multi-resolution output streams for both JPEG andPRIVATE, in addition to the stream configurations in the LIMITED and Legacy table above, the camera device supports the following guaranteed stream combinations (MULTI_RES in the Max size column refers to a [MultiResolutionImageReader](/reference/android/hardware/camera2/MultiResolutionImageReader) created based on the variable max resolutions supported):

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
PRIV	MULTI_RES	Simple preview, GPU video processing, or no-preview video recording.
JPEG	MULTI_RES	No-viewfinder still image capture.
PRIV	PREVIEW	JPEG	MULTI_RES	Standard still imaging.
PRIV	PREVIEW	YUV	PREVIEW	JPEG	MULTI_RES	Still capture plus in-app processing.

LIMITED-level additional guaranteed configurations with multi-resolution outputs

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
YUV	PREVIEW	YUV	PREVIEW	JPEG	MULTI_RES	Two-input in-app processing with still capture.

The same logic applies to other hardware levels and capabilities.

Additional guaranteed combinations for ULTRA_HIGH_RESOLUTION sensors

Devices with the ULTRA_HIGH_RESOLUTION_SENSOR capability have some additional guarantees which clients can take advantage of:

Target 1	Target 2	Target 3	Sample use case(s)
Type	SC Map	Max size	Type	SC Map	Max size	Type	SC Map	Max size
YUV / JPEG / RAW	MAX_RES	MAX	PRIV / YUV	DEFAULT	PREVIEW	Ultra high res still image capture with preview
YUV / JPEG / RAW	MAX_RES	MAX	PRIV	DEFAULT	PREVIEW	PRIV / YUV	DEFAULT	RECORD	Ultra high res still capture with preview + app based RECORD size analysis
YUV / JPEG / RAW	MAX_RES	MAX	PRIV	DEFAULT	PREVIEW	JPEG / YUV / RAW	DEFAULT	MAX	Ultra high res still image capture with preview + default sensor pixel mode analysis stream

Here, SC Map, refers to the [StreamConfigurationMap](/reference/android/hardware/camera2/params/StreamConfigurationMap), the target stream sizes must be chosen from. DEFAULT refers to the default sensor pixel mode [StreamConfigurationMap](/reference/android/hardware/camera2/params/StreamConfigurationMap) and MAX_RES refers to the maximum resolution [StreamConfigurationMap](/reference/android/hardware/camera2/params/StreamConfigurationMap). For MAX_RES streams, MAX in the Max size column refers to the maximum size from[StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) and [StreamConfigurationMap.getHighResolutionOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getHighResolutionOutputSizes%28int%29). Note: The same capture request must not mix targets from[StreamConfigurationMap](/reference/android/hardware/camera2/params/StreamConfigurationMap)s corresponding to different sensor pixel modes.

10-bit output additional guaranteed configurations

10-bit output capable[CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FDYNAMIC%5FRANGE%5FTEN%5FBIT) devices support at least the following stream combinations:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size
PRIV	MAXIMUM	Simple preview, GPU video processing, or no-preview video recording.
YUV	MAXIMUM	In-application video/image processing.
PRIV	PREVIEW	JPEG	MAXIMUM	Standard still imaging.
PRIV	PREVIEW	YUV	MAXIMUM	Maximum-resolution in-app processing with preview.
YUV	PREVIEW	YUV	MAXIMUM	Maximum-resolution two-input in-app processing.
PRIV	PREVIEW	PRIV	RECORD	High-resolution video recording with preview.
PRIV	PREVIEW	PRIV	RECORD	YUV	RECORD	High-resolution recording with in-app snapshot.
PRIV	PREVIEW	PRIV	RECORD	JPEG	RECORD	High-resolution recording with video snapshot.

Here PRIV can be either 8 or 10-bit [ImageFormat.PRIVATE](/reference/android/graphics/ImageFormat#PRIVATE) pixel format. YUV can be either [ImageFormat.YUV_420_888](/reference/android/graphics/ImageFormat#YUV%5F420%5F888) or[ImageFormat.YCBCR_P010](/reference/android/graphics/ImageFormat#YCBCR%5FP010). For the maximum size column, PREVIEW refers to the best size match to the device's screen resolution, or to 1080p (1920x1080), whichever is smaller. RECORD refers to the camera device's maximum supported recording resolution, as determined by[CamcorderProfile](/reference/android/media/CamcorderProfile). MAXIMUM refers to the camera device's maximum output resolution for that format or target from [StreamConfigurationMap.getOutputSizes(int)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29). Do note that invalid combinations such as having a camera surface configured to use pixel format [ImageFormat.YUV_420_888](/reference/android/graphics/ImageFormat#YUV%5F420%5F888) with a 10-bit profile will cause a capture session initialization failure.

[ImageFormat.JPEG_R](/reference/android/graphics/ImageFormat#JPEG%5FR) may also be supported if advertised by[StreamConfigurationMap](/reference/android/hardware/camera2/params/StreamConfigurationMap). When initializing a capture session that includes a Jpeg/R camera output clients must consider the following items w.r.t. the 10-bit mandatory stream combination table:

To generate the compressed Jpeg/R image a single[ImageFormat.YCBCR_P010](/reference/android/graphics/ImageFormat#YCBCR%5FP010) output will be used internally by the camera device.
On camera devices that are able to support concurrent 10 and 8-bit capture requests see [DynamicRangeProfiles.getProfileCaptureRequestConstraints(long)](/reference/android/hardware/camera2/params/DynamicRangeProfiles#getProfileCaptureRequestConstraints%28long%29) an extra [ImageFormat.JPEG](/reference/android/graphics/ImageFormat#JPEG) will also be configured internally to help speed up the encoding process.

Jpeg/R camera outputs will typically be able to support the MAXIMUM device resolution. Clients can also call [StreamConfigurationMap.getOutputSizes(int)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29) for a complete list supported sizes. Camera clients that register a Jpeg/R output within a stream combination that doesn't fit in the mandatory stream table above can call[isSessionConfigurationSupported(SessionConfiguration)](/reference/android/hardware/camera2/CameraDevice#isSessionConfigurationSupported%28android.hardware.camera2.params.SessionConfiguration%29) to ensure that this particular configuration is supported.

STREAM_USE_CASE capability additional guaranteed configurations

Devices with the STREAM_USE_CASE capability ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) includes [CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FSTREAM%5FUSE%5FCASE)) support below additional stream combinations:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Usecase	Type	Max size	Usecase	Type	Max size	Usecase
YUV / PRIV	PREVIEW	PREVIEW	Simple preview or in-app image processing
YUV / PRIV	RECORD	VIDEO_RECORD	Simple video recording or in-app video processing
YUV / JPEG	MAXIMUM	STILL_CAPTURE	Simple JPEG or YUV still image capture
YUV / PRIV	s1440p	PREVIEW_VIDEO_STILL	Multi-purpose stream for preview, video and still image capture
YUV / PRIV	s1440p	VIDEO_CALL	Simple video call
PRIV	PREVIEW	PREVIEW	YUV / JPEG	MAXIMUM	STILL_CAPTURE	Preview with JPEG or YUV still image capture
PRIV	PREVIEW	PREVIEW	YUV / PRIV	RECORD	VIDEO_RECORD	Preview with video recording or in-app video processing
PRIV	PREVIEW	PREVIEW	YUV	PREVIEW	PREVIEW	Preview with in-application image processing
PRIV	PREVIEW	PREVIEW	YUV / PRIV	s1440p	VIDEO_CALL	Preview with video call
YUV / PRIV	s1440p	PREVIEW_VIDEO_STILL	YUV / JPEG	MAXIMUM	STILL_CAPTURE	MultI-purpose stream with JPEG or YUV still capture
YUV	PREVIEW	STILL_CAPTURE	JPEG	MAXIMUM	STILL_CAPTURE	YUV and JPEG concurrent still image capture (for testing)
PRIV	PREVIEW	PREVIEW	YUV / PRIV	RECORD	VIDEO_RECORD	JPEG	RECORD	STILL_CAPTURE	Preview, video record and JPEG video snapshot
PRIV	PREVIEW	PREVIEW	YUV	PREVIEW	PREVIEW	JPEG	MAXIMUM	STILL_CAPTURE	Preview, in-application image processing, and JPEG still image capture

STREAM_USE_CASE_CROPPED_RAW capability additional guaranteed configurations

Devices that include the [CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW](/reference/android/hardware/camera2/CameraMetadata#SCALER%5FAVAILABLE%5FSTREAM%5FUSE%5FCASES%5FCROPPED%5FRAW) stream use-case in [CameraCharacteristics.SCALER_AVAILABLE_STREAM_USE_CASES](/reference/android/hardware/camera2/CameraCharacteristics#SCALER%5FAVAILABLE%5FSTREAM%5FUSE%5FCASES), support the additional stream combinations below:

Target 1	Target 2	Target 3	Sample use case(s)
Type	Max size	Usecase	Type	Max size	Usecase	Type	Max size	Usecase
RAW	MAXIMUM	CROPPED_RAW	Cropped RAW still capture without preview
PRIV / YUV	PREVIEW	PREVIEW	RAW	MAXIMUM	CROPPED_RAW	Preview with cropped RAW still capture
PRIV / YUV	PREVIEW	PREVIEW	YUV / JPEG	MAXIMUM	STILL_CAPTURE	RAW	MAXIMUM	CROPPED_RAW	Preview with YUV / JPEG and cropped RAW still capture
PRIV / YUV	PREVIEW	PREVIEW	PRIV / YUV	PREVIEW	VIDEO_RECORD / PREVIEW	RAW	MAXIMUM	CROPPED_RAW	Video recording with preview and cropped RAW still capture

Preview stabilization guaranteed stream configurations

For devices where[CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES](/reference/android/hardware/camera2/CameraCharacteristics#CONTROL%5FAVAILABLE%5FVIDEO%5FSTABILIZATION%5FMODES) includes[CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION](/reference/android/hardware/camera2/CameraMetadata#CONTROL%5FVIDEO%5FSTABILIZATION%5FMODE%5FPREVIEW%5FSTABILIZATION), the following stream combinations are guaranteed, for CaptureRequests where [CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE](/reference/android/hardware/camera2/CaptureRequest#CONTROL%5FVIDEO%5FSTABILIZATION%5FMODE) is set to[CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION](/reference/android/hardware/camera2/CameraMetadata#CONTROL%5FVIDEO%5FSTABILIZATION%5FMODE%5FPREVIEW%5FSTABILIZATION)

Target 1	Target 2	Sample use case(s)
Type	Max size	Type	Max size
PRIV / YUV	s1440p	Stabilized preview, GPU video processing, or no-preview stabilized video recording.
PRIV / YUV	s1440p	JPEG / YUV	MAXIMUM	Standard still imaging with stabilized preview.
PRIV / YUV	PREVIEW	PRIV / YUV	s1440p	High-resolution recording with stabilized preview and recording stream.

For the maximum size column, PREVIEW refers to the best size match to the device's screen resolution, or to 1080p (1920x1080), whichever is smaller. RECORD refers to the camera device's maximum supported recording resolution, as determined by[CamcorderProfile](/reference/android/media/CamcorderProfile). MAXIMUM refers to the camera device's maximum output resolution for that format or target from [StreamConfigurationMap.getOutputSizes(int)](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29).

Since the capabilities of camera devices vary greatly, a given camera device may support target combinations with sizes outside of these guarantees, but this can only be tested for by calling [isSessionConfigurationSupported(SessionConfiguration)](/reference/android/hardware/camera2/CameraDevice#isSessionConfigurationSupported%28android.hardware.camera2.params.SessionConfiguration%29) or attempting to create a session with such targets.

Exception on 176x144 (QCIF) resolution: Camera devices usually have a fixed capability for downscaling from larger resolution to smaller, and the QCIF resolution sometimes is not fully supported due to this limitation on devices with high-resolution image sensors. Therefore, trying to configure a QCIF resolution stream together with any other stream larger than 1920x1080 resolution (either width or height) might not be supported, and capture session creation will fail if it is not.

Reprocessing

If a camera device supports YUV reprocessing ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FYUV%5FREPROCESSING)) or PRIVATE reprocessing ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES_PRIVATE_REPROCESSING](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FPRIVATE%5FREPROCESSING)), the application can also create a reprocessable capture session to submit reprocess capture requests in addition to regular capture requests, by setting an[input configuration](/reference/android/hardware/camera2/params/SessionConfiguration#setInputConfiguration%28android.hardware.camera2.params.InputConfiguration%29) for the session. A reprocess capture request takes the next available buffer from the session's input Surface, and sends it through the camera device's processing pipeline again, to produce buffers for the request's target output Surfaces. No new image data is captured for a reprocess request. However the input buffer provided by the application must be captured previously by the same camera device in the same session directly (e.g. for Zero-Shutter-Lag use case) or indirectly (e.g. combining multiple output images).

The active reprocessable capture session determines an input [Surface](/reference/android/view/Surface) and the set of potential output Surfaces for the camera devices for each capture request. The application can use [createCaptureRequest](/reference/android/hardware/camera2/CameraDevice#createCaptureRequest%28int%29) to create regular capture requests to capture new images from the camera device, and use [createReprocessCaptureRequest](/reference/android/hardware/camera2/CameraDevice#createReprocessCaptureRequest%28android.hardware.camera2.TotalCaptureResult%29) to create reprocess capture requests to process buffers from the input [Surface](/reference/android/view/Surface). Some combinations of output Surfaces in a session may not be used in a request simultaneously. The guaranteed combinations of output Surfaces that can be used in a request simultaneously are listed in the tables under [createCaptureSession](/reference/android/hardware/camera2/CameraDevice#createCaptureSession%28android.hardware.camera2.params.SessionConfiguration%29). All the output Surfaces in one capture request will come from the same source, either from a new capture by the camera device, or from the input Surface depending on if the request is a reprocess capture request.

Input formats and sizes supported by the camera device can be queried via[StreamConfigurationMap.getInputFormats](/reference/android/hardware/camera2/params/StreamConfigurationMap#getInputFormats%28%29) and[StreamConfigurationMap.getInputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getInputSizes%28int%29). For each supported input format, the camera device supports a set of output formats and sizes for reprocessing that can be queried via[StreamConfigurationMap.getValidOutputFormatsForInput](/reference/android/hardware/camera2/params/StreamConfigurationMap#getValidOutputFormatsForInput%28int%29) and[StreamConfigurationMap.getOutputSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getOutputSizes%28int%29). While output Surfaces with formats that aren't valid reprocess output targets for the input configuration can be part of a session, they cannot be used as targets for a reprocessing request.

Since the application cannot access [ImageFormat.PRIVATE](/reference/android/graphics/ImageFormat#PRIVATE) images directly, an output Surface created by [ImageReader.newInstance(int, int, int, int)](/reference/android/media/ImageReader#newInstance%28int,%20int,%20int,%20int%29) with[ImageFormat.PRIVATE](/reference/android/graphics/ImageFormat#PRIVATE) as the format will be considered as intended to be used for reprocessing input and thus the [ImageReader](/reference/android/media/ImageReader) size must match one of the supported input sizes for [ImageFormat.PRIVATE](/reference/android/graphics/ImageFormat#PRIVATE) format. Otherwise, creating a reprocessable capture session will fail.

Starting from API level 30, recreating a reprocessable capture session will flush all the queued but not yet processed buffers from the input surface.

The configurations in the tables below are guaranteed for creating a reprocessable capture session if the camera device supports YUV reprocessing or PRIVATE reprocessing. However, not all output targets used to create a reprocessable session may be used in a[CaptureRequest](/reference/android/hardware/camera2/CaptureRequest) simultaneously. For devices that support only 1 output target in a reprocess [CaptureRequest](/reference/android/hardware/camera2/CaptureRequest), submitting a reprocess [CaptureRequest](/reference/android/hardware/camera2/CaptureRequest) with multiple output targets will result in a [CaptureFailure](/reference/android/hardware/camera2/CaptureFailure). For devices that support multiple output targets in a reprocess [CaptureRequest](/reference/android/hardware/camera2/CaptureRequest), the guaranteed output targets that can be included in a [CaptureRequest](/reference/android/hardware/camera2/CaptureRequest) simultaneously are listed in the tables under[createCaptureSession](/reference/android/hardware/camera2/CameraDevice#createCaptureSession%28android.hardware.camera2.params.SessionConfiguration%29). For example, with a FULL-capability ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL)) device that supports PRIVATE reprocessing, an application can create a reprocessable capture session with 1 input, (PRIV, MAXIMUM), and 3 outputs, (PRIV, MAXIMUM), (PRIV, PREVIEW), and (YUV, MAXIMUM). However, it's not guaranteed that an application can submit a regular or reprocess capture with (PRIV,MAXIMUM) and (YUV, MAXIMUM) outputs based on the table listed under[createCaptureSession](/reference/android/hardware/camera2/CameraDevice#createCaptureSession%28android.hardware.camera2.params.SessionConfiguration%29). In other words, use the tables below to determine the guaranteed stream configurations for creating a reprocessable capture session, and use the tables under [createCaptureSession](/reference/android/hardware/camera2/CameraDevice#createCaptureSession%28android.hardware.camera2.params.SessionConfiguration%29) to determine the guaranteed output targets that can be submitted in a regular or reprocess[CaptureRequest](/reference/android/hardware/camera2/CaptureRequest) simultaneously.

Reprocessing with 10-bit output targets on 10-bit capable[CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FDYNAMIC%5FRANGE%5FTEN%5FBIT) devices is not supported. Trying to initialize a repreocessable capture session with one ore more output configurations set [OutputConfiguration.setDynamicRangeProfile](/reference/android/hardware/camera2/params/OutputConfiguration#setDynamicRangeProfile%28long%29) to use a 10-bit dynamic range profile [DynamicRangeProfiles](/reference/android/hardware/camera2/params/DynamicRangeProfiles) will trigger [IllegalArgumentException](/reference/java/lang/IllegalArgumentException).

LIMITED-level ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED)) devices support at least the following stream combinations for creating a reprocessable capture session in addition to those listed earlier for regular captures for[LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) devices:

LIMITED-level additional guaranteed configurations for creating a reprocessable capture session(PRIV input is guaranteed only if PRIVATE reprocessing is supported. YUV input is guaranteed only if YUV reprocessing is supported)
Input	Target 1	Target 2	Target 3	Target 4	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	JPEG	MAXIMUM	No-viewfinder still image reprocessing.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	PRIV	PREVIEW	JPEG	MAXIMUM	ZSL(Zero-Shutter-Lag) still imaging.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	YUV	PREVIEW	JPEG	MAXIMUM	ZSL still and in-app processing imaging.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	YUV	PREVIEW	YUV	PREVIEW	JPEG	MAXIMUM	ZSL in-app processing with still capture.

FULL-level ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL)) devices support at least the following stream combinations for creating a reprocessable capture session in addition to those for[LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) devices:

FULL-level additional guaranteed configurations for creating a reprocessable capture session(PRIV input is guaranteed only if PRIVATE reprocessing is supported. YUV input is guaranteed only if YUV reprocessing is supported)
Input	Target 1	Target 2	Target 3	Target 4	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size
YUV	MAXIMUM	YUV	MAXIMUM	PRIV	PREVIEW	Maximum-resolution multi-frame image fusion in-app processing with regular preview.
YUV	MAXIMUM	YUV	MAXIMUM	YUV	PREVIEW	Maximum-resolution multi-frame image fusion two-input in-app processing.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	PRIV	PREVIEW	YUV	RECORD	High-resolution ZSL in-app video processing with regular preview.
PRIV	MAXIMUM	PRIV	MAXIMUM	PRIV	PREVIEW	YUV	MAXIMUM	Maximum-resolution ZSL in-app processing with regular preview.
PRIV	MAXIMUM	PRIV	MAXIMUM	YUV	PREVIEW	YUV	MAXIMUM	Maximum-resolution two-input ZSL in-app processing.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	PRIV	PREVIEW	YUV	PREVIEW	JPEG	MAXIMUM	ZSL still capture and in-app processing.

RAW-capability ([CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) includes[RAW](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FRAW)) devices additionally support at least the following stream combinations for creating a reprocessable capture session on both [FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL) and[LIMITED](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FLIMITED) devices

RAW-capability additional guaranteed configurations for creating a reprocessable capture session(PRIV input is guaranteed only if PRIVATE reprocessing is supported. YUV input is guaranteed only if YUV reprocessing is supported)
Input	Target 1	Target 2	Target 3	Target 4	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	YUV	PREVIEW	RAW	MAXIMUM	Mutually exclusive ZSL in-app processing and DNG capture.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	PRIV	PREVIEW	YUV	PREVIEW	RAW	MAXIMUM	Mutually exclusive ZSL in-app processing and preview with DNG capture.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	YUV	PREVIEW	YUV	PREVIEW	RAW	MAXIMUM	Mutually exclusive ZSL two-input in-app processing and DNG capture.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	PRIV	PREVIEW	JPEG	MAXIMUM	RAW	MAXIMUM	Mutually exclusive ZSL still capture and preview with DNG capture.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	YUV	PREVIEW	JPEG	MAXIMUM	RAW	MAXIMUM	Mutually exclusive ZSL in-app processing with still capture and DNG capture.

LEVEL-3 ([CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL](/reference/android/hardware/camera2/CameraCharacteristics#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL) == [LEVEL_3](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5F3)) devices support at least the following stream combinations for creating a reprocessable capture session in addition to those for[FULL](/reference/android/hardware/camera2/CameraMetadata#INFO%5FSUPPORTED%5FHARDWARE%5FLEVEL%5FFULL) devices. Note that while the second configuration allows for configuring MAXIMUM YUV and JPEG outputs at the same time, that configuration is not listed for regular capture sessions, and therefore simultaneous output to both targets is not allowed.

LEVEL-3 additional guaranteed configurations for creating a reprocessable capture session(PRIV input is guaranteed only if PRIVATE reprocessing is supported. YUV input is always guaranteed.
Input	Target 1	Target 2	Target 3	Target 4	Target 5	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size
YUV	MAXIMUM	YUV	MAXIMUM	PRIV	PREVIEW	PRIV	640x480	RAW	MAXIMUM	In-app viewfinder analysis with ZSL and RAW.
PRIV/YUV	MAXIMUM	Same as input	MAXIMUM	PRIV	PREVIEW	PRIV	640x480	RAW	MAXIMUM	JPEG	MAXIMUM	In-app viewfinder analysis with ZSL, RAW, and JPEG reprocessing output.

If a camera device supports multi-resolution YUV input and multi-resolutionYUV output or supports multi-resolution PRIVATE input and multi-resolutionPRIVATE output, the additional mandatory stream combinations for LIMITED and FULL devices are listed below (MULTI_RES in the Max size column refers to a[MultiResolutionImageReader](/reference/android/hardware/camera2/MultiResolutionImageReader) for output, and a multi-resolution[InputConfiguration](/reference/android/hardware/camera2/params/InputConfiguration) for input):

LIMITED-level additional guaranteed configurations for creating a reprocessable capture session with multi-resolution input and multi-resolution outputs(PRIV input is guaranteed only if PRIVATE reprocessing is supported. YUV input is guaranteed only if YUV reprocessing is supported)
Input	Target 1	Target 2	Target 3	Target 4	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size
PRIV/YUV	MULTI_RES	Same as input	MULTI_RES	JPEG	MULTI_RES	No-viewfinder still image reprocessing.
PRIV/YUV	MULTI_RES	Same as input	MULTI_RES	PRIV	PREVIEW	JPEG	MULTI_RES	ZSL(Zero-Shutter-Lag) still imaging.
PRIV/YUV	MULTI_RES	Same as input	MULTI_RES	YUV	PREVIEW	JPEG	MULTI_RES	ZSL still and in-app processing imaging.
PRIV/YUV	MULTI_RES	Same as input	MULTI_RES	YUV	PREVIEW	YUV	PREVIEW	JPEG	MULTI_RES	ZSL in-app processing with still capture.

FULL-level additional guaranteed configurations for creating a reprocessable capture session with multi-resolution input and multi-resolution outputs(PRIV input is guaranteed only if PRIVATE reprocessing is supported. YUV input is guaranteed only if YUV reprocessing is supported)
Input	Target 1	Target 2	Target 3	Target 4	Sample use case(s)
Type	Max size	Type	Max size	Type	Max size	Type	Max size	Type	Max size
PRIV	MULTI_RES	PRIV	MULTI_RES	PRIV	PREVIEW	YUV	MULTI_RES	Maximum-resolution ZSL in-app processing with regular preview.
PRIV	MULTI_RES	PRIV	MULTI_RES	YUV	PREVIEW	YUV	MULTI_RES	Maximum-resolution two-input ZSL in-app processing.
PRIV/YUV	MULTI_RES	Same as input	MULTI_RES	PRIV	PREVIEW	YUV	PREVIEW	JPEG	MULTI_RES	ZSL still capture and in-app processing.

Devices with the ULTRA_HIGH_RESOLUTION_SENSOR capability have some additional guarantees which clients can take advantage of :

Additional guaranteed combinations for ULTRA_HIGH_RESOLUTION sensors (YUV / PRIV inputs are guaranteed only if YUV / PRIVATE reprocessing are supported)
Input	Target 1	Target 2	Target 3	Sample use case(s)
Type	SC Map	Max size	Type	SC Map	Max size	Type	SC Map	Max size	Type	SC Map	Max size
RAW	MAX_RES	MAX	RAW	MAX_RES	MAX	PRIV / YUV	DEFAULT	PREVIEW	RAW remosaic reprocessing with separate preview
RAW	MAX_RES	MAX	RAW	MAX_RES	MAX	PRIV / YUV	DEFAULT	PREVIEW	JPEG / YUV	MAX_RES	MAX	Ultra high res RAW -> JPEG / YUV with seperate preview
YUV / PRIV	MAX_RES	MAX	YUV / PRIV	MAX_RES	MAX	YUV / PRIV	DEFAULT	PREVIEW	JPEG	MAX_RES	MAX	Ultra high res PRIV / YUV -> YUV / JPEG reprocessing with seperate preview

No additional mandatory stream combinations for RAW capability and LEVEL-3 hardware level.

Constrained high-speed recording

The application can use a[normal capture session](/reference/android/hardware/camera2/params/SessionConfiguration#SESSION%5FREGULAR) for high speed capture if the desired high speed FPS ranges are advertised by[CameraCharacteristics.CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES](/reference/android/hardware/camera2/CameraCharacteristics#CONTROL%5FAE%5FAVAILABLE%5FTARGET%5FFPS%5FRANGES), in which case all API semantics associated with normal capture sessions applies.

A[high-speed capture session](/reference/android/hardware/camera2/params/SessionConfiguration#SESSION%5FHIGH%5FSPEED) can be use for high speed video recording (>=120fps) when the camera device supports high speed video capability (i.e., [CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES](/reference/android/hardware/camera2/CameraCharacteristics#REQUEST%5FAVAILABLE%5FCAPABILITIES) contains [CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FCONSTRAINED%5FHIGH%5FSPEED%5FVIDEO)). A constrained high-speed capture session has special limitations compared with a normal capture session:

In addition to the output target Surface requirements specified above for regular captures, a high speed capture session will only support up to 2 output Surfaces, though the application might choose to configure just one Surface (e.g., preview only). All Surfaces must be either video encoder surfaces (acquired by[MediaRecorder.getSurface()](/reference/android/media/MediaRecorder#getSurface%28%29) or[MediaCodec.createInputSurface()](/reference/android/media/MediaCodec#createInputSurface%28%29)) or preview surfaces (obtained from[SurfaceView](/reference/android/view/SurfaceView), [SurfaceTexture](/reference/android/graphics/SurfaceTexture) via[Surface.Surface(android.graphics.SurfaceTexture)](/reference/android/view/Surface#Surface%28android.graphics.SurfaceTexture%29)). The Surface sizes must be one of the sizes reported by [StreamConfigurationMap.getHighSpeedVideoSizes](/reference/android/hardware/camera2/params/StreamConfigurationMap#getHighSpeedVideoSizes%28%29). When multiple Surfaces are configured, their size must be same.
An active high speed capture session only accepts request lists created via[CameraConstrainedHighSpeedCaptureSession.createHighSpeedRequestList](/reference/android/hardware/camera2/CameraConstrainedHighSpeedCaptureSession#createHighSpeedRequestList%28android.hardware.camera2.CaptureRequest%29), and the request list can only be submitted to this session via[captureBurst](/reference/android/hardware/camera2/CameraCaptureSession#captureBurst%28java.util.List<android.hardware.camera2.CaptureRequest>,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29), or[setRepeatingBurst](/reference/android/hardware/camera2/CameraCaptureSession#setRepeatingBurst%28java.util.List<android.hardware.camera2.CaptureRequest>,%20android.hardware.camera2.CameraCaptureSession.CaptureCallback,%20android.os.Handler%29).
The FPS ranges being requested to this session must be selected from[StreamConfigurationMap.getHighSpeedVideoFpsRangesFor](/reference/android/hardware/camera2/params/StreamConfigurationMap#getHighSpeedVideoFpsRangesFor%28android.util.Size%29). The application can still use[CaptureRequest.CONTROL_AE_TARGET_FPS_RANGE](/reference/android/hardware/camera2/CaptureRequest#CONTROL%5FAE%5FTARGET%5FFPS%5FRANGE) to control the desired FPS range. Switching to an FPS range that has different[maximum FPS](/reference/android/util/Range#getUpper%28%29) may trigger some camera device reconfigurations, which may introduce extra latency. It is recommended that the application avoids unnecessary maximum target FPS changes as much as possible during high speed streaming.
For the request lists submitted to this session, the camera device will override the[control mode](/reference/android/hardware/camera2/CaptureRequest#CONTROL%5FMODE), auto-exposure (AE), auto-white balance (AWB) and auto-focus (AF) to [CameraMetadata.CONTROL_MODE_AUTO](/reference/android/hardware/camera2/CameraMetadata#CONTROL%5FMODE%5FAUTO),[CameraMetadata.CONTROL_AE_MODE_ON](/reference/android/hardware/camera2/CameraMetadata#CONTROL%5FAE%5FMODE%5FON), [CameraMetadata.CONTROL_AWB_MODE_AUTO](/reference/android/hardware/camera2/CameraMetadata#CONTROL%5FAWB%5FMODE%5FAUTO) and [CameraMetadata.CONTROL_AF_MODE_CONTINUOUS_VIDEO](/reference/android/hardware/camera2/CameraMetadata#CONTROL%5FAF%5FMODE%5FCONTINUOUS%5FVIDEO), respectively. All post-processing block mode controls will be overridden to be FAST. Therefore, no manual control of capture and post-processing parameters is possible. Beside these, only a subset of controls will work, see[CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO](/reference/android/hardware/camera2/CameraMetadata#REQUEST%5FAVAILABLE%5FCAPABILITIES%5FCONSTRAINED%5FHIGH%5FSPEED%5FVIDEO) for more details.

Parameters
config	SessionConfiguration: A session configuration (see SessionConfiguration).

Throws
CameraAccessException	In case the camera device is no longer connected or has encountered a fatal error.
IllegalArgumentException	In case the session configuration is invalid; or the output configurations are empty; or the session configuration executor is invalid; or the output dynamic range combination is invalid/unsupported; or the session type is not shared when camera has been opened in shared mode.

See also:

[createCaptureSession(List,CameraCaptureSession.StateCallback,Handler)](/reference/android/hardware/camera2/CameraDevice#createCaptureSession%28java.util.List<android.view.Surface>,%20android.hardware.camera2.CameraCaptureSession.StateCallback,%20android.os.Handler%29)
[createCaptureSessionByOutputConfigurations(List, StateCallback, Handler)](/reference/android/hardware/camera2/CameraDevice#createCaptureSessionByOutputConfigurations%28java.util.List<android.hardware.camera2.params.OutputConfiguration>,%20android.hardware.camera2.CameraCaptureSession.StateCallback,%20android.os.Handler%29)
[createReprocessableCaptureSession(InputConfiguration, List, StateCallback, Handler)](/reference/android/hardware/camera2/CameraDevice#createReprocessableCaptureSession%28android.hardware.camera2.params.InputConfiguration,%20java.util.List<android.view.Surface>,%20android.hardware.camera2.CameraCaptureSession.StateCallback,%20android.os.Handler%29)
[createConstrainedHighSpeedCaptureSession(List, StateCallback, Handler)](/reference/android/hardware/camera2/CameraDevice#createConstrainedHighSpeedCaptureSession%28java.util.List<android.view.Surface>,%20android.hardware.camera2.CameraCaptureSession.StateCallback,%20android.os.Handler%29)
[OutputConfiguration.setDynamicRangeProfile](/reference/android/hardware/camera2/params/OutputConfiguration#setDynamicRangeProfile%28long%29)
[DynamicRangeProfiles](/reference/android/hardware/camera2/params/DynamicRangeProfiles)

createExtensionSession

public void createExtensionSession (ExtensionSessionConfiguration extensionConfiguration)

Initialize a specific device-specific extension augmented camera capture session.

Extension sessions can be used to enable device-specific operation modes like[CameraExtensionCharacteristics.EXTENSION_NIGHT](/reference/android/hardware/camera2/CameraExtensionCharacteristics#EXTENSION%5FNIGHT) or[CameraExtensionCharacteristics.EXTENSION_HDR](/reference/android/hardware/camera2/CameraExtensionCharacteristics#EXTENSION%5FHDR). These modes are less flexible than the full camera API, but enable access to more sophisticated processing algorithms that can capture multi-frame bursts to generate single output images. To query for available extensions on this device call[CameraExtensionCharacteristics.getSupportedExtensions()](/reference/android/hardware/camera2/CameraExtensionCharacteristics#getSupportedExtensions%28%29).

This method will also trigger the setup of the internal processing pipeline for extension augmented preview and multi-frame still capture.

The CameraExtensionSession will be active until the client either calls CameraExtensionSession.close() or creates a new camera capture session. In both cases all internal resources will be released, continuous repeating requests stopped and any pending multi-frame capture requests flushed.

Note that the CameraExtensionSession currently supports at most wo multi frame capture surface formats: ImageFormat.JPEG will be supported by all extensions and ImageFormat.YUV_420_888 may or may not be supported. Clients must query the multi-frame capture format support using[CameraExtensionCharacteristics.getExtensionSupportedSizes(int,int)](/reference/android/hardware/camera2/CameraExtensionCharacteristics#getExtensionSupportedSizes%28int,%20int%29). For repeating requests CameraExtensionSession supports only[SurfaceTexture](/reference/android/graphics/SurfaceTexture) as output. Clients can query the supported resolution for the repeating request output using[getExtensionSupportedSizes(..., Class)](/reference/android/hardware/camera2/CameraExtensionCharacteristics#getExtensionSupportedSizes%28int,%20java.lang.Class<T>%29).

At the very minimum the initialization expects either one valid output surface for repeating or one valid output for high-quality single requests registered in the outputs argument of the extension configuration argument. At the maximum the initialization will accept two valid output surfaces, one for repeating and the other for single requests. Additional unsupported surfaces passed to ExtensionSessionConfiguration will cause an[IllegalArgumentException](/reference/java/lang/IllegalArgumentException) to be thrown.

Parameters
extensionConfiguration	ExtensionSessionConfiguration: extension configuration. This value cannot be null.

Throws
IllegalArgumentException	If both the preview and still capture surfaces are not set or invalid, or if any of the registered surfaces do not meet the device-specific extension requirements such as dimensions and/or (output format)/(surface type), or if the extension is not supported, or if any of the output configurations select a dynamic range different fromDynamicRangeProfiles.STANDARD, or if any of the output configurations sets a stream use case different from CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT.
UnsupportedOperationException	if the camera has been opened in shared mode
CameraAccessException

See also:

[CameraExtensionCharacteristics.getSupportedExtensions](/reference/android/hardware/camera2/CameraExtensionCharacteristics#getSupportedExtensions%28%29)
[CameraExtensionCharacteristics.getExtensionSupportedSizes](/reference/android/hardware/camera2/CameraExtensionCharacteristics#getExtensionSupportedSizes%28int,%20int%29)

setCameraAudioRestriction

public void setCameraAudioRestriction (int mode)

Set audio restriction mode when this CameraDevice is being used.

Some camera hardware (e.g. devices with optical image stabilization support) are sensitive to device vibration and video recordings can be ruined by unexpected sounds. Applications can use this method to suppress vibration or sounds coming from ringtones, alarms or notifications. Other vibration or sounds (e.g. media playback or accessibility) will not be muted.

The mute mode is a system-wide setting. When multiple CameraDevice objects are setting different modes, the system will pick a the mode that's union of all modes set by CameraDevice. Applications can also use[getCameraAudioRestriction()](/reference/android/hardware/camera2/CameraDevice#getCameraAudioRestriction%28%29) to query current system-wide camera mute mode in effect.

The mute settings from this CameraDevice will be automatically removed when the CameraDevice is closed or the application is disconnected from the camera.

Parameters
mode	int: An enumeration selecting the audio restriction mode for this camera device. Value is one of the following: AUDIO_RESTRICTION_NONE AUDIO_RESTRICTION_VIBRATION AUDIO_RESTRICTION_VIBRATION_SOUND

Throws
CameraAccessException	if the camera device is no longer connected or has encountered a fatal error
IllegalArgumentException	if the mode is not supported
IllegalStateException	if the camera device has been closed