Conheça o CameraX 1.5: gravação de vídeo avançada e captura de imagens de nível profissional
Leitura de 7 min
A equipe do CameraX tem o prazer de anunciar o lançamento da versão 1.5. Essa atualização se concentra em oferecer recursos de nível profissional ao seu alcance, além de facilitar a configuração da sessão da câmera como nunca antes.
Para gravação de vídeo, os usuários agora podem capturar vídeos incríveis em câmera lenta ou com alta taxa de quadros sem esforço. Além disso, a nova API Feature Group permite ativar com confiança combinações complexas, como HDR de 10 bits e 60 QPS, garantindo resultados consistentes em todos os dispositivos compatíveis.
Na captura de imagens, você tem flexibilidade máxima com suporte para capturar arquivos DNG (RAW) não processados e não compactados. Além disso, agora é possível aproveitar a saída Ultra HDR mesmo ao usar as poderosas extensões de câmera.
Esses recursos são baseados na nova API SessionConfig, que simplifica a configuração e a reconfiguração da câmera. Agora, vamos conferir os detalhes desses novos recursos incríveis.
Gravação de vídeo avançada: combinações de alta velocidade e recursos
O CameraX 1.5 expande significativamente os recursos de vídeo, permitindo experiências de gravação mais criativas e robustas.
Vídeo em câmera lenta e com frame rate alto
Um dos nossos recursos mais esperados, o vídeo em câmera lenta, já está disponível. Agora é possível capturar vídeos em alta velocidade (por exemplo, 120 ou 240 fps) e codificá-los diretamente em um vídeo em câmera lenta dramático. Como alternativa, você pode gravar com o mesmo frame rate alto para produzir vídeos excepcionalmente suaves.
A implementação é simples se você já conhece a API VideoCapture.
1. Verificar o suporte a alta velocidade: use o novo método Recorder.getHighSpeedVideoCapabilities() para consultar se o dispositivo é compatível com esse recurso.
val cameraInfo = cameraProvider.getCameraInfo(cameraSelector)
val highSpeedCapabilities = Recorder.getHighSpeedVideoCapabilities(cameraInfo)
if (highSpeedCapabilities == null) {
// This camera device does not support high-speed video.
return
}2. Configure e vincule o caso de uso: use o videoCapabilities retornado (que contém informações sobre a qualidade do vídeo compatível) para criar um HighSpeedVideoSessionConfig. Em seguida, consulte os intervalos de frame rate aceitos usando cameraInfo.getSupportedFrameRateRanges() e defina o intervalo desejado. Invoque setSlowMotionEnabled(true) para gravar vídeos em câmera lenta. Caso contrário, ele vai gravar vídeos com alta taxa de frames. A etapa final é usar o Recorder.prepareRecording().start() normal para começar a gravar o vídeo.
val preview = Preview.Builder().build()
val quality = highSpeedCapabilities
.getSupportedQualities(DynamicRange.SDR).first()
val recorder = Recorder.Builder()
.setQualitySelector(QualitySelector.from(quality)))
.build()
val videoCapture = VideoCapture.withOutput(recorder)
val frameRateRange = cameraInfo.getSupportedFrameRateRanges(
HighSpeedVideoSessionConfig(videoCapture, preview)
).first()
val sessionConfig = HighSpeedVideoSessionConfig(
videoCapture,
preview,
frameRateRange = frameRateRange,
// Set true for slow-motion playback, or false for high-frame-rate
isSlowMotionEnabled = true
)
cameraProvider.bindToLifecycle(
lifecycleOwner, cameraSelector, sessionConfig)
// Start recording slow motion videos.
val recording = recorder.prepareRecording(context, outputOption)
.start(executor, {})Compatibilidade e limitações
A gravação em alta velocidade requer suporte específico de CameraConstrainedHighSpeedCaptureSession e CamcorderProfile. Sempre faça a verificação de recursos e ative a gravação em alta velocidade apenas em dispositivos compatíveis para evitar uma experiência ruim para o usuário. No momento, esse recurso é compatível com as câmeras traseiras de quase todos os dispositivos Pixel e de alguns modelos de outros fabricantes.
Confira mais detalhes na postagem do blog (em inglês).
Combine atributos com confiança: a API Feature Group
O CameraX 1.5 apresenta a API Feature Group, que elimina as dúvidas sobre a compatibilidade de recursos. Com base na API de consulta de combinação de recursos do Android 15, agora é possível ativar vários recursos juntos, garantindo uma sessão de câmera estável. No momento, o grupo de recursos é compatível com: HDR (HLG), 60 QPS, estabilização de prévia e Ultra HDR. Por exemplo, é possível ativar o HDR, 60 QPS e a Estabilização de Prévia simultaneamente nas séries Pixel 10 e Galaxy S25. As melhorias futuras vão incluir gravação em 4K e zoom ultra-wide.
A API Groups permite dois casos de uso essenciais:
Caso de uso 1: priorizar a melhor qualidade
Se você quiser capturar usando a melhor combinação possível de recursos, forneça uma lista priorizada. A CameraX vai tentar ativá-los em ordem, selecionando a primeira combinação totalmente compatível com o dispositivo.
val sessionConfig = SessionConfig(
useCases = listOf(preview, videoCapture),
preferredFeatureGroup = listOf(
GroupableFeature.HDR_HLG10,
GroupableFeature.FPS_60,
GroupableFeature.PREVIEW_STABILIZATION
)
).apply {
// (Optional) Get a callback with the enabled features to update your UI.
setFeatureSelectionListener { selectedFeatures ->
updateUiIndicators(selectedFeatures)
}
}
processCameraProvider.bindToLifecycle(activity, cameraSelector, sessionConfig)Neste exemplo, a CameraX tenta ativar os recursos nesta ordem:
- HDR + 60 QPS + Estabilização da Visualização
- HDR + 60 QPS
- HDR + Estabilização da Visualização
- HDR
- 60 QPS + Estabilização da Visualização
- 60 QPS
- Estabilização da visualização
- Nenhum
Caso de uso 2: criar uma interface de configurações voltada ao usuário
Agora, você pode refletir com precisão quais combinações de recursos são compatíveis com a interface de configurações do app, desativando as opções incompatíveis, como na imagem abaixo.
Para determinar se uma opção deve ficar indisponível, use os códigos a seguir para verificar se há suporte para a combinação de recursos. Primeiro, consulte o status de cada recurso individual. Depois que um recurso for ativado, consulte novamente os recursos restantes com os recursos ativados para ver se os botões de alternância precisam ficar esmaecidos devido a restrições de compatibilidade.
fun disableFeatureIfNotSuported(
enabledFeatures: Set<GroupableFeature>,
featureToCheck:GroupableFeature
) {
val sessionConfig = SessionConfig(
useCases = useCases,
requiredFeatureGroup = enabledFeatures + featureToCheck
)
val isSupported = cameraInfo.isFeatureGroupSupported(sessionConfig)
if (!isSupported) {
// disable the toggle for featureToCheck
}
}Consulte a postagem do blog sobre o grupo de recursos para mais informações.
Mais melhorias de vídeo
- Melhorias na câmera simultânea: com o CameraX 1.5.1, agora é possível vincular os casos de uso Preview + ImageCapture + VideoCapture simultaneamente para cada SingleCameraConfig no modo sem composição. Além disso, no modo escrever (mesmos casos de uso com CompositionSettings), agora é possível definir o
CameraEffectque é aplicado ao resultado final da composição. - Silenciamento dinâmico: agora é possível iniciar uma gravação com o som desativado usando
PendingRecording.withAudioEnabled(boolean initialMuted)e permitir que o usuário ative o som mais tarde usandoRecording.mute(boolean muted). - Melhoria no tratamento de armazenamento insuficiente: o CameraX agora envia o erro
VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGEde forma confiável, permitindo que o app lide com situações de pouco armazenamento e informe o usuário. - Otimização em pouca luz: em dispositivos compatíveis (como a série Pixel 10), é possível ativar CameraControl.enableLowLightBoostAsync para clarear automaticamente as transmissões de prévia e vídeo em ambientes escuros.
Captura de imagens de nível profissional
O CameraX 1.5 traz grandes atualizações para o ImageCapture para desenvolvedores que exigem o máximo de qualidade e flexibilidade.
Liberte o controle criativo com a captura DNG (RAW)
Para controle total sobre o pós-processamento, o CameraX agora é compatível com a captura DNG (RAW). Isso dá acesso aos dados de imagem não processados e não compactados diretamente do sensor da câmera, permitindo edição e gradação de cores de nível profissional. A API oferece suporte à captura do arquivo DNG sozinho ou à captura simultânea de saídas JPEG e DNG. Confira o exemplo de código abaixo para saber como capturar arquivos JPEG e DNG simultaneamente.
val capabilities = ImageCapture.getImageCaptureCapabilities(cameraInfo)
val imageCapture = ImageCapture.Builder().apply {
if (capabilities.supportedOutputFormats
.contains(OUTPUT_FORMAT_RAW_JPEG)) {
// Capture both RAW and JPEG formats.
setOutputFormat(OUTPUT_FORMAT_RAW_JPEG)
}
}.build()
// ... bind imageCapture to lifecycle ...
// Provide separate output options for each format.
val outputOptionRaw = /* ... configure for image/x-adobe-dng ... */
val outputOptionJpeg = /* ... configure for image/jpeg ... */
imageCapture.takePicture(
outputOptionRaw,
outputOptionJpeg,
executor,
object : ImageCapture.OnImageSavedCallback {
override fun onImageSaved(results: OutputFileResults) {
// This callback is invoked twice: once for the RAW file
// and once for the JPEG file.
}
override fun onError(exception: ImageCaptureException) {}
}
)Ultra HDR para extensões de câmera
Aproveite o melhor dos dois mundos: a incrível fotografia computacional das extensões de câmera (como o modo noturno) combinada com as cores brilhantes e o alcance dinâmico do Ultra HDR. Esse recurso agora está disponível em muitos smartphones Android premium recentes, como as séries Pixel 9/10 e Samsung S24/S25.
// Support UltraHDR when Extension is enabled.
val extensionsEnabledCameraSelector = extensionsManager
.getExtensionEnabledCameraSelector(
CameraSelector.DEFAULT_BACK_CAMERA, ExtensionMode.NIGHT)
val imageCapabilities = ImageCapture.getImageCaptureCapabilities(
cameraProvider.getCameraInfo(extensionsEnabledCameraSelector)
val imageCapture = ImageCapture.Builder()
.apply {
if (imageCapabilities.supportedOutputFormats
.contains(OUTPUT_FORMAT_JPEG_ULTRA_HDR) {
setOutputFormat(OUTPUT_FORMAT_JPEG_ULTRA_HDR)
}
}.build()Melhorias na API principal e na usabilidade
Uma nova maneira de configurar: SessionConfig
Como visto nos exemplos acima, SessionConfig é um novo conceito no CameraX 1.5. Ele centraliza a configuração e simplifica a API de duas maneiras principais:
- Chega de chamadas manuais para
unbind(): as APIs CameraX têm reconhecimento de ciclo de vida. Ele vai "desvincular" implicitamente seus casos de uso quando a atividade ou outroLifecycleOwnerfor destruído. No entanto, para atualizar casos de uso ou trocar de câmera, ainda é necessário chamarunbind()ouunbindAll()antes de vincular novamente. Agora, com a CameraX 1.5, quando você vincula um novoSessionConfig, a CameraX atualiza a sessão para você, eliminando a necessidade de chamadas de desvinculação. - Controle determinístico de frame rate: a nova API
SessionConfigapresenta uma maneira determinística de gerenciar o frame rate. Ao contrário dosetTargetFrameRateanterior, que era apenas uma dica, esse novo método garante que o intervalo de frame rate especificado será aplicado após a configuração. Para garantir a precisão, consulte as taxas de frames compatíveis usandoCameraInfo.getSupportedFrameRateRanges(SessionConfig). Ao transmitir oSessionConfigcompleto, o CameraX pode determinar com precisão os intervalos compatíveis com base nas configurações de stream.
A Camera-Compose agora é estável
Sabemos que você gosta do Jetpack Compose e temos o prazer de anunciar que a biblioteca camera-compose agora está estável na versão 1.5.1. Esta versão inclui correções de bugs críticos relacionados ao uso do CameraXViewfinder com recursos do Compose, como moveableContentOf e Pager, além de resolver um problema de alongamento da prévia. Vamos continuar adicionando mais recursos ao camera-compose em versões futuras.
Melhorias em ImageAnalysis e CameraControl
- Ajuste da intensidade da lanterna: tenha um controle detalhado da lanterna do dispositivo com novas APIs. É possível consultar a intensidade máxima usando CameraInfo.getMaxTorchStrengthLevel() e definir o nível desejado com CameraControl.setTorchStrengthLevel().
- Suporte a NV21 no
ImageAnalysis: agora é possível solicitar o formato da imagem NV21 diretamente doImageAnalysis, simplificando a integração com outras bibliotecas e APIs. Para ativar, invoqueImageAnalysis.Builder.setOutputImageFormat(OUTPUT_IMAGE_FORMAT_NV21).
Comece a usar hoje mesmo
Atualize suas dependências para a CameraX 1.5 hoje mesmo e conheça os novos recursos. Aguardamos sua participação!
Para usar o CameraX 1.5, adicione as seguintes dependências ao seu libs.versions.toml. Recomendamos usar a versão 1.5.1, que contém muitas correções de bugs críticos e melhorias de câmeras simultâneas.
[versions]
camerax = "1.5.1"
[libraries]
..
androidx-camera-core = { module = "androidx.camera:camera-core", version.ref = "camerax" }
androidx-camera-compose = { module = "androidx.camera:camera-compose", version.ref = "camerax" }
androidx-camera-view = { module = "androidx.camera:camera-view", version.ref = "camerax" }
androidx-camera-lifecycle = { group = "androidx.camera", name = "camera-lifecycle", version.ref = "camerax" }
androidx-camera-camera2 = { module = "androidx.camera:camera-camera2", version.ref = "camerax" }
androidx-camera-extensions = { module = "androidx.camera:camera-extensions", version.ref = "camerax" }Em seguida, adicione estas dependências ao build.gradle.kts do módulo:
dependencies {
..
implementation(libs.androidx.camera.core)
implementation(libs.androidx.camera.lifecycle)
implementation(libs.androidx.camera.camera2)
implementation(libs.androidx.camera.view) // for PreviewView
implementation(libs.androidx.camera.compose) // for compose UI
implementation(libs.androidx.camera.extensions) // For Extensions
}Tem dúvidas ou quer entrar em contato com a equipe do CameraX? Participe do grupo de discussão para desenvolvedores do CameraX ou envie um relatório do bug:
-
Notícias sobre produtosApós mais de um ano de preparação conjunta com líderes do setor, parceiros regionais, App Distribution e comunidades do Android, nossas proteções ao usuário entraram em vigor em 30 de setembro para as lojas participantes no Brasil, na Indonésia, em Singapura e na Tailândia.
Matthew Forsythe • Leitura de 2 min -
Notícias sobre produtosPara oferecer essas experiências aos jogadores e garantir que seus jogos se destaquem em todos os tamanhos de tela, o Google Play está lançando novos requisitos de qualidade para telas grandes em jogos.
Aurash Mahbod • Leitura de 4 min -
Notícias sobre produtosA versão de novembro de 2026 do Jetpack Compose está estável. Esta versão traz a versão 1.13 para os principais módulos do Compose (confira o mapeamento completo da BOM), introduzindo atualizações em texto, gráficos, layouts, desempenho e muito mais, além de algumas descontinuações e mudanças de comportamento importantes que você precisa conhecer.
Meghan Mehta • Leitura de 10 min
Receba os insights mais recentes sobre o desenvolvimento para Android na sua caixa de entrada toda semana.