Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Visão geral do CameraX
Parte do Android Jetpack.
O CameraX é uma biblioteca do Jetpack criada para facilitar o desenvolvimento de apps de câmera.
Para novos apps, recomendamos começar com o CameraX. Ela fornece uma API
consistente e fácil de usar que funciona na grande maioria dos dispositivos Android, com
compatibilidade com versões anteriores até o Android 5.0 (nível 21 da API). Se você estiver migrando um app
do Camera1, consulte o
guia de migração do Camera1 para o CameraX.
Principais benefícios
O CameraX melhora a experiência do desenvolvedor de várias maneiras importantes.
Ampla compatibilidade com dispositivos
A CameraX oferece suporte a dispositivos que executam o
Android 5.0 (nível 21 da API) ou versões mais recentes,
que representam mais de 98% dos dispositivos Android existentes.
Facilidade de uso
O CameraX enfatiza casos de uso, que permitem que você se concentre na tarefa que precisa
concluir em vez de gerenciar nuances específicas do dispositivo.
Ele oferece suporte aos casos de uso de câmera mais comuns:
Consistência entre dispositivos
Figura 2. O laboratório de testes automatizado do CameraX garante uma experiência
de API consistente entre muitos tipos de dispositivos e fabricantes.
É difícil manter um comportamento consistente da câmera. É preciso considerar
a proporção, a orientação, a rotação e o tamanho da visualização e da imagem.
Com a CameraX, esses comportamentos básicos funcionam sem problemas.
Temos um laboratório de testes automatizados da CameraX que testa vários
comportamentos de câmera em diversos dispositivos
e em todas as versões do sistema operacional desde o Android 5.0. Esses testes
são realizados continuamente para identificar e corrigir vários problemas.
Extensões de câmera
Figura 3. Uma imagem capturada com
o efeito bokeh (retrato) usando o CameraX.
O CameraX tem uma API Extensions opcional que
permite acessar com apenas duas linhas de código os mesmos
recursos do app de câmera nativo de um dispositivo.
A API Extensions incluem bokeh (retrato), High Dynamic Range (HDR),
modo noturno e retoque facial. Tudo isso requer suporte do dispositivo.
Estudo de caso
Para saber como o CameraX simplificou o desenvolvimento do Monzo,
consulte o estudo de caso.
Documentação
Outros recursos
Para saber mais sobre o CameraX, consulte os recursos a seguir.
Codelab
Introdução ao CameraX
Exemplo de código
Apps de exemplo do CameraX (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-26 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-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/)"]]
