CameraManager.ConcurrentCameraIds Property
Definition
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.
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.