Configurar para otimização, flash e formato de arquivo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Há outras maneiras de configurar a câmera de um dispositivo com
ImageCapture. Para isso, use os métodos ImageCapture.Builder.
Definir o modo de captura
Use ImageCapture.Builder.setCaptureMode() para configurar o modo de captura
ao tirar uma foto:
O modo de captura é definido por padrão como CAPTURE_MODE_MINIMIZE_LATENCY. Para mais
informações, consulte a documentação de referência do setCaptureMode().
Definir o modo do flash
O modo do flash padrão é FLASH_MODE_OFF. Para definir o modo do flash, use
ImageCapture.Builder.setFlashMode():
Tipos de arquivos
Este fluxo de trabalho demonstrado neste documento oferece suporte total ao formato
JPEG. Para conferir o exemplo de código que mostra como converter um objeto Media.Image
do formato YUV_420_888 para um objeto RGB Bitmap, consulte
YuvToRgbConverter.kt (link em inglês).
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Configure for optimization, flash, and file format\n\nThere are a few additional ways you can configure a device's camera with\n`ImageCapture`. You do so with `ImageCapture.Builder` methods.\n| **Note:** For a general overview of how to capture images with CameraX see the [Image capture guide](/media/camera/camerax/take-photo).\n\nSet capture mode\n----------------\n\nUse [`ImageCapture.Builder.setCaptureMode()`](/reference/androidx/camera/core/ImageCapture.Builder#setCaptureMode(int)) to configure the capture mode\nwhen taking a photo:\n\n- [`CAPTURE_MODE_MINIMIZE_LATENCY`](/reference/androidx/camera/core/ImageCapture#CAPTURE_MODE_MINIMIZE_LATENCY()): optimize image capture for latency.\n- [`CAPTURE_MODE_MAXIMIZE_QUALITY`](/reference/androidx/camera/core/ImageCapture#CAPTURE_MODE_MAXIMIZE_QUALITY()): optimize image capture for image quality.\n\nThe capture mode defaults to [`CAPTURE_MODE_MINIMIZE_LATENCY`](/reference/androidx/camera/core/ImageCapture#CAPTURE_MODE_MINIMIZE_LATENCY()). For more\ninformation, see the [`setCaptureMode()`](/reference/androidx/camera/core/ImageCapture.Builder#setCaptureMode(int)) reference documentation.\n| **Note:** There is also an experimental [Zero-Shutter Lag mode](/media/camera/camerax/zsl) available through [`CAPTURE_MODE_ZERO_SHOT_LAG`](/reference/androidx/camera/core/ImageCapture#CAPTURE_MODE_ZERO_SHUTTER_LAG()).\n\nSet flash mode\n--------------\n\nThe default flash mode is [`FLASH_MODE_OFF`](/reference/androidx/camera/core/ImageCapture#FLASH_MODE_OFF()). To set the flash mode, use\n[`ImageCapture.Builder.setFlashMode()`](/reference/androidx/camera/core/ImageCapture.Builder#setFlashMode(int)):\n\n- [`FLASH_MODE_ON`](/reference/androidx/camera/core/ImageCapture#FLASH_MODE_ON()): Flash is always on.\n- [`FLASH_MODE_AUTO`](/reference/androidx/camera/core/ImageCapture#FLASH_MODE_AUTO()): Flash is automatically on for low-light shots.\n\nFile types\n----------\n\nThis workflow demonstrated in this document fully supports the [`JPEG`](/reference/android/graphics/ImageFormat#JPEG)\nformat. For sample code that shows how to convert a [`Media.Image`](/reference/android/media/Image) object\nfrom `YUV_420_888` format to an RGB [`Bitmap`](/reference/android/graphics/Bitmap) object, see\n[`YuvToRgbConverter.kt`](https://github.com/android/camera-samples/blob/3730442b49189f76a1083a98f3acf3f5f09222a3/CameraUtils/lib/src/main/java/com/example/android/camera/utils/YuvToRgbConverter.kt)."]]
