Visor de la cámara

En esta tabla, se enumeran todos los artefactos del grupo androidx.camera-viewfinder.

Cómo declarar dependencias

Para agregar una dependencia en camera-viewfinder, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

dependencies {
    // Use to implement camera viewfinders
    
    implementation "androidx.camera.viewfinder:viewfinder-view:1.5.0-beta03"
    implementation "androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta03"
    implementation "androidx.camera.viewfinder:viewfinder-core:1.5.0-beta03"

}

dependencies {
    // Use to implement camera viewfinders
    implementation("androidx.camera.viewfinder:viewfinder-view:1.5.0-beta03")
    implementation("androidx.camera.viewfinder:viewfinder-core:1.5.0-beta03")
    implementation("androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta03")


}

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Versión 1.5

Versión 1.5.0-beta03

16 de julio de 2025

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta03, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta03 y androidx.camera.viewfinder:viewfinder-view:1.5.0-beta03. La versión 1.5.0-beta03 contiene estas confirmaciones.

Correcciones de errores

• El ImplementationMode predeterminado para Viewfinder (tanto para Compose como para las basadas en View) ahora selecciona de forma inteligente entre EXTERNAL (para el rendimiento) y EMBEDDED (para la compatibilidad en APIs anteriores o dispositivos poco comunes). Este comportamiento se puede anular con parámetros de configuración explícitos en ViewfinderSurfaceRequest o atributos XML (en la API basada en View). (Iecd3a)
• Se mejoró la administración de sesiones de Surface permitiendo que ViewfinderSurfaceSession se mantenga activo durante los ciclos de vida de creación y destrucción de superficies cuando se usa TextureView o SurfaceView en la API 29 y versiones posteriores. (I112d9)
• El Viewfinder ahora garantiza que las Surfaces se liberen en el momento adecuado, solo cuando la sesión ya no las use, en lugar de liberarlas siempre cuando se descarta el elemento Composable. En el caso de EXTERNAL (SurfaceView), este comportamiento solo está disponible en el nivel de API 29 y versiones posteriores. En el caso de EMBEDDED (TextureView), este comportamiento está presente en todos los niveles de API. (I9a03f)
• El Viewfinder ahora controla correctamente el reemplazo de superficies en situaciones como cuando un visor de EXTERNAL en el nivel de API 28 o inferior se mueve fuera de la pantalla o si un Viewfinder (con cualquier ImplementationMode) forma parte de moveableContentOf(). (I79432)
• El elemento Viewfinder componible ahora funciona correctamente con el elemento Pager de Compose. Este cambio garantiza que el elemento Composable se pueda restablecer correctamente implementando la devolución de llamada onReset de AndroidView, lo que admite implementaciones de EMBEDDED y EXTERNAL. (I0d9be)
• Se solucionó un problema en Android 10 y 11 por el que el EXTERNAL Viewfinder podía aparecer estirado o incorrecto debido a que las operaciones de transformación (como escalar o trasladar) se aplicaban demasiado pronto. Ahora, el sistema espera a que se cree la Surface antes de aplicar estas transformaciones en la fase de diseño, lo que garantiza una salida correcta. (Icc77c)

Versión 1.5.0-beta02

4 de junio de 2025

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta02, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta02 y androidx.camera.viewfinder:viewfinder-view:1.5.0-beta02. La versión 1.5.0-beta02 contiene estas confirmaciones.

Versión 1.5.0-beta01

7 de mayo de 2025

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01 y androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01. La versión 1.5.0-beta01 contiene estas confirmaciones.

• Esta es la primera versión beta oficial de los visores basados en vistas y en Compose, que son lo suficientemente flexibles como para usarse con Camera2. Si buscas un elemento View o componible para usar con CameraX, consulta PreviewView y CameraXViewfinder.

Nuevas funciones

• Ahora se pueden usar ContentScale y Alignment en el visor basado en Compose para escalar y colocar la superficie mostrada dentro de su contenedor, de manera similar a como se comporta androidx.compose.foundation.Image. (Ibcea3)

Cambios en la API

