O Soundboard Launcher é um aplicativo projetado para reunir todos os seus soundboards em um único local conveniente. Se você criou seus próprios soundboards ou os recebeu de amigos, este app simplifica o processo de importação e uso deles.

Como Funciona

Para começar, basta abrir o app, importar um soundboard de um arquivo zip ou de um link direto na internet e começar a aproveitar seus sons. O app foi projetado para ser amigável ao usuário, tornando fácil para qualquer pessoa acessar seus efeitos sonoros favoritos.

Informações Importantes para Hospedadores

Se você estiver hospedando soundboards em um servidor web, certifique-se de que o link aponte diretamente para um arquivo zip. Por exemplo:

Correto: https://exemplo.com/soundboard.zip
Correto: https://exemplo.com/alguma_pagina/ (se ele retornar um arquivo zip)
Incorreto: https://exemplo.com/alguma_pagina.html

Estrutura do Arquivo

O arquivo zip que você enviar deve seguir esta estrutura:

plaintext
filename.zip
├─ icon.png (opcional)
├─ manifest.json
└─ audio/
├─ audioname.mp3
...
└─ audioname.mp3

Manifest

O manifesto é um arquivo JSON com duas propriedades:

"name": O nome do soundboard.
"lowvolmsg" (opcional): Uma mensagem para mostrar ao usuário quando o volume estiver definido como 0.

Aqui estão alguns exemplos:

json
{
"name":"Test Soundboard 1",
"lowvolmsg":"O volume está muito baixo!"
}

json
{
"name":"Test Soundboard 1"
}

Ícone

O ícone é um arquivo PNG com transparência, usado na lista de soundboards e na barra de volume. Embora não haja limites de tamanho, recomenda-se manter a imagem abaixo de 512x512 pixels para evitar usar muito espaço.

Áudio

A pasta de áudio contém arquivos MP3. Atualmente, o app não suporta subpastas, embora essa funcionalidade seja adicionada em atualizações futuras. Os nomes dos arquivos são convertidos em nomes de botões, então "Mickey Mouse.mp3" se torna um botão rotulado como "Mickey Mouse".

Diretrizes para Nomes de Arquivo

Os nomes dos arquivos devem ser válidos e não ultrapassar as limitações do sistema:

Nomes de arquivos muito longos podem não ser exibidos totalmente no botão.
Os nomes dos arquivos devem ser válidos para o sistema. O Android não permite nomes de arquivos que contenham caracteres nulos (0x00) ou barras (/).

Ao seguir estas diretrizes, você pode garantir uma experiência suave ao usar o Soundboard Launcher.