CameraDevice.CreateCaptureRequest Method

Definition

Namespace:: Android.Hardware.Camera2

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

Name	Description
CreateCaptureRequest(CameraTemplate)	Create a `CaptureRequest.Builder` for new capture requests, initialized with template for a target use case.
CreateCaptureRequest(CameraTemplate, ICollection<String>)	Create a `CaptureRequest.Builder` for new capture requests, initialized with template for a target use case.

CreateCaptureRequest(CameraTemplate)

Create a CaptureRequest.Builder for new capture requests, initialized with template for a target use case.

[Android.Runtime.Register("createCaptureRequest", "(I)Landroid/hardware/camera2/CaptureRequest$Builder;", "GetCreateCaptureRequest_IHandler")]
public abstract Android.Hardware.Camera2.CaptureRequest.Builder CreateCaptureRequest(Android.Hardware.Camera2.CameraTemplate templateType);

[<Android.Runtime.Register("createCaptureRequest", "(I)Landroid/hardware/camera2/CaptureRequest$Builder;", "GetCreateCaptureRequest_IHandler")>]
abstract member CreateCaptureRequest : Android.Hardware.Camera2.CameraTemplate -> Android.Hardware.Camera2.CaptureRequest.Builder

Parameters

templateType: CameraTemplate

An enumeration selecting the use case for this request. Not all template types are supported on every device. See the documentation for each template type for details.

Returns

CaptureRequest.Builder

a builder for a capture request, initialized with default settings for that template, and no output streams

Attributes: RegisterAttribute

Exceptions

IllegalArgumentException

if the templateType is not supported by this device.

CameraAccessException

if the camera device is no longer connected or has encountered a fatal error

IllegalStateException

if the camera device has been closed

Remarks

Java documentation for android.hardware.camera2.CameraDevice.createCaptureRequest(int).

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

CreateCaptureRequest(CameraTemplate, ICollection<String>)

Create a CaptureRequest.Builder for new capture requests, initialized with template for a target use case.

[Android.Runtime.Register("createCaptureRequest", "(ILjava/util/Set;)Landroid/hardware/camera2/CaptureRequest$Builder;", "GetCreateCaptureRequest_ILjava_util_Set_Handler", ApiSince=28)]
public virtual Android.Hardware.Camera2.CaptureRequest.Builder CreateCaptureRequest(Android.Hardware.Camera2.CameraTemplate templateType, System.Collections.Generic.ICollection<string>? physicalCameraIdSet);

[<Android.Runtime.Register("createCaptureRequest", "(ILjava/util/Set;)Landroid/hardware/camera2/CaptureRequest$Builder;", "GetCreateCaptureRequest_ILjava_util_Set_Handler", ApiSince=28)>]
abstract member CreateCaptureRequest : Android.Hardware.Camera2.CameraTemplate * System.Collections.Generic.ICollection<string> -> Android.Hardware.Camera2.CaptureRequest.Builder
override this.CreateCaptureRequest : Android.Hardware.Camera2.CameraTemplate * System.Collections.Generic.ICollection<string> -> Android.Hardware.Camera2.CaptureRequest.Builder

Parameters

templateType: CameraTemplate

An enumeration selecting the use case for this request. Not all template types are supported on every device. See the documentation for each template type for details.

physicalCameraIdSet: ICollection<String>

A set of physical camera ids that can be used to customize the request for a specific physical camera.

Returns

CaptureRequest.Builder

a builder for a capture request, initialized with default settings for that template, and no output streams

Attributes: RegisterAttribute

Remarks

Create a CaptureRequest.Builder for new capture requests, initialized with template for a target use case. This methods allows clients to pass physical camera ids which can be used to customize the request for a specific physical camera. The settings are chosen to be the best options for the specific logical camera device. If additional physical camera ids are passed, then they will also use the same settings template. Clients can further modify individual camera settings by calling CaptureRequest.Builder.setPhysicalCameraKey.

Individual physical camera settings will only be honored for camera session that was initialized with corresponding physical camera id output configuration OutputConfiguration.setPhysicalCameraId and the same output targets are also attached in the request by CaptureRequest.Builder.addTarget.

The output is undefined for any logical camera streams in case valid physical camera settings are attached.

Android reference for android.hardware.camera2.CameraDevice.createCaptureRequest.

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