Las apps de cámara modernas se definen por funciones potentes y superpuestas. Los usuarios esperan grabar videos con un HDR sorprendente, capturar movimientos fluidos a 60 FPS y obtener videos muy estables con la Estabilización de vista previa, a menudo, todo al mismo tiempo.

Como desarrolladores, sabemos que la realidad es más complicada. ¿Cómo puedes garantizar que un dispositivo específico realmente admite una combinación determinada? Hasta ahora, habilitar varias funciones a menudo era una apuesta. Podrías verificar la compatibilidad de cada función, pero combinarlas podría generar un comportamiento indefinido o, peor aún, una sesión de cámara fallida. Esta incertidumbre obliga a los desarrolladores a ser conservadores, lo que impide que los usuarios de dispositivos compatibles accedan a la mejor experiencia posible.

Por ejemplo, muy pocos dispositivos premium admiten de forma confiable video HDR y 60 FPS de forma simultánea. Por lo tanto, la mayoría de las apps evitan habilitar ambas opciones al mismo tiempo para evitar una mala experiencia del usuario en la mayoría de los teléfonos.

Para abordar este problema, presentamos Feature Group en CameraX, una nueva API diseñada para eliminar estas suposiciones. Ahora puedes consultar si se admite una combinación específica de funciones antes de configurar la cámara o, simplemente, indicarle a CameraX tus prioridades y permitir que habilite la combinación mejor admitida para ti.

Para quienes no conocen CameraX

Antes de profundizar en la nueva API de Feature Group, repasemos rápidamente qué es CameraX. CameraX es una biblioteca de compatibilidad de Jetpack creada para que el desarrollo de una app de cámara te resulte más fácil. Proporciona una superficie de API coherente y fácil de usar que funciona en la mayoría de los dispositivos Android, y ofrece compatibilidad con versiones anteriores hasta Android 6.0 (nivel de API 23). Si es la primera vez que usas CameraX, te recomendamos que consultes la documentación oficial y pruebes el codelab para comenzar.

Qué puedes compilar con la API de Feature Group

Ya no es necesario que apuestes por combinaciones de funciones, sino que puedes ofrecer con confianza las mejores experiencias de cámara posibles, como video HDR y de 60 FPS simultáneos en hardware compatible (p.ej., un Pixel 10 Pro), y evitar errores de forma elegante en dispositivos que no admiten la combinación.

Pixel 10 Pro que habilita HDR y 60 FPS de forma simultánea

En dispositivos más antiguos en los que HDR y 60 FPS no pueden ejecutarse de forma simultánea, solo se habilita el HDR y se inhabilita la opción de 60 FPS.

Con la API de Feature Group, puedes hacer lo siguiente:

• Crea IU dinámicas y más inteligentes: Habilita o inhabilita de forma inteligente la configuración en tu IU según la compatibilidad de hardware en tiempo real. Por ejemplo, si un usuario habilita el HDR, puedes inhabilitar y mostrar en gris al instante la opción de 60 FPS si la combinación no es compatible con ese dispositivo. 

• Ofrecer un modo "Alta calidad" confiable: Configura la cámara con una lista priorizada de las funciones deseadas. CameraX encuentra y habilita automáticamente la mejor combinación compatible para cualquier dispositivo, lo que garantiza un excelente resultado sin lógica compleja específica del dispositivo.
• Evita fallas en la sesión de la cámara: Al verificar la compatibilidad de antemano, evitas que la cámara intente configurar una combinación no admitida, lo que elimina una fuente común de fallas y ofrece una experiencia del usuario fluida.

Cómo funciona: los componentes principales

La nueva API se centra en las incorporaciones clave a SessionConfig y CameraInfo.

1. GroupableFeature: Esta API presenta un conjunto de funciones agrupables predefinidas, como HDR_HLG10, FPS_60, PREVIEW_STABILIZATION y IMAGE_ULTRA_HDR. Debido a las limitaciones computacionales, solo se puede agrupar un conjunto específico de características con el alto grado de confiabilidad que proporciona esta API. Estamos trabajando activamente para expandir esta lista y agregaremos compatibilidad con más funciones en versiones futuras.
    
2. Nuevos parámetros de SessionConfig: Esta clase, que se usa para iniciar una sesión de cámara, ahora acepta dos parámetros nuevos:
   • requiredFeatureGroup: Usa este valor para las funciones que deben admitirse para que la configuración se realice correctamente. Es ideal para las funciones que un usuario habilita de forma explícita, como activar un interruptor de "HDR". Para garantizar una experiencia determinística y coherente, la llamada bindToLifecycle arrojará un IllegalArgumentException si no se admite la combinación solicitada, en lugar de ignorar silenciosamente una solicitud de función. La API de CameraInfo#isFeatureGroupSupported (detalles a continuación) se debe usar para consultar este resultado de antemano.
   • preferredFeatureGroup: Usa esta opción para las funciones que son deseables, pero opcionales, por ejemplo, cuando deseas implementar un modo predeterminado de "alta calidad". Proporcionas una lista de las funciones que deseas ordenadas según tus prioridades, y CameraX habilita automáticamente la combinación de mayor prioridad que admite el dispositivo.
3. CameraInfo#isFeatureGroupSupported(): Este es el método de consulta principal para verificar de forma explícita si se admite un grupo de funciones, y es adecuado para proporcionar solo las opciones de funciones admitidas a los usuarios en la IU de tu app. Le pasas un SessionConfig y devuelve un valor booleano que indica si se admite la combinación. Si planeas vincular un SessionConfig con funciones requeridas, primero debes usar esta API para asegurarte de que sea compatible. 

