Share via


CameraMetadata.RequestAvailableCapabilitiesStreamUseCase Field

Definition

Caution

This constant will be removed in the future version. Use Android.Hardware.Camera2.RequestAvailableCapabilities enum directly instead of this field.

The camera device supports selecting a per-stream use case via android.hardware.camera2.params.OutputConfiguration#setStreamUseCase so that the device can optimize camera pipeline parameters such as tuning, sensor mode, or ISP settings for a specific user scenario.

[Android.Runtime.Register("REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE", ApiSince=33)]
[System.Obsolete("This constant will be removed in the future version. Use Android.Hardware.Camera2.RequestAvailableCapabilities enum directly instead of this field.", true)]
public const Android.Hardware.Camera2.RequestAvailableCapabilities RequestAvailableCapabilitiesStreamUseCase = 19;
[<Android.Runtime.Register("REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE", ApiSince=33)>]
[<System.Obsolete("This constant will be removed in the future version. Use Android.Hardware.Camera2.RequestAvailableCapabilities enum directly instead of this field.", true)>]
val mutable RequestAvailableCapabilitiesStreamUseCase : Android.Hardware.Camera2.RequestAvailableCapabilities

Field Value

Value = 19
Attributes

Remarks

The camera device supports selecting a per-stream use case via android.hardware.camera2.params.OutputConfiguration#setStreamUseCase so that the device can optimize camera pipeline parameters such as tuning, sensor mode, or ISP settings for a specific user scenario. Some sample usages of this capability are:

<ul> <li>Distinguish high quality YUV captures from a regular YUV stream where the image quality may not be as good as the JPEG stream, or</li> <li>Use one stream to serve multiple purposes: viewfinder, video recording and still capture. This is common with applications that wish to apply edits equally to preview, saved images, and saved videos.</li> </ul>

This capability requires the camera device to support the following stream use cases:

<ul> <li>DEFAULT for backward compatibility where the application doesn't set a stream use case</li> <li>PREVIEW for live viewfinder and in-app image analysis</li> <li>STILL_CAPTURE for still photo capture</li> <li>VIDEO_RECORD for recording video clips</li> <li>PREVIEW_VIDEO_STILL for one single stream used for viewfinder, video recording, and still capture.</li> <li>VIDEO_CALL for long running video calls</li> </ul>

android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES lists all of the supported stream use cases.

Refer to android.hardware.camera2.CameraDevice#createCaptureSession for the mandatory stream combinations involving stream use cases, which can also be queried via android.hardware.camera2.params.MandatoryStreamCombination .

Java documentation for android.hardware.camera2.CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to