# Manual de Uso - PlayerSf2

Bem-vindo ao **PlayerSf2**, um poderoso reprodutor de SoundFonts (SF2) para Android, projetado para músicos que buscam baixa latência, alta qualidade de áudio e controle completo sobre MIDI e efeitos em tempo real.

---

## 1. Tela Principal e Navegação

A tela principal é composta por **8 Tracks (Trilhas)** independentes e um canal **Master**. Cada track permite carregar um timbre diferente e configurar efeitos exclusivos.

### Controles de cada Track:
- **Fader (Deslizante):** Ajusta o volume individual da track (0 a 100%).
- **Botão Ativo/Mudo (Power):** Liga ou desliga o áudio da trilha instantaneamente.
- **Botão Sustain (S):** Ativa o pedal de sustain virtual para a trilha.
- **Nome do Instrumento:** Toque aqui para abrir o seletor de timbre (SF2 + Preset).
- **Botão de Configuração da Trilha (⚙):** Abre o editor completo de efeitos e MIDI da trilha.
- **Knob Attack:** Ajusta o tempo de ataque do envelope sonoro.
- **Knob Release:** Ajusta o tempo de release do envelope sonoro.
- **Knob Cutoff:** Ajusta o filtro de corte de frequências.

### Barra de Ferramentas Superior (Toolbar):
- **Transpose Global (▲▼ +0):** Ajusta a tonalidade de TODAS as trilhas simultaneamente em semitons (de -24 a +24). Toque duplo no número para resetar para 0.
- **Gerenciar Cenas (Ícone de Arquivo):** Salva, carrega, exporta e apaga seus presets completos (configurações JSON).
- **Biblioteca SF2 (Pastinha):** Importa e gerencia seus arquivos SoundFont (.sf2).
- **Mini Player (Ícone de Música):** Mostra ou esconde o painel de reprodução de áudio.

### Barra de Ferramentas Inferior:
- **Mapa MIDI:** Configura o mapeamento de controladores externos (Knobs, Faders, Botões).
- **Reordenar Trilhas:** Permite trocar a posição das trilhas na tela arrastando-as.
- **Drum Pads:** Acessa o módulo de pads estilo MPC para bateria e samples.
- **Configurações Gerais (⚙):** Acessa o menu de Configuração de Áudio e MIDI.

### Monitor de Desempenho:
- **CPU:** Exibe a carga do processador em tempo real (verde = ok, amarelo = atenção, vermelho = sobrecarregado).
- **MEM:** Exibe o uso de memória em megabytes.

---

## 2. Gerenciamento de Sons (SoundFonts)

### Importando Arquivos SF2:
1. Toque no ícone de **Biblioteca** na barra superior.
2. Toque em **"Adicionar Novo"**.
3. Selecione um ou mais arquivos `.sf2` no seu dispositivo.
4. Os arquivos serão copiados para a biblioteca interna do app.

### Selecionando um Timbre:
1. Toque no **nome do instrumento** em qualquer uma das 8 tracks.
2. Escolha o arquivo SF2 desejado.
3. Selecione o **Preset** (instrumento) dentro do SoundFont.
4. *(Opcional)* Dê um **Apelido (Alias)** para facilitar a identificação na tela principal.
5. Toque em **Carregar**.

> **Dica:** Durante a seleção, você pode tocar nos presets para pré-visualizar o som antes de confirmar.

---

## 3. Editor de Trilha (Track Editor)

Toque no ícone de configuração (⚙) de qualquer uma das 8 tracks para abrir o editor completo. O editor disponibiliza as seguintes abas especializadas:

### Aba EQ (Equalizador e Pan)
- **Pan:** Ajusta o balanço estéreo do instrumento entre o canal esquerdo (L) e direito (R).
- **LFO (Low-Frequency Oscillator):** Modulação de oscilação (Tremolo / Auto-pan) com ajuste fino de frequência (0 a 20 Hz).
- **3-Band EQ (Trilhas 1–8):** Equalizador paramétrico com ganho ajustável para Graves (80 Hz), Médios (2.5 kHz) e Agudos (12 kHz).
- **15-Band Graphic EQ (Exclusivo Master Bus):** Equalizador gráfico de 15 bandas ISO (25 Hz a 16 kHz) com desenho de resposta dinâmica e 5 Presets dedicados para Teclados e Pianos:
  - 🎹 **Flat:** Resposta totalmente plana (0 dB).
  - 🎹 **Grand Piano:** Grave profundo de piano de cauda com agudos brilhantes cristalinos (+3.5 dB @ 25–63Hz, +3 a +5.5 dB @ 4–16kHz).
  - ⚡ **Bright Piano:** Brilho incisivo para corte de frequências na mixagem ao vivo (+3 a +7 dB nas frequências agudas).
  - 🎷 **Warm EP:** Médios-graves quentes para Pianos Elétricos no estilo Rhodes / DX7 (+3 a +5 dB @ 100–400Hz).
  - 🎸 **Rock Piano:** Curva em V com ataque percussivo de notas grave/agudo e atenuação de ressonâncias médias.

