CameraCaptureSession.UpdateOutputConfigurations 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.

Update the output configurations for this camera session.

[Android.Runtime.Register("updateOutputConfigurations", "(Ljava/util/List;)V", "GetUpdateOutputConfigurations_Ljava_util_List_Handler", ApiSince=37)]
public virtual void UpdateOutputConfigurations(System.Collections.Generic.IList<Android.Hardware.Camera2.Params.OutputConfiguration> configurations);

[<Android.Runtime.Register("updateOutputConfigurations", "(Ljava/util/List;)V", "GetUpdateOutputConfigurations_Ljava_util_List_Handler", ApiSince=37)>]
abstract member UpdateOutputConfigurations : System.Collections.Generic.IList<Android.Hardware.Camera2.Params.OutputConfiguration> -> unit
override this.UpdateOutputConfigurations : System.Collections.Generic.IList<Android.Hardware.Camera2.Params.OutputConfiguration> -> unit

Parameters

configurations: IList<OutputConfiguration>

A list of OutputConfiguration objects with the updated surface information. The size of this list must be equal to the number of currently configured outputs.

Attributes: RegisterAttribute

Remarks

Update the output configurations for this camera session.

This method allows for updating the surfaces associated with the currently configured output configurations. It is used to replace deferred surfaces with active surface instances or to swap surfaces for seamless transitions between use cases without re-initializing the entire camera session.

The number of provided configurations must match the number of currently configured outputs. Each provided OutputConfiguration must correspond to an already existing output configuration passed previously to CameraDevice.createCaptureSession(SessionConfiguration). The OutputConfiguration is identified by its properties (size, format, etc.), but can have a new surface associated with it (see OutputConfiguration.addSurface) or be marked as deferred (see OutputConfiguration.makeDeferredAndRemoveSurfaces).

This method is not for adding or removing new configurations.

Any active requests that target replaced surfaces will be stopped by this call. When a surface with active capture requests is replaced, the framework will keep track of the old surface to ensure that any in-flight buffers can return successfully before the connection is terminated.

Android reference for android.hardware.camera2.CameraCaptureSession.updateOutputConfigurations.

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