SessionConfig

public class SessionConfig

import androidx.camera.core.CameraEffect
import androidx.camera.core.DynamicRange
import androidx.camera.core.ImageAnalysis
import androidx.camera.core.Preview
import androidx.camera.core.SessionConfig
import androidx.camera.core.featuregroup.GroupableFeature.Companion.FPS_60
import androidx.camera.core.featuregroup.GroupableFeature.Companion.HDR_HLG10
import androidx.camera.core.featuregroup.GroupableFeature.Companion.PREVIEW_STABILIZATION
import androidx.camera.video.GroupableFeatures.FHD_RECORDING
import androidx.camera.video.GroupableFeatures.UHD_RECORDING
import androidx.camera.video.Recorder
import androidx.camera.video.VideoCapture

// Create a session config where HDR is mandatory while 60 FPS (higher priority) and preview
// stabilization are optional
SessionConfig(
    useCases = listOf(Preview.Builder().build()),
    requiredFeatureGroup = setOf(HDR_HLG10),
    preferredFeatureGroup = listOf(FPS_60, PREVIEW_STABILIZATION),
)

// Creating the following SessionConfig will throw an exception as there are conflicting
// information. HDR is mentioned once as required and then again as preferred, it can't be both!
SessionConfig(
    useCases = listOf(Preview.Builder().build()),
    requiredFeatureGroup = setOf(HDR_HLG10),
    preferredFeatureGroup = listOf(FPS_60, HDR_HLG10),
)

// Creating the following SessionConfig will throw an exception as a groupable feature (HDR) is
// configured with non-grouping API while using grouping API as well. HDR is configured to the
// with a non-grouping API through the Preview use case, so it can't be grouped together
// properly with the other groupable features. Instead, it should be configured like the first
// SessionConfig construction in this code snippet.
SessionConfig(
    useCases =
        listOf(Preview.Builder().apply { setDynamicRange(DynamicRange.HLG_10_BIT) }.build()),
    preferredFeatureGroup = listOf(FPS_60, PREVIEW_STABILIZATION),
)

// Creating the following SessionConfig will throw an exception due to the conflicting
// information. The features UHD_RECORDING and FHD_RECORDING share the same type
// (FEATURE_TYPE_RECORDING_QUALITY), meaning both can't be simultaneously required. This is
// akin to requesting the final video recording size to be both UHD and FHD at the same time.
SessionConfig(
    useCases =
        listOf(Preview.Builder().build(), VideoCapture.withOutput(Recorder.Builder().build())),
    requiredFeatureGroup = setOf(HDR_HLG10, UHD_RECORDING, FHD_RECORDING),
    preferredFeatureGroup = listOf(FPS_60),
)

// Creating the following SessionConfig will throw an exception as ImageAnalysis is not yet
// supported with groupable features.
SessionConfig(
    useCases = listOf(ImageAnalysis.Builder().build()),
    requiredFeatureGroup = setOf(HDR_HLG10),
    preferredFeatureGroup = listOf(FPS_60, HDR_HLG10),
)

// Creating the following SessionConfig will throw an exception as CameraEffect is not yet
// supported with groupable features.
SessionConfig(
    useCases = listOf(Preview.Builder().build()),
    requiredFeatureGroup = setOf(HDR_HLG10),
    preferredFeatureGroup = listOf(FPS_60, HDR_HLG10),
    effects = effects,
)