### Aba Sends (Roteamento de Efeitos Auxiliares)
- **Reverb Send:** Knob de nivelamento individual do sinal enviado ao Reverb Master (com efeito Shimmer +1 oitava).
- **Chorus Send:** Knob de nivelamento individual enviado ao Chorus Espacial Roland Dimension D Master.
- **Compressor Send / Insert:** Ajusta o envio e inserção da trilha no compressor dinâmico.

### Aba Arp (Arpeggiator Dedicado por Trilha)
- **Ativar Arpeggiator:** Liga/desliga o arpejador independente da trilha selecionada.
- **Latch (Trava):** Mantém a sequência de arpejo tocando continuamente mesmo após soltar as teclas do teclado.
- **BPM:** Ajusta a velocidade do tempo em batidas por minuto (40 a 240 BPM).
- **Pattern (Padrão das Notas):**
  - **Up:** Execução de notas em ordem ascendente (grave ao agudo).
  - **Down:** Execução de notas em ordem descendente (agudo ao grave).
  - **Up/Down:** Subida e descida contínua.
  - **Random:** Seleção aleatória de notas do acorde preso.
- **Rate (Subdivisão Rítmica):** Seleção de tempo rítmico — **1/4**, **1/8**, **1/16** ou **1/32** de nota.
- **Octaves (Intervalo de Oitavas):** Expande o alcance da varredura do arpejo por 1, 2, 3 ou 4 oitavas.

### Aba Sound (Envelope ADSR, Filtro e Polifonia)
- **Envelope de Volume (ADSR Completo):**
  - **Attack:** Ajusta o tempo de subida inicial do som (0 a 4000 ms).
  - **Decay:** Tempo de queda até o nível de sustentação.
  - **Sustain Level:** Nível mantido enquanto a tecla permanece pressionada (0.0 a 1.0).
  - **Release:** Tempo de extinção da cauda sonora após soltar a tecla (0 a 4000 ms).
- **Filtro Ressonante:** Controle direto de **Cutoff** (frequência de corte) e **Resonance** (ressonância do filtro).
- **Polifonia Individual:** Limita o consumo atribuindo até 128 vozes simultâneas por trilha (8, 16, 24, 32, 48, 64, 96 ou 128 vozes).
- **Fine Tuning (Afinação Fina):** Ajuste preciso de afinação em cents (-100 a +100 cents) para criar efeito de *Detune* (Super-Saw/Layering).
- **Pedal de Sustain Virtual (Liga/Desliga):** Habilita ou ignora comandos de pedal Sustain (CC 64) por faixa.

### Aba Synth Engine (Módulo de Síntese Avançada e Layering)
- **Síntese Híbrida e Camadas:** Permite criar timbres ricos e encorpados combinando seus SoundFonts (.sf2) favoritos com osciladores de sintetizador em tempo real (*Layering*).
- **Gerador de Osciladores:** Seleção de formas de onda clássicas:
  - **Sawtooth (Dente de Serra):** Som encorpado ideal para solos de synth e metais brilhantes.
  - **Square / Pulse (Quadrada):** Timbre oco marcante para synth-basses e solos.
  - **Sine (Seno):** Onda pura e aveludada para sub-graves (*Sub-Bass*).
  - **Triangle (Triângulo):** Timbre suave para flautas e texturas acústicas.
  - **Noise (Ruído Branco):** Gerador de ruído para efeitos de percussão e transições.
- **Filtro Ressonante Estilo Analógico (LowPass / BandPass / HighPass):** Filtro de alta precisão com controle de corte (*Cutoff*) e ressonância.
- **Envelope de Filtro Dedicado (ADSR):** Modula o brilho e a abertura do filtro ao longo do tempo (Attack, Decay, Sustain, Release).

