Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Panoramica di CameraX
Componente di Android Jetpack.
CameraX è una libreria Jetpack realizzata per semplificare lo sviluppo di app per fotocamera.
Per le nuove app, ti consigliamo di iniziare con CameraX. Fornisce un'API coerente e facile da usare, compatibile con la stragrande maggioranza dei dispositivi Android, con compatibilità con le versioni precedenti ad Android 5.0 (livello API 21). Se stai eseguendo la migrazione di un'app da Fotocamera1, consulta la nostra guida alla migrazione da Fotocamera1 a FotocameraX.
Vantaggi principali
CameraX migliora l'esperienza degli sviluppatori in diversi modi principali.
Ampia compatibilità con i dispositivi
CameraX supporta dispositivi con
Android 5.0 (livello API 21) e versioni successive,
che rappresentano oltre il 98% dei dispositivi Android esistenti.
Facilità d'uso
CameraX mette in risalto i casi d'uso, che consentono di concentrarsi sull'attività da svolgere invece di gestire le sfumature specifiche del dispositivo.
Sono supportati i casi d'uso più comuni delle videocamere:
Regolarità tra dispositivi
Figura 2. Il laboratorio di test automatizzato di CameraX garantisce un'esperienza API coerente su molti tipi di dispositivi e produttori.
Mantenere un comportamento coerente della videocamera è difficile. Devi considerare proporzioni, orientamento, rotazione, dimensioni dell'anteprima e dimensioni dell'immagine.
Con CameraX, questi comportamenti di base funzionano correttamente.
Gestiamo un laboratorio di test automatizzato di CameraX che verifica vari comportamenti della videocamera su una gamma di dispositivi e su tutte le versioni di sistema operativo a partire da Android 5.0. Questi test vengono eseguiti su base continuativa per identificare e risolvere un'ampia gamma di problemi.
Estensioni per fotocamera
Figura 3. Un'immagine acquisita con l'effetto bokeh (ritratto) con CameraX.
CameraX dispone di un'API Estensioni facoltativa che
ti consente di accedere alle stesse caratteristiche e capacità dell'app per videocamera nativa
di un dispositivo con appena due righe di codice.
Le estensioni includono bokeh (ritratto), HDR (High Dynamic Range),
modalità notturna e ritocco viso, e tutte richiedono il supporto del dispositivo.
Case study
Per scoprire in che modo CameraX ha semplificato lo sviluppo per Monzo,
consulta il case study.
Documentazione
Risorse aggiuntive
Per saperne di più su CameraX, consulta le seguenti risorse aggiuntive.
Codelab
Introduzione a CameraX
Esempio di codice
Esempi di app CameraX
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-26 UTC."],[],[],null,["# CameraX overview\nPart of [Android Jetpack](/jetpack).\n=====================================================\n\nCameraX is a Jetpack library, built to help make camera app development easier.\nFor new apps, we recommend starting with CameraX. It provides a consistent,\neasy-to-use API that works across the vast majority of Android devices, with\nbackward-compatibility to Android 5.0 (API level 21). If you're migrating an app\nfrom Camera1, see our\n[Camera1 to CameraX migration guide](/training/camerax/camera1-to-camerax). \n[Get started with CameraX](https://codelabs.developers.google.com/codelabs/camerax-getting-started)\n\nPrimary benefits\n----------------\n\nCameraX improves the developer experience in several key ways.\n\n### Broad device compatibility\n\nCameraX supports devices running\n[Android 5.0 (API level 21)](/about/versions/lollipop) and higher,\nrepresenting over 98% of existing Android devices.\n\n### Ease of use\n\nCameraX emphasizes use cases, which allow you to focus on the task you need\nto get done instead of managing device-specific nuances.\nMost common camera use cases are supported:\n\n- [Preview](/training/camerax/preview): View an image on the display.\n- [Image analysis](/training/camerax/analyze): Access a buffer seamlessly for use in your algorithms, such as to pass to ML Kit.\n- [Image capture](/training/camerax/take-photo): Save images.\n- [Video capture](/training/camerax/video-capture): Save video and audio.\n\n### Consistency across devices\n\n**Figure 2.** Automated CameraX test lab ensures a consistent API\nexperience across many device types and manufacturers.\n\nMaintaining consistent camera behavior is hard. You have to consider\naspect ratio, orientation, rotation, preview size, and image size.\nWith CameraX, these basic behaviors just work.\n\nWe maintain an automated CameraX test lab that tests a variety of camera\nbehaviors across [a range of devices](/training/camerax/devices)\nand all operating system versions since Android 5.0. These tests\nrun on an ongoing basis to identify and fix a wide range of issues.\n\n### Camera extensions\n\n**Figure 3.** An image captured with\nthe bokeh (portrait) effect using CameraX.\n\nCameraX has an optional [Extensions](/training/camerax/extensions-api) API that\nallows you to access the same features and capabilities as a device's native\ncamera app with as few as two lines of code.\n\nExtensions include bokeh (portrait), high dynamic range (HDR),\nnight mode, and face retouching, all of which require device support.\n\n### Case study\n\nTo see how CameraX has simplified development for Monzo,\nsee [their case study](/stories/apps/monzo-camerax).\n\nDocumentation\n-------------\n\n- [CameraX architecture](/training/camerax/architecture)\n- [Configuration options](/training/camerax/configuration)\n- [Implement a preview](/training/camerax/preview)\n- [Image analysis](/training/camerax/analyze)\n- [Image capture](/training/camerax/take-photo)\n- [Video capture](/training/camerax/video-capture)\n- [Camera extensions](/training/camerax/extensions-api)\n- [Transform output](/training/camerax/transform-output)\n- [Use case rotations](/training/camerax/orientation-rotation)\n- [Lab-tested devices](/training/camerax/devices)\n\nAdditional resources\n--------------------\n\nTo learn more about CameraX, consult the following additional resources.\n\n### Codelab\n\n\n- [Getting Started with CameraX](https://codelabs.developers.google.com/codelabs/camerax-getting-started)\n\n### Code sample\n\n- \n- [CameraX sample apps](https://github.com/android/camera-samples/)"]]