Android Academy · Lezione

Scattare foto

Acquisisca e salvi un'immagine

Lezione 3 di 413 passaggi

Scattare foto è una lezione Android Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Android Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Android Academy include 4 lezioni in totale.

Acquisizione di una foto

Ora che l'anteprima è visualizzata, il passaggio successivo è scattare una foto. CameRX gestisce questa operazione con il caso d'uso ImageCapture.

Assocerà ImageCapture insieme all'anteprima, quindi chiamerà takePicture() quando l'utente toccherà il pulsante di scatto e salverà il risultato nella galleria del dispositivo.

Creazione del caso d'uso ImageCapture

ImageCapture si configura con un builder. Un'opzione utile è la modalità di acquisizione, che bilancia latenza e qualità:

CAPTURE_MODE_MINIMIZE_LATENCY — scatto rapido.
CAPTURE_MODE_MAXIMIZE_QUALITY — immagine di qualità massima, leggermente più lenta.

val imageCapture = ImageCapture.Builder()
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
    .build()

Associazione di Preview e ImageCapture

Può associare più casi d'uso contemporaneamente. Passi sia preview sia imageCapture a bindToLifecycle, così la fotocamera fornirà il flusso dal vivo e sarà pronta a scattare una foto.

cameraProvider.unbindAll()
cameraProvider.bindToLifecycle(
    lifecycleOwner,
    CameraSelector.DEFAULT_BACK_CAMERA,
    preview,
    imageCapture
)

Dove salvare: MediaStore

Il modo moderno e compatibile con lo scoped storage per salvare una foto consiste nell'usare MediaStore. Descriva il file (nome, tipo MIME e cartella) con ContentValues e lasci che il sistema lo inserisca nella raccolta condivisa Pictures.

Su Android 10+ questa operazione funziona senza la vecchia autorizzazione WRITE_EXTERNAL_STORAGE.

val name = "photo_${System.currentTimeMillis()}"
val contentValues = ContentValues().apply {
    put(MediaStore.MediaColumns.DISPLAY_NAME, name)
    put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg")
    put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/MyApp")
}

Opzioni di output

Per indicare a CameraX dove scrivere il file JPEG, crei un OutputFileOptions usando il content resolver, l'URI della raccolta di destinazione e i Suoi ContentValues.

val outputOptions = ImageCapture.OutputFileOptions
    .Builder(
        context.contentResolver,
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        contentValues
    )
    .build()

Chiamata di takePicture()

Ora avvii l'acquisizione. takePicture() accetta le opzioni di output, un Executor e una callback. CameRX comunica il successo o l'errore in modo asincrono.

Usi ContextCompat.getMainExecutor(context) per fare in modo che la callback venga eseguita sul thread principale.

imageCapture.takePicture(
    outputOptions,
    ContextCompat.getMainExecutor(context),
    object : ImageCapture.OnImageSavedCallback {
        override fun onImageSaved(output: ImageCapture.OutputFileResults) {
            val savedUri = output.savedUri
            // Photo saved! Show a confirmation.
        }
        override fun onError(exc: ImageCaptureException) {
            // Handle the failure.
        }
    }
)

Gestire il risultato

In caso di successo, OutputFileResults.savedUri fornisce l'URI dell'immagine salvata. Può visualizzarlo (con Coil), condividerlo oppure mostrare una Snackbar che confermi il salvataggio.

In caso di errore, ImageCaptureException indica cosa non ha funzionato: lo registri nei log e informi l'utente.

override fun onImageSaved(output: ImageCapture.OutputFileResults) {
    val uri = output.savedUri ?: return
    Toast.makeText(context, "Saved: $uri", Toast.LENGTH_SHORT).show()
}

Collegare un pulsante di scatto

In Compose, sovrapponga un pulsante di scatto all'anteprima usando un Box. Sollevi il riferimento a ImageCapture in modo che il pulsante possa chiamare takePhoto nel suo onClick.

Box(modifier = Modifier.fillMaxSize()) {
    CameraPreview(imageCapture = imageCapture)
    IconButton(
        onClick = { takePhoto(context, imageCapture) },
        modifier = Modifier
            .align(Alignment.BottomCenter)
            .padding(32.dp)
    ) {
        Icon(Icons.Default.PhotoCamera, contentDescription = "Take photo")
    }
}

Estrarre takePhoto()

Mantenga pulito il composable spostando la logica di acquisizione in un helper. Questo riceve il context e il caso d'uso ImageCapture, crea le opzioni di output e chiama takePicture.

fun takePhoto(context: Context, imageCapture: ImageCapture) {
    val values = ContentValues().apply {
        put(MediaStore.MediaColumns.DISPLAY_NAME, "IMG_${System.currentTimeMillis()}")
        put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg")
    }
    val options = ImageCapture.OutputFileOptions.Builder(
        context.contentResolver,
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        values
    ).build()

    imageCapture.takePicture(
        options,
        ContextCompat.getMainExecutor(context),
        object : ImageCapture.OnImageSavedCallback {
            override fun onImageSaved(o: ImageCapture.OutputFileResults) {}
            override fun onError(e: ImageCaptureException) {}
        }
    )
}

Flash e rotazione

Due ritocchi finali:

Flash: imposti imageCapture.flashMode su FLASH_MODE_ON, OFF o AUTO.
Rotazione: CameRX usa la rotazione target per orientare correttamente il JPEG salvato; la mantenga aggiornata per ottenere un orientamento preciso.

imageCapture.flashMode = ImageCapture.FLASH_MODE_AUTO
// Update target rotation when the device rotates:
imageCapture.targetRotation = display.rotation

Completare l'implementazione

Il flusso completo per le foto è: creare ImageCapture → associarlo all'anteprima → al tocco del pulsante di scatto, creare OutputFileOptions e chiamare takePicture → gestire onImageSaved / onError.

In questo modo ottiene una fotocamera completa che salva nella galleria con appena poche righe di codice.

Verifica rapida

Verifichi di aver compreso il flusso di acquisizione delle foto.

Rispondi nella lezione interattiva

Riepilogo

Ora può scattare e salvare foto con CameRX:

Crei un caso d'uso ImageCapture e lo associ all'anteprima.
Descriva l'output con ContentValues e MediaStore per usare lo scoped storage.
Chiami takePicture() con OutputFileOptions, un executor e un OnImageSavedCallback.
Legga savedUri in caso di successo; gestisca ImageCaptureException in caso di errore.

Ora registrerà video con il caso d'uso VideoCapture.

Gratis per iniziare

Impara Kotlin con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 36
Lezioni: 152

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «Scattare foto» è gratuita?

Sì — il testo completo di «Scattare foto» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Android Academy, passa a CoddyKit PRO. Il corso Android Academy include 4 lezioni in totale.

Cosa imparerò in «Scattare foto»?

Acquisisca e salvi un'immagine Eserciti Android Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Android Academy?

Non è richiesta alcuna esperienza precedente. Android Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Scattare foto»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Android Academy?

Sì. Ogni lezione Android Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Android Academy