### Aba MIDI Setup (Configuração MIDI / Split / Layer)
- **Channel (Canal MIDI):** Define o canal de escuta (ANY para responder a todos, ou 1 a 16).
- **Transpose & Octave:** Transposição individual por semitons (-24 a +24) e oitavas (-3 a +3).
- **Teclado Dividido (Split):** Define a zona de atuação com **Lower Key** (nota inicial) e **Upper Key** (nota final), permitindo dividir o controlador MIDI em regiões (ex: Baixo na mão esquerda, Piano na mão direita).
- **Filtro de Velocidade (Dynamic Layering):** Define **Min Velocity** e **Max Velocity** (1 a 127) para disparar timbres específicos dependendo da força do toque.
- **Ativo / Hold Filter:** Ativa ou desativa os filtros de divisão e sensibilidade configurados.

---

## 4. Efeitos Globais (Master FX)

O canal Master conta com um rack de efeitos de nível de estúdio aplicado na saída principal:

### Equalizador Gráfico Master (15 Bandas)
- 15 bandas ISO de alta precisão com curva visual de resposta dinâmica na tela.
- Presets prontos para palco especialmente calibrados para Teclados e Pianos (Grand Piano, Bright Piano, Warm EP, Rock Piano, Flat).

### Master Reverb (Reverb de Cauda Espacial + Shimmer)
- **Modo Aux Send Puro:** Processa a reverberação das 8 faixas com máxima transparência, sem alterar o som direto (*dry*).
- **Room Size / Decay:** Simulação de acústica natural (desde salas de estúdio até grandes catedrais).
- **Shimmer Effect:** Adiciona um brilho celestial de oitava superior (+1 oitava) ideal para pads ambientais e solos de piano.
- **Damping:** Ajuste de absorção de frequências altas para sonoridade mais aveludada.

### Master Dimension D (Chorus Espacial Estéreo)
- Recria a sonoridade do lendário chorus espacial analógico Roland Dimension D.
- **Mix & CrossMix:** Expande a imagem estéreo da sua apresentação com profundidade tridimensional.
- **HighPass:** Filtro passa-alta que mantém os graves firmes e sem embolar.

### Master Compressor (Compressor & Limiter de Precisão)
- Compressor profissional no barramento principal para homogeneizar o volume, evitar picos e aumentar o sustain de forma natural.
- **Threshold / Ratio / Attack / Release / Knee / Makeup Gain.**

---

## 4.1. Repertório e Gerenciador de Setlists

- **Repertório ao Vivo:** Permite organizar Cenas (presets salvos) na ordem exata do repertório do seu show.
- **Troca Instantânea:** Alterne entre músicas com um toque sem interromper o fluxo da apresentação.

---

## 4.2. Tecnologia de Ultra-Desempenho para Shows ao Vivo

- **Estabilidade Máxima no Palco:** Motor de áudio nativo de alta fidelidade projetado para responder instantaneamente aos toques sem nenhum engasgo ou travamento na tela.
- **Eficiência de Processamento:** Gerenciamento inteligente de hardware que prioriza a velocidade da resposta sonora, garantindo menor aquecimento e maior autonomia de bateria.
- **Polifonia Elevada sem Cortes:** Toque acordes complexos com pedais de sustain e camadas pesadas mantendo mais de 64 a 128 vozes simultâneas por trilha com clareza cristalina.

---

## 5. Drum Pads (Módulo de Bateria/MPC)

Toque no botão **Drum Pads** na barra inferior para abrir o módulo de pads.

### Layout:
- **Tablet:** 16 pads exibidos em grade 4x4.
- **Celular:** 8 pads por vez, navegando entre **Página 1** (Pads 1–8) e **Página 2** (Pads 9–16) com as setas.

### Seleção de Kit (SF2 para Bateria):
- Toque em **"Selecionar Kit"** para abrir o seletor de timbre e escolher um SoundFont para o módulo de bateria (Track 8).
- Os pads são mapeados automaticamente de acordo com o mapa General MIDI a partir da nota C2 (nota 36).

### Modos de Operação:
| Modo | Descrição |
|------|-----------|
| **PLAY** | Modo padrão — toque os pads para disparar sons |
| **EDITAR** | Toque em um pad para ajustar o volume individual pelo fader lateral; toque novamente para abrir o editor avançado do pad |
| **CONTÍNUO** | Ativa o modo *Latch* por pad — toque uma vez para ligar, outra para desligar |
| **MAPEAR** | Toque em um pad na tela e depois acione um botão/nota no controlador MIDI para vinculá-los |
| **RENOMEAR** | Toque em um pad para editar seu nome |

### Editor Avançado do Pad (Modo Editar → duplo toque):
- Selecione a **nota MIDI** de disparo.
- Selecione um **SF2 alternativo** por pad (cada pad pode ter seu próprio soundfont).
- Visualize o nome do sample mapeado.

