ConcurrentCamera

class ConcurrentCamera

Concurrent camera is a new feature introduced from Android 11, which supports simultaneous streaming of camera devices, for example, it allows a device to have both the front and back cameras operating at the same time.

A concurrent camera object is returned after binding concurrent cameras to LifecycleOwner. It includes a list of Cameras which are operating at the same time. Before binding to LifecycleOwner, check FEATURE_CAMERA_CONCURRENT to see whether this device is supporting concurrent camera or not.

Concurrent camera also supports composition mode, where multiple camera streams are composited into a single stream. This can be used for Picture-in-Picture or other custom layouts. Use CompositionSettings to configure the layout of each camera stream.

CameraX currently only supports dual concurrent camera, which allows two cameras operating at the same time, with at most two UseCases bound for each. The max resolution is 720p or 1440p, more details in the following link, see concurrent camera streaming

Summary

ConcurrentCamera(cameras: (Mutable)List<Camera!>)

fun getCameras(): (Mutable)List<Camera!>

fun setCompositionSettings(
    compositionSettings: (Mutable)List<CompositionSettings!>
): Unit

List<SingleCameraConfig> singleCameraConfigs = Arrays.asList(config1, config2);
ConcurrentCamera concurrentCamera = cameraProvider.bindToLifecycle(singleCameraConfigs);

// Primary becomes PiP, Secondary becomes full screen
CompositionSettings primary = new CompositionSettings.Builder()
        .setOffset(0.5f, 0.5f)
        .setScale(0.3f, 0.3f)
        .setZOrder(1) // Display on top
        .build();
CompositionSettings secondary = new CompositionSettings.Builder()
        .setZOrder(0)
        .build();

// The size of the list must match the number of cameras bound (in this case, 2)
concurrentCamera.setCompositionSettings(Arrays.asList(primary, secondary));