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

🎮 P03: Genius Demo (Laboratório de SoundPool & Áudio)

v1.0 — Android Nativo, Kotlin, SoundPool Low-Latency, Controle Dinâmico de Pitch e Volume Estéreo

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 (Clássico): Genius / Simon Says Clássico · Kotlin · Áudio & Coroutines
• ➡️ P03 (Demo / este): Genius Demo · Laboratório de SoundPool
• P04: Cartão de Visitas Digital em ConstraintLayout

🏛️ Visão Geral & Arquitetura Visual

O Genius Demo (Laboratório de Áudio) foi concebido como um banco de testes para engenharia multimídia no Android. O foco exclusivo deste laboratório é explorar as capacidades avançadas do SoundPool: carregamento assíncrono com OnLoadCompleteListener, ajuste em tempo real de taxas de amostragem e afinação (playback rate/pitch de 0.5x a 2.0x), balanço estéreo de canais (esquerdo e direito) e monitoramento de saturação do mixer de som nativo.

📁 Estrutura de Pastas Anti-Colisão

Todos os artefatos de código, assets compactados e scripts Gradle estão contidos na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p03_genius_demo/
├── assets/
│   ├── arquitetura_genius_demo.svg
│   └── screenshot_p03.png
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/geniusdemo/
│   │   │       │   └── MainActivity.kt
│   │   │       └── res/
│   │   └── build.gradle
│   ├── gradle/
│   ├── build.gradle
│   ├── gradlew
│   ├── jogo_genius_sons.zip
│   ├── 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: Inicializar instância de SoundPool com suporte a até 4 canais simultâneos.
• RF-02: Carregar buffers de áudio a partir de arquivos .ogg ou .mp3 alocados em memória.
• RF-03: Disponibilizar controles para disparar sons individuais e verificar tempo de resposta.
• RF-04: Alterar a propriedade de velocidade (pitch/rate) em tempo real entre os valores 0.5f e 2.0f.
• RF-05: Interromper todos os fluxos ativos instantaneamente através de soundPool.autoPause().

Requisitos Não-Funcionais (RNF)

• RNF-01 (Latência Máxima): Tempo de resposta de áudio estritamente inferior a 10 milissegundos.
• RNF-02 (Gestão de Recursos): Encerramento completo de todos os canais no desmonte da Activity.
• RNF-03 (Consumo de Memória): Uso eficiente de memória RAM para arquivos de som (< 5 MB no total).
• RNF-04 (Compatibilidade de Plataforma): Suporte estável em Android API 21 a API 34.
• RNF-05 (Robustez): Tratamento de falhas de hardware de áudio ou fones de ouvido desconectados.

3. Diagrama de Casos de Uso

flowchart TD
    Tester([fa:fa-user Engenheiro de Testes])
    SoundPool[(fa:fa-sliders SoundPool Engine)]

    subgraph LabAudio ["🎮 Laboratório SoundPool (mobile-android-kotlin)"]
        UC01["Carregar Buffers de Áudio"]
        UC02["Disparar Som em Baixa Latência"]
        UC03["Modular Pitch e Velocidade"]
        UC04["Ajustar Balanço Estéreo (L/R)"]
        UC05["Executar Teste de Estresse de Streams"]
    end

    Tester --> UC01
    UC01 --> SoundPool
    Tester --> UC02
    Tester --> UC03
    Tester --> UC04
    Tester --> UC05
    UC02 --> SoundPool

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)

// … (+92 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_demo/mobile-android-kotlin

2. Compile e execute no emulador ou dispositivo físico

./gradlew assembleDebug
./gradlew test

🏁 Matriz de Checkpoints de Conclusão