### Indicadores visuais nos Pads:
- 🔵 **Ponto azul:** Pad mapeado para um controlador MIDI externo.
- **CONT:** Pad em modo contínuo (Latch).
- **Brilho laranja:** Pad ativo (nota sendo tocada).

---

## 6. Mini Audio Player

Reprodutor interno para acompanhar faixas de playback. Ative/desative pelo botão na barra de ferramentas.

### Formatos Suportados:
- MP3, OGG, WAV, M4A

### Controles:
- **Play / Pause:** Inicia ou pausa a reprodução.
- **Parar (Stop):** Para a reprodução e volta ao início.
- **⏮ Anterior / ⏭ Próxima:** Navega entre as músicas da pasta carregada.
- **Loop:** Repete a faixa ou playlist continuamente.
- **A-B:** Define um ponto **A** (início) e um ponto **B** (fim) para repetir um trecho específico em loop.
- **Volume:** Controle de volume independente do player (não afeta os sons SF2).
- **Nome da Faixa:** Toque para abrir o seletor de músicas.
- **Trocar (Exchange):** Abre o diálogo de seleção de música/pasta.

### Carregando Músicas:
1. Toque em **"Trocar"** ou no nome da faixa.
2. O app tentará carregar todas as músicas da **pasta atual** como uma playlist.
3. Se não houver pasta, o app buscará músicas nas pastas **Música** e **Downloads** do dispositivo.
4. Alternativamente, use o seletor de arquivo para escolher manualmente.

---

## 7. Gerenciador de Configurações (Cenas e Repertórios)

Salve e carregue sets completos (todas as 8 trilhas, timbres SF2, efeitos, volumes, arpejadores e pads) em Cenas e Repertórios organizados.

### Operações disponíveis:
- **Salvar Nova Cena:** Salva o estado atual do aplicativo com nome personalizado, tonalidade, BPM e cor de identificação.
- **Gerenciador de Repertórios:** Cria e organiza listas de Cenas sequenciais para shows ao vivo.
- **Importar do Disco / Backup:** Carrega arquivos `.json` de backup externos ou cenas individuais.
- **Exportar:** Gera arquivos de backup completos ou seletivos dos seus repertórios.

### Sistema de Auto-Save e Histórico de Snapshots (Reciclagem Automática)
- **Repertório Fixo "Snapshot":** O sistema mantém um repertório permanente chamado **Snapshot** no topo da lista. Este repertório **é protegido contra exclusão acidental**.
- **Gravação Automática a cada 10 Segundos:** Qualquer alteração efetuada nos controles salva o estado da cena em background sem interromper o áudio.
- **Histórico Rotativo das Últimas 10 Cenas (Janela de 10 Minutos):**
  - Se o tempo decorrido desde a última gravação for menor ou igual a **10 minutos**, o ajuste é atualizado diretamente na cena Snapshot mais recente.
  - Se a diferença entre os ajustes for superior a **10 minutos**, uma nova cena Snapshot é criada automaticamente (ex: `Snapshot 14:30 - 13/08`), até o limite máximo de **10Snapshots**.
  - Ao atingir 10 Snapshots, o sistema ativa a reciclagem automática FIFO (descarta o registro mais antigo e adiciona o mais recente).
- **Restauração Automática no Fechamento Total (Cold Start):** Ao fechar o aplicativo por completo e reabri-lo, o PlayerSf2 carrega automaticamente o Snapshot mais recente gravado no repertório Snapshot, restaurando exatamente onde você parou.

---

## 8. Mapeamento MIDI (MIDI Map)

Configure controles físicos (knobs, faders, botões) para controlar parâmetros do app.

### Como Mapear:
1. Toque em **"Mapa MIDI"** na barra inferior.
2. Selecione o parâmetro desejado e toque em **"Aprender"**.
3. Mova o controle físico no seu controlador MIDI.
4. O mapeamento é salvo automaticamente.

### Parâmetros Mapeáveis:

**Controles Globais:**
- Volume Master
- Cutoff Global (afeta a trilha ativa)
- Attack Global / Release Global

**Por Trilha (Track 1–8):**
- Volume da trilha
- Ativar/Mudo (Arm)
- Sustain
- Selecionar trilha ativa (para controles globais de Cutoff/Attack/Release)

**Controles do Player:**
- Play / Parar
- Função A-B
- Volume do player
- Próxima / Anterior faixa
- Avançar / Retroceder

**Drum Pads:**
- Disparo de cada um dos 16 pads (via nota MIDI ou CC)

