Share via


CameraManager.ConcurrentCameraIds Property

Definition

Return the set of combinations of currently connected camera device identifiers, which support configuring camera device sessions concurrently.

public System.Collections.Generic.ICollection<System.Collections.Generic.ICollection<string>> ConcurrentCameraIds { [Android.Runtime.Register("getConcurrentCameraIds", "()Ljava/util/Set;", "", ApiSince=30)] get; }
[<get: Android.Runtime.Register("getConcurrentCameraIds", "()Ljava/util/Set;", "", ApiSince=30)>]
member this.ConcurrentCameraIds : System.Collections.Generic.ICollection<System.Collections.Generic.ICollection<string>>

Property Value

The set of combinations of currently connected camera devices, that may have sessions configured concurrently. The set of combinations will be empty if no such combinations are supported by the camera subsystem.

Attributes

Remarks

Return the set of combinations of currently connected camera device identifiers, which support configuring camera device sessions concurrently.

The devices in these combinations can be concurrently configured by the same client camera application. Using these camera devices concurrently by two different applications is not guaranteed to be supported, however.

For concurrent operation, in chronological order : <ul> <li> Applications must first close any open cameras that have sessions configured, using CameraDevice#close. </li> <li> All camera devices intended to be operated concurrently, must be opened using #openCamera, before configuring sessions on any of the camera devices.</li> </ul>

Each device in a combination, is guaranteed to support stream combinations which may be obtained by querying #getCameraCharacteristics for the key android.hardware.camera2.CameraCharacteristics#SCALER_MANDATORY_CONCURRENT_STREAM_COMBINATIONS.

For concurrent operation, if a camera device has a non null zoom ratio range as specified by android.hardware.camera2.CameraCharacteristics#CONTROL_ZOOM_RATIO_RANGE, its complete zoom ratio range may not apply. Applications can use android.hardware.camera2.CaptureRequest#CONTROL_ZOOM_RATIO >=1 and <= android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM during concurrent operation.

The set of combinations may include camera devices that may be in use by other camera API clients.

Concurrent camera extension sessions CameraExtensionSession are not currently supported.

The set of combinations doesn't contain physical cameras that can only be used as part of a logical multi-camera device.

If a new camera id becomes available through AvailabilityCallback#onCameraUnavailable(String), clients can call this method to check if new combinations of camera ids which can stream concurrently are available.

Java documentation for android.hardware.camera2.CameraManager.getConcurrentCameraIds().

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