• TransformationInfo ahora tiene valores predeterminados para todos los argumentos. Esto permitirá que se creen Viewfinders sin ningún TransformationInfo, que se establecerá de forma predeterminada en una rotación de la fuente de 0, sin duplicación de la fuente y sin un rectángulo de recorte. (I2b1b2)
• El visor componible ahora toma una expresión lambda final para recibir una sesión de Surface, de manera similar a AndroidExternalSurface. La expresión lambda proporcionada usa ViewfinderInitScope como receptor, lo que permite instalar una devolución de llamada para recibir nuevas sesiones de Surface. Estas sesiones de superficie liberan automáticamente los recursos que mantiene el Buscador cuando salen del alcance. (Ib2b0d)
• ViewfinderSurfaceRequest.Builder.populateFromCharacteristics se quitó y se reemplazó por un conjunto equivalente de APIs estáticas que se pueden usar para generar TransformationInfo, que producirá la misma transformación que populateFromCharacteristics. Estos métodos estáticos se agregan a la clase Camera2TransformationInfo. (Idc6af)
• ViewfinderSurfaceRequest ya no incluye APIs asíncronas para recuperar la superficie. Ahora es un tipo de datos inmutable. Las APIs para recuperar la Surface ahora se trasladaron al visor. (I30127)
• Se cambió el nombre de CameraViewfinder a ViewfinderView para que coincida con el nombre del elemento componible Viewfinder y para indicar que se puede usar con más fuentes que solo las de la cámara. (Id9e6b)
• Las clases de viewfinder-view se movieron al subpaquete androidx.camera.viewfinder.view del paquete androidx.camera.viewfinder. (I6cb44)
• Se agregaron nuevas APIs al visor basado en vistas que permiten establecer la rotación, la duplicación y el rectángulo de recorte de la fuente. Esta clase TransformationInfo es la misma que usa el Viewfinder basado en Compose. (I907c3)
• El Visor basado en vistas ahora usa nuevas APIs de ViewfinderSurfaceRequest que ya no controlan internamente la respuesta de Surface. En lugar de devolver ListenableFuture<Surface>, las APIs de requestSurfaceSession() ahora devuelven ListenableFuture<ViewfinderSurfaceSession>, que devuelve una clase AutoCloseable que, cuando se cierra, se comporta de la misma manera que cuando se llama a la API anterior de ViewfinderSurfaceRequest.markSurfaceSafeToRelease(). Esto proporciona una separación más clara de las responsabilidades entre la solicitud y la respuesta de la superficie. (I19041)

Versión 1.4

Versión 1.4.0-alpha13

26 de febrero de 2025

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha13, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha13 y androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha13. La versión 1.4.0-alpha13 contiene estas confirmaciones.

Versión 1.4.0-alpha12

15 de enero de 2025

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12 y androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12. La versión 1.4.0-alpha12 contiene estas confirmaciones.

Nuevas funciones

• Se actualizó compileSdk a 35 para usar la API relacionada con Android 15. Las apps que usan bibliotecas de CameraX también deberán actualizar su parámetro de configuración de compileSdk. (Ic80cd)
• Esta biblioteca ahora usa anotaciones de nulabilidad de JSpecify, que son de uso de tipo. Los desarrolladores de Kotlin deberían usar el siguiente argumento del compilador para aplicar el uso correcto: -Xjspecify-annotations=strict (este es el valor predeterminado a partir de la versión 2.1.0 del compilador de Kotlin). (I7bcd7, b/326456246)

Versión 1.4.0-alpha11

11 de diciembre de 2024

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 y androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11. La versión 1.4.0-alpha11 contiene estas confirmaciones.

Cambios en la API

• Las clases viewfinder-core se movieron a paquetes coherentes con la biblioteca a la que pertenecen. (I431c6)
• Se movió CameraViewfinder.ScaleType a viewfinder-core para que se pueda reutilizar con Compose (I87ef1).
• Se quitaron las clases CameraViewfinder obsoletas. Usa las nuevas APIs que proporcionan una funcionalidad equivalente. (I6e59a)

Versión 1.4.0-alpha10

30 de octubre de 2024

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 y androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10. La versión 1.4.0-alpha10 contiene estas confirmaciones.

Versión 1.4.0-alpha09

2 de octubre de 2024

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 y androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09. La versión 1.4.0-alpha09 contiene estas confirmaciones.

Versión 1.4.0-alpha08

4 de septiembre de 2024

Lanzamiento de androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 y androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08. La versión 1.4.0-alpha08 contiene estas confirmaciones.

Nuevas funciones

Con la actualización a la versión 1.4.0-alpha08, el artefacto del visor de CameraX se movió a su propio grupo de bibliotecas. Este cambio es necesario para mejorar la modularidad y el mantenimiento de la biblioteca de CameraX.

Si antes dependías de androidx.camera:camera-viewfinder, androidx.camera:camera-viewfinder-compose o androidx.camera:camera-viewfinder-core, deberás migrar tus dependencias a lo siguiente:

• androidx.camera:camera-viewfinder -> androidx.camera.viewfinder:viewfinder-view
• androidx.camera:camera-viewfinder-compose -> androidx.camera.viewfinder:viewfinder-compose
• androidx.camera:camera-viewfinder-core -> androidx.camera.viewfinder:viewfinder-core

No se deberían requerir cambios en el código para realizar esta transición. Las coordenadas de Maven del antiguo Viewfinder ya no recibirán actualizaciones.

Además, si usas Compose con CameraX, ahora hay disponible una nueva biblioteca que prioriza Compose en versión alfa: androidx.camera:camera-compose. Esto proporciona el elemento CameraXViewfinder componible, que es un visor idiomático de Compose que adapta el elemento SurfaceRequest de CameraX a Compose, de manera similar a como funciona PreviewView para las vistas.