---

## 9. Teclado Virtual

Acesse o teclado musical na tela tocando no botão de teclado na toolbar.

### Funcionalidades:
- **Piano de Toque:** Toque as teclas para disparar notas em todas as trilhas ativas simultaneamente.
- **Pitch Wheel:** Roda de Pitch Bend (retorna ao centro automaticamente).
- **Modulation Wheel:** Roda de Modulação (CC 1).
- **Oitava (▼ C/▲ C):** Navega entre as oitavas (C0 a C7). A oitava selecionada é salva automaticamente.
- **Strip de Trilhas:** Botões numerados de 1 a 8 mostram o nome do instrumento de cada trilha. Toque para ativar/mudo individualmente.
- **Visualização MIDI:** Ao receber notas de um controlador externo, as teclas correspondentes são iluminadas na tela.

---

## 10. Configurações Gerais

### Áudio:
- **Saída de Áudio:** Seleciona o dispositivo de saída (Alto-falante, Fone de ouvido, Interface USB). O app prioriza automaticamente: USB > Headset > Speaker.
- **Taxa de Amostragem (Sample Rate):** Define a frequência de processamento. Recomendado: **48000 Hz**. Disponível: 44100, 48000, 88200, 96000, 176400 e 192000 Hz.
- **Buffer Size:** Define a latência. Valores menores (256, 512 frames) oferecem resposta mais rápida, mas exigem mais do processador. Valores maiores (2048, 4096 frames) são mais estáveis.
- **Motor de Síntese (Engine):**
  - **TSF (Ultra Low Latency):** Motor nativo otimizado para latência mínima.
  - **FluidSynth (High Precision):** Motor de referência SF2 com maior fidelidade tonal.
- **Testar Áudio:** Gera um tom de teste para verificar a saída de áudio atual.
- **Plug and Play:** Quando ativado, o app detecta e seleciona automaticamente novas interfaces de áudio/MIDI conectadas via USB.

### MIDI:
- **Entradas MIDI:** Tabela com todos os dispositivos MIDI detectados (USB e Bluetooth), exibindo nome, fabricante e capacidades (notas, CC, Program Change).
- **Escanear MIDI Bluetooth (BLE):** Abre o scanner de dispositivos MIDI Bluetooth para parear teclados sem fio.
- **Reconectar BLE:** Reconecta automaticamente ao último dispositivo Bluetooth pareado.

### Sistema:
- **Resetar Tutoriais:** Apaga o histórico de tutoriais. Os guias interativos aparecerão novamente ao abrir as telas.
- **Ativação / Licença:** Acessa a tela de ativação da licença do app.

---

## 11. Tutorial Interativo

O app possui um tutorial guiado integrado que destaca cada elemento da interface com balões explicativos. Ele aparece automaticamente na primeira abertura de cada tela.

- **Tela Principal:** Tutorial completo cobrindo todos os controles.
- **Editor de Trilha:** Tutorial das abas de edição de efeitos.
- **Drum Pads:** Tutorial dos modos de operação dos pads.
- **Configurações:** Tutorial do painel de áudio e MIDI.

Para reiniciar os tutoriais, acesse **Configurações → Resetar Tutoriais**.

---

## 12. Licenciamento

O PlayerSf2 possui um sistema de licença com **período de teste gratuito de 30 dias** com acesso completo a todas as funcionalidades. Após o período:

- **Plano Mensal:** a partir de R$9,99/mês
- **Plano Anual:** a partir de R$99,99/ano

Para ativar, acesse **Configurações → Ativação** ou entre em contato com o suporte: **alanclever@acosystems.com.br**

---

## 13. Dicas de Performance

- **Ajuste de Knobs:** Para ajustar os controles giratórios (Knobs), **deslize o dedo para cima** (aumentar) ou **para baixo** (diminuir).
- **Transpose Global:** Toque duas vezes rapidamente no valor para resetar para 0.
- **Latência:** Se o áudio apresentar estalos, aumente o **Buffer Size** nas Configurações.
- **CPU Alta:** Reduza a **Polyphony** nas trilhas mais exigentes ou mude o Engine para TSF.
- **Tela sempre ativa:** O app mantém a tela ligada durante o uso para não interromper performances ao vivo.
- **Modo de Alta Performance:** O app utiliza o modo de performance sustentada do Android para evitar throttling térmico durante sessões prolongadas.
- **Auto-Save:** Não é necessário salvar manualmente. O app faz backup automático do estado a cada 10 segundos. Use o Gerenciador de Cenas para salvar configurações nomeadas permanentemente.
