📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Especialização em Android Nativo. Recomendado revisar antes de iniciar.

📷 P08: Batalha Scanner (QR Code Catch com CameraX)

v1.0 — Android Jetpack CameraX, ML Kit Barcode Scanning, Processamento de Imagens em Tempo Real e Mecânica de Captura

Série Prática Android Clássico — Projeto 8 de 21

• P07: Master Pokédex com Retrofit 2 & REST API
• ➡️ P08 (este): Batalha Scanner com CameraX & QR Code
• P09: PokeMap com Google Maps & GPS
• P10: Arena Social com Firebase Suite
• P11: Guilda dos Heróis com Navigation & Biometria

🏛️ Visão Geral & Arquitetura Visual

O projeto Batalha Scanner conecta o mundo físico ao ambiente virtual do jogo através do processamento óptico de códigos bidimensionais. Utilizando a biblioteca moderna Jetpack CameraX em conjunto com a API de ML Kit Barcode Scanning, o aplicativo gerencia o fluxo de vídeo da câmera traseira em tempo real no componente PreviewView, analisa frames assincronamente com ImageAnalysis e decodifica QR Codes para disparar batalhas e capturar criaturas.

📁 Estrutura de Pastas Anti-Colisão

Todos os serviços de câmera, analisadores de frames e interfaces residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p08_scanner_camerax/
├── assets/
│   ├── mockup_fluxo_telas.svg
│   ├── mockup_como_jogar.svg
│   ├── screenshot_01_permissao.svg
│   ├── screenshot_02_scanner_ativo.svg
│   ├── screenshot_03_batalha.svg
│   └── screenshot_04_gerador_pokeapi.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/batalhascanner/
│   │   │       │   ├── camera/
│   │   │       │   │   └── QrCodeAnalyzer.kt
│   │   │       │   └── MainActivity.kt
│   │   │       └── res/
│   │   └── build.gradle
│   ├── gradle/
│   ├── build.gradle
│   ├── gradlew
│   ├── settings.gradle
│   └── README.md
└── index.md

🧑‍💼 Engenharia de Software & Especificação Formal

1. Histórias de Usuário (User Stories)

2. Requisitos do Sistema

Requisitos Funcionais (RF)

• RF-01: Solicitar permissão de câmera em tempo de execução (Manifest.permission.CAMERA).
• RF-02: Inicializar o ProcessCameraProvider do Jetpack CameraX com ciclo de vida atrelado à Activity.
• RF-03: Configurar caso de uso Preview projetado no elemento PreviewView.
• RF-04: Configurar caso de uso ImageAnalysis com STRATEGY_KEEP_ONLY_LATEST para leitura óptica contínua.
• RF-05: Processar imagens com o scanner do Google ML Kit (BarcodeScanning.getClient()).

Requisitos Não-Funcionais (RNF)

• RNF-01 (Latência de Detecção): Tempo médio entre enquadramento e decodificação do QR Code inferior a 300ms.
• RNF-02 (Concorrência Segura): Execução do analisador de imagens em ExecutorService dedicado sem impactar a UI.
• RNF-03 (Fechamento de Frames): Fechamento mandatório de cada ImageProxy via imageProxy.close() para evitar travamento da fila.
• RNF-04 (Compatibilidade de Câmeras): Suporte retrocompatível a mais de 98% dos dispositivos Android (CameraX HAL3).
• RNF-05 (Estabilidade de Ciclo): Zero falhas de vazamento de hardware de câmera (CameraAccessException).

3. Diagrama de Casos de Uso

flowchart TD
    Player([fa:fa-user Jogador])
    Cam[(fa:fa-camera Hardware CameraX)]
    MLKit[(fa:fa-barcode ML Kit Barcode)]

    subgraph AppScanner ["📷 Batalha Scanner (mobile-android-kotlin)"]
        UC01["Solicitar Permissão de Câmera"]
        UC02["Exibir PreviewView em Tempo Real"]
        UC03["Analisar Frame de Vídeo"]
        UC04["Decodificar QR Code"]
        UC05["Iniciar Duelo de Criaturas"]
    end

    Player --> UC01
    UC01 -->|Concedida| UC02
    UC02 --> Cam
    Cam --> UC03
    UC03 --> MLKit
    MLKit -->|Payload Válido| UC04
    UC04 --> UC05

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada (QrCodeAnalyzer.kt)

ℹ️ O trecho de código que ficava aqui não correspondia ao código do projeto e foi retirado. Consulte os arquivos em mobile-android-kotlin.

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/android_p08_scanner_camerax/mobile-android-kotlin

2. Compile e instale em dispositivo físico com câmera

./gradlew installDebug

🏁 Matriz de Checkpoints de Conclusão