# Xtream Music - Aplicativo Android

## Visão Geral

O **Xtream Music** é um aplicativo Android completo para reprodução de música com suporte ao protocolo Xtream Codes. O aplicativo permite que os usuários acessem sua biblioteca de música através de um servidor Xtream Music System.

## Características

- ✅ **Autenticação Xtream Codes**: Login seguro com usuário e senha
- ✅ **Navegação por Categorias**: Organize música por gêneros e categorias
- ✅ **Reprodução de Música**: Player integrado com controles completos
- ✅ **Interface Intuitiva**: Design moderno e fácil de usar
- ✅ **Suporte a Múltiplas Conexões**: Compatível com limite de conexões do servidor
- ✅ **Sincronização de Sessão**: Rastreamento automático de conexões ativas

## Requisitos

- **Android 5.0** (API 21) ou superior
- **Conexão com Internet**: Necessária para acessar o servidor
- **Espaço em Disco**: Mínimo 50 MB para instalação

## Instalação

### Via APK Direto

1. **Baixar o APK**
   - Arquivo: `xtream-music-1.3.2.apk`
   - Tamanho: ~60 MB

2. **Ativar Instalação de Fontes Desconhecidas**
   - Vá para **Configurações** > **Segurança**
   - Ative **Fontes Desconhecidas** (ou **Aplicativos Desconhecidos** em Android 8+)

3. **Instalar o APK**
   - Localize o arquivo `xtream-music-1.3.2.apk` no seu dispositivo
   - Toque no arquivo para iniciar a instalação
   - Siga as instruções na tela
   - Aguarde a conclusão da instalação

4. **Abrir o Aplicativo**
   - Procure por "Xtream Music" na sua lista de aplicativos
   - Toque no ícone para abrir

## Primeiro Uso

### Configurar o Servidor

1. Abra o aplicativo Xtream Music
2. Na tela inicial, toque em **Configurações** ou **Servidor**
3. Insira os dados do servidor:
   - **URL do Servidor**: `http://seu-servidor.com` ou `https://seu-servidor.com`
   - **Porta** (opcional): Padrão é 80 (HTTP) ou 443 (HTTPS)
4. Toque em **Salvar** ou **Conectar**

### Fazer Login

1. Na tela de login, insira:
   - **Usuário**: Nome de usuário criado no painel administrativo
   - **Senha**: Senha do usuário
2. Toque em **Entrar**
3. Se as credenciais forem válidas, você será redirecionado para a biblioteca de música

### Navegar e Reproduzir

1. **Categorias**: Na tela inicial, você verá as categorias de música disponíveis
2. **Selecionar Categoria**: Toque em uma categoria para ver as faixas
3. **Reproduzir Faixa**: Toque em uma faixa para iniciar a reprodução
4. **Controles do Player**:
   - ⏮️ **Anterior**: Volta para a faixa anterior
   - ⏸️ **Play/Pause**: Inicia ou pausa a reprodução
   - ⏭️ **Próxima**: Avança para a próxima faixa
   - 🔊 **Volume**: Ajuste o volume
   - ⏱️ **Duração**: Veja o tempo total e decorrido

## Configurações

### Preferências de Reprodução

- **Qualidade de Áudio**: Selecione entre diferentes qualidades (se disponível)
- **Cache**: Ative/desative o cache de faixas
- **Reprodução em Segundo Plano**: Permita reprodução mesmo com o app em background

### Gerenciamento de Conta

- **Alterar Servidor**: Vá para Configurações > Servidor
- **Fazer Logout**: Vá para Configurações > Conta > Logout
- **Limpar Cache**: Vá para Configurações > Armazenamento > Limpar Cache

## Solução de Problemas

### Erro de Conexão

**Problema**: "Não foi possível conectar ao servidor"

**Soluções**:
1. Verifique se a URL do servidor está correta
2. Verifique sua conexão com a internet
3. Certifique-se de que o servidor está online
4. Verifique se a porta está correta (padrão: 80 para HTTP, 443 para HTTPS)

### Erro de Autenticação

**Problema**: "Usuário ou senha inválidos"

**Soluções**:
1. Verifique se o nome de usuário está correto
2. Verifique se a senha está correta
3. Certifique-se de que a conta não expirou
4. Verifique se a conta está ativa no painel administrativo

### Nenhuma Faixa Disponível

**Problema**: "Nenhuma faixa encontrada"

**Soluções**:
1. Verifique se há categorias e faixas cadastradas no servidor
2. Verifique se as faixas estão ativas
3. Tente fazer logout e login novamente
4. Limpe o cache do aplicativo

### Aplicativo Congela ou Trava

**Problema**: O aplicativo não responde ou trava

**Soluções**:
1. Force o encerramento do aplicativo:
   - Vá para **Configurações** > **Aplicativos** > **Xtream Music**
   - Toque em **Forçar Parada**
2. Limpe o cache:
   - Vá para **Configurações** > **Aplicativos** > **Xtream Music**
   - Toque em **Armazenamento** > **Limpar Cache**
3. Desinstale e reinstale o aplicativo
4. Reinicie o dispositivo

## Limite de Conexões

O servidor pode ter um limite de conexões simultâneas por usuário. Se você atingir o limite:

1. Você verá uma mensagem de erro: "Limite de conexões atingido"
2. Desconecte de outros dispositivos fazendo logout
3. Aguarde alguns minutos para que as conexões antigas expirem
4. Tente fazer login novamente

## Dicas e Truques

- **Atalho de Pesquisa**: Use a barra de pesquisa para encontrar faixas rapidamente
- **Favoritos**: Marque suas faixas favoritas para acesso rápido
- **Fila de Reprodução**: Adicione múltiplas faixas à fila para reprodução contínua
- **Modo Offline**: Baixe faixas para reprodução offline (se disponível)

## Privacidade e Segurança

- O aplicativo não armazena suas credenciais localmente (exceto na sessão atual)
- Todas as comunicações com o servidor são criptografadas (HTTPS recomendado)
- Suas informações de reprodução podem ser registradas no servidor para estatísticas

## Atualizações

Para atualizar o aplicativo:

1. Verifique se há uma nova versão do APK disponível
2. Baixe a versão mais recente
3. Instale o novo APK (ele substituirá a versão anterior)
4. Seus dados e configurações serão preservados

## Desinstalação

Para desinstalar o aplicativo:

1. Vá para **Configurações** > **Aplicativos** > **Xtream Music**
2. Toque em **Desinstalar**
3. Confirme a desinstalação

## Suporte

Para problemas, sugestões ou feedback:

- Consulte a documentação do servidor Xtream Music System
- Entre em contato com o administrador do servidor
- Verifique se há atualizações disponíveis

## Informações Técnicas

- **Versão**: 1.3.2
- **Tamanho**: ~60 MB
- **Requisito Mínimo**: Android 5.0 (API 21)
- **Requisito Recomendado**: Android 8.0+ (API 26+)
- **Protocolo**: Xtream Codes API

## Changelog

### v1.3.2
- Suporte completo a Xtream Codes API
- Interface de usuário melhorada
- Correções de bugs e otimizações de performance
- Suporte a múltiplas categorias
- Rastreamento de conexões ativas

---

**Versão**: 1.3.2  
**Última Atualização**: Agosto 2026

**Nota**: Este aplicativo é compatível com qualquer servidor Xtream Codes, incluindo o Xtream Music System.
