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

🎮 P03: Genius / Simon Says Clássico em Kotlin

v1.0 — Android Nativo, Kotlin, Sons em Baixa Latência, Temporização com Coroutines e Feedback Visual

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

• P01: Dados RPG (2D, 3D & Ciclo de Vida)
• P02: Jogo da Memória (PNG & POC)
• ➡️ P03 (este): Genius / Simon Says Clássico · Kotlin · Áudio & Coroutines
• P03 (Demo): Genius Demo · Laboratório de SoundPool
• P04: Cartão de Visitas Digital em ConstraintLayout

🏛️ Visão Geral & Arquitetura Visual

O Genius / Simon Says Clássico reproduz o icônico jogo eletrônico de memória dos anos 80. O projeto explora tópicos avançados de desenvolvimento mobile: emissão de tons sonoros sintetizados em baixa latência com SoundPool, reprodução sequencial de luzes através de Coroutines com delay cooperativo, e validação em tempo real das entradas do usuário com controle de rodadas e recorde.

📁 Estrutura de Pastas Anti-Colisão

Todos os artefatos Kotlin, efeitos sonoros em .ogg e telas XML estão organizados na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p03_genius_classic/
├── assets/
│   ├── arquitetura_genius_classic.svg
│   ├── screenshot_p03.png
│   ├── screenshot_genius_classic.png
│   ├── screenshot_genius_final.png
│   ├── screenshot_genius_pro.png
│   └── screenshot_genius_ultra.png
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/genius/
│   │   │       │   └── MainActivity.kt
│   │   │       ├── res/
│   │   │       │   ├── raw/
│   │   │       │   │   ├── som_verde.ogg
│   │   │       │   │   ├── som_vermelho.ogg
│   │   │       │   │   ├── som_amarelo.ogg
│   │   │       │   │   └── som_azul.ogg
│   │   │       │   └── layout/activity_main.xml
│   │   │       └── AndroidManifest.xml
│   │   └── 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: Exibir 4 painéis circulares (Verde, Vermelho, Amarelo e Azul) com estados normais e iluminados.
• RF-02: Gerar lista dinâmica de rodadas adicionando um elemento aleatório [0..3] a cada turno concluído.
• RF-03: Executar rotina de reprodução de áudio e brilho via Coroutines (lifecycleScope.launch).
• RF-04: Comparar as entradas do jogador passo a passo, identificando acerto total ou erro precoce.
• RF-05: Registrar e persistir o maior recorde do jogador nas preferências locais (SharedPreferences).

Requisitos Não-Funcionais (RNF)

• RNF-01 (Latência de Som): Disparo de áudio com atraso imperceptível (< 15ms) através de instâncias nativas SoundPool.
• RNF-02 (Concorrência Não-Bloqueante): Uso de Coroutines suspendíveis para pausas sem travar a UI Thread.
• RNF-03 (Gerenciamento de Recursos): Invocação de soundPool.release() no método onDestroy() da Activity.
• RNF-04 (Compatibilidade de Versão): Suporte nativo desde Android 5.0 (API 21) até Android 14 (API 34).
• RNF-05 (Consistência Visual): Taxa de quadros de 60 FPS nas transições de cor e brilho dos botões.

3. Diagrama de Casos de Uso

flowchart TD
    Player([fa:fa-user Jogador])
    Engine[(fa:fa-music SoundPool & Coroutines)]

    subgraph AppGenius ["🎮 Jogo Genius (mobile-android-kotlin)"]
        UC01["Iniciar Nova Rodada"]
        UC02["Emitir Sequência Luz e Som"]
        UC03["Receber Toques do Jogador"]
        UC04["Validar Correspondência de Sequência"]
        UC05["Finalizar Partida / Gravar Recorde"]
    end

    Player --> UC01
    UC01 --> UC02
    UC02 --> Engine
    Player --> UC03
    UC03 --> UC04
    UC04 -->|Erro| UC05

4. Matriz de Rastreabilidade (RTM)

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

📄 mobile-android-kotlin/app/src/main/java/br/com/curso/genius/MainActivity.kt (arquivo real do projeto)

package br.com.curso.genius

import android.content.Context
import android.media.MediaPlayer
import android.os.Bundle
import android.view.View
import android.widget.Button
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import androidx.lifecycle.lifecycleScope
import br.com.curso.genius.databinding.ActivityMainBinding
import kotlinx.coroutines.delay
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {

    private lateinit var binding: ActivityMainBinding
    private val sequenciaComputador = mutableListOf<Int>()
    private var passoJogador = 0
    private var score = 0
    private var highScore = 0
    private var jogoAtivo = false

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        highScore = getPreferences(Context.MODE_PRIVATE).getInt("HIGH_SCORE", 0)
        atualizarPlacar()

        configurarBotoes()
        binding.btnStart.setOnClickListener { iniciarJogo() }
    }

    private fun configurarBotoes() {
        val botoes = listOf(binding.btnVerde, binding.btnVermelho, binding.btnAmarelo, binding.btnAzul)
        botoes.forEachIndexed { index, button ->
            button.setOnClickListener { 
                if (jogoAtivo) aoClicar(index) 
            }
            button.isEnabled = false
        }
    }

    private fun iniciarJogo() {
        sequenciaComputador.clear()
        score = 0
        binding.btnStart.visibility = View.GONE
        binding.txtStatus.text = "PREPARE-SE!"
        iniciarNovaRodada()
    }

    private fun iniciarNovaRodada() {
        passoJogador = 0
        score = sequenciaComputador.size
        atualizarPlacar()
        
        sequenciaComputador.add((0..3).random())
        
        lifecycleScope.launch {
            tocarSequencia()
        }
    }

    private suspend fun tocarSequencia() {
        jogoAtivo = false
        binding.txtStatus.text = "OBSERVE..."
        delay(1000)

// … (+89 linhas: veja o arquivo completo no projeto)

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/android_p03_genius_classic/mobile-android-kotlin

2. Compile e execute no emulador ou dispositivo com áudio habilitado

./gradlew assembleDebug
./gradlew test

🏁 Matriz de Checkpoints de Conclusão