Pular para o conteúdo principal

Documentação do Desenvolvedor

Este documento fornece uma visão técnica da aplicação Android Camera Parameters, sua arquitetura e diretrizes de desenvolvimento.

Visão Geral do Projeto​

A aplicação é uma ferramenta de diagnóstico para inspecionar as CameraCharacteristics do Android Camera2. Ela fornece uma interface moderna e amigável para explorar níveis de hardware, recursos e valores de parâmetros brutos para todas as lentes de câmera em um dispositivo.

Arquitetura​

O projeto segue o padrão arquitetônico MVVM (Model-View-ViewModel) e é construído usando Jetpack Compose para a camada de interface do usuário.

Componentes Principais​

CameraParamsActivity​

O único ponto de entrada da aplicação.

  • Gerencia permissões em tempo de execução (CAMERA).
  • Inicializa a UI do Compose via setContent.
  • Hospeda o CameraParamsTheme.

CameraViewModel​

O gerenciador de estado central para a UI.

  • Mantém o UiState, que inclui a lista de câmeras, índice selecionado, parâmetros categorizados e consulta de busca.
  • Detecção de Recursos: Contém lógica em detectFeatureFlags() para determinar dinamicamente recursos de hardware como suporte a RAW, OIS e Exposição Manual.
  • Categorização: Agrupa centenas de chaves Camera2 em seções lógicas (Sensor, Lente, etc.) para melhor legibilidade.

CameraParamsHelper​

Um invólucro de utilidade em torno do CameraManager do Android.

  • Recupera CameraCharacteristics para IDs específicos.
  • Fornece formatação especializada para tipos de câmera complexos (por exemplo, convertendo modos IntArray em strings legíveis por humanos).

Camada de UI (Jetpack Compose)​

A UI é construída usando Material 3 com um tema escuro estritamente aplicado.

Estrutura de Navegação​

O app usa androidx.navigation.compose gerenciado em MainScreen.kt.

TelaResponsabilidade
Visão GeralPainel de alto nível mostrando o Cartão de Resumo, Nível de Hardware e chips de Principais Recursos.
CategoriasLista expansível de todos os parâmetros agrupados por seção com filtragem de busca.
Bruto (JSON)Representação JSON com realce de sintaxe de todas as propriedades da câmera.
DetalheVisualização focada para um único parâmetro, mostrando valor formatado e dados brutos.

Estilização​

  • Tema: Definido em Theme.kt.
  • Cores: Cor primária #7B61FF (Violeta) usada para realces e ações principais.
  • Superfície: Fundo escuro #121417 com variantes #1E1F23 para cartões.

Lógica Principal​

Detecção Dinâmica de Recursos​

Os chips de "Principais Recursos" no painel não são estáticos. Eles são calculados em CameraViewModel.detectFeatureFlags():

  • RAW: Verificado via REQUEST_AVAILABLE_CAPABILITIES_RAW.
  • OIS: Detectado se LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION contiver ON.
  • Exp. Manual: Disponível se CONTROL_AE_MODE_OFF for suportado.
  • Foco Manual: Ativado se LENS_INFO_MINIMUM_FOCUS_DISTANCE for maior que 0.

Guia de Desenvolvimento​

Pré-requisitos​

  • Android Studio Ladybug (ou mais recente).
  • Kotlin 2.0+ (O projeto usa o novo plugin Gradle do Compose Compiler).
  • SDK Mínimo: 21 (Android 5.0).

Adicionando uma Nova Categoria​

Para adicionar ou modificar o agrupamento de parâmetros, atualize o método getCategoryForKey() em CameraViewModel.kt. Ele usa correspondência de strings nos nomes das chaves da câmera para atribuí-las às categorias.

Atualizando o Tema​

As cores podem ser ajustadas em Color.kt. O app foi projetado para ter a melhor aparência no modo escuro; quaisquer alterações na paleta clara devem ser testadas cuidadosamente.