Implementación en la práctica

Veamos cómo usar estos componentes para crear una mejor experiencia de cámara.

Situación 1: Modo de alta calidad con "mejor esfuerzo"

Si deseas habilitar las mejores funciones posibles de forma predeterminada, puedes proporcionar una lista priorizada a preferredFeatureGroup. En este ejemplo, le indicamos a CameraX que priorice el HDR, luego los 60 FPS y, por último, la estabilización de la vista previa. CameraX controla la complejidad de verificar todas las combinaciones posibles y elegir la mejor que admite el dispositivo.

Por ejemplo, si un dispositivo puede controlar HDR y 60 FPS juntos, pero no con la estabilización de vista previa, CameraX habilitará los dos primeros y descartará el tercero. De esta manera, obtendrás la mejor experiencia posible sin escribir verificaciones complejas y específicas del dispositivo.

cameraProvider.bindToLifecycle(

    lifecycleOwner,

    cameraSelector,

    SessionConfig(

        useCases = listOf(preview, videoCapture),

        // The order of features in this list determines their priority. 

        // CameraX will enable the best-supported combination based on these

        // priorities: HDR_HLG10 > FPS_60 > Preview Stabilization.  

        preferredFeatureGroup =

           listOf(HDR_HLG10, FPS_60, PREVIEW_STABILIZATION),

    ).apply {

        // (Optional) Get a callback with the enabled features

        // to update your UI. 

        setFeatureSelectionListener { selectedFeatures ->

            updateUiIndicators(selectedFeatures)

        }

    }

)

En este fragmento de código, CameraX intentará habilitar combinaciones de funciones en el siguiente orden de prioridad, y seleccionará la primera que el dispositivo admita por completo:

1. HDR + 60 FPS + Estabilización de versión preliminar
2. HDR y 60 FPS
3. HDR + Estabilización de versión preliminar
4. HDR
5. 60 FPS y estabilización de vista previa
6. 60 FPS
7. Estabilización de versión preliminar
8. Ninguna de las funciones anteriores

Situación 2: Cómo compilar una IU reactiva

Para crear una IU que responda a las selecciones del usuario y evitar que este seleccione una combinación de funciones no admitida, puedes consultar la compatibilidad directamente. La siguiente función verifica qué funciones son incompatibles con las selecciones actuales del usuario, lo que te permite inhabilitar los elementos de la IU correspondientes.

/**

 * Returns a list of features that are NOT supported in combination

 * with the currently selected features.

 */

fun getUnsupportedFeatures(

    currentFeatures: Set<GroupableFeature>

): Set<GroupableFeature> {

    val unsupportedFeatures = mutableSetOf<GroupableFeature>()

    val appFeatureOptions = setOf(HDR_HLG10, FPS_60, PREVIEW_STABILIZATION)


    // Iterate over every available feature option in your app. 

    appFeatureOptions.forEach { featureOption ->

        // Skip features the user has already selected. 

        if (currentFeatures.contains(featureOption)) return@forEach


        // Check if adding this new feature is supported. 

        val isSupported = cameraInfo.isFeatureGroupSupported(

            SessionConfig(

                useCases = useCases,

                // Check the new feature on top of existing ones.

                requiredFeatureGroup = currentFeatures + featureOption

            )

        )


        if (!isSupported) {

            unsupportedFeatures.add(featureOption)

        }

    }


    return unsupportedFeatures

}

Luego, puedes conectar esta lógica a tu ViewModel o controlador de IU para reaccionar a la entrada del usuario y volver a vincular la cámara con una configuración que garantiza el funcionamiento.

// Invoked when user turns some feature on/off.

fun onFeatureChange(currentFeatures: Set<GroupableFeature>) {

    // Identify features that are unsupported with the current selection.

    val unsupportedFeatures = getUnsupportedFeatures(currentFeatures)



    // Update app UI so that users can't enable them.

    updateDisabledFeatures(unsupportedFeatures)



    // Since the UI now only allows selecting supported feature combinations, 

    // `currentFeatures` is always valid. This allows setting

    // `requiredFeatureGroup` directly, without needing to re-check for

    // support or set a feature selection listener.  

    cameraProvider.bindToLifecycle(

        lifecycleOwner,

        cameraSelector,

        SessionConfig(

            useCases = listOf(preview, videoCapture),

            requiredFeatureGroup = currentFeatures,

        )

    )

}

Para ver estos conceptos en una aplicación en funcionamiento, puedes explorar nuestra app de prueba interna, que proporciona una implementación completa de las situaciones de "mejor esfuerzo" y de "IU reactiva" que se analizaron anteriormente.

Nota: Esta es una aplicación de prueba y no una muestra con asistencia oficial. Si bien es una excelente referencia para la API de Feature Group, no se ha perfeccionado para su uso en producción.

Comienza hoy mismo

La API de Feature Group elimina la ambigüedad de trabajar con capacidades avanzadas de la cámara. Si proporcionas una forma determinística de consultar la compatibilidad con funciones, puedes compilar apps para cámaras más potentes y confiables con confianza.

La API está disponible como experimental en CameraX 1.5 y está previsto que se vuelva completamente estable en la versión 1.6, con más compatibilidad y mejoras en camino.

Para obtener más información, consulta la documentación oficial. Estamos ansiosos por ver tus creaciones y recibir tus comentarios. Comparte tu opinión y comunícanos cualquier problema a través de los siguientes canales:

• Grupo de discusión para desarrolladores de CameraX
• Informa un error aquí