Informações gerais

Aqui você entende como funciona o seu jukebox bem como executar as operações do deu dia a dia, como a conexão com o site de streaming e a abertura dos serviços e as funionalidades abertas do aplicativo.

Meu Jukebox e o Streaming

É importante entender que o @meujukebox não faz streaming. Apenas nos conectamos à sua conta de streaming para permitir que seus clientes vizualizem a sua fila de execução, façam buscas e adicionem músicas. Você segue responsável pela sua conta e segue detendo todo o controle sobre ela. Apenas você, diretamente da plataforma de streaming poderá para a execução, eliminar e avançar músicas ou interfirir no volume.

Não possuímos a sua senha

O @meujukebox não precisa de seu usuário e senha para realizar a conexão, isso quer dizer que seus segredos estão seguros. O que sim precisamos são as duas chaves de atenticação que nos possibilitam acesso à sua fila de execução. Carregamos essas chaves no momento da instalação do serviço. Feito isso você pode mudar sua senha sempre que quiser pois não vai influenciar nos serviços. Você precisará sim nos avisar caso queira mudar de conta, ou redirecionar o serviço para outra conta.

É importante entender que o @meujukebox nunca altera a sua playlist pois sequer tem acesso as ela. O que o app enxerga e é capaz de alterar é a sua fila de execução. A relação entre a fila de execução e a playlist é que quando você seleciona um playlisyt para ser tocada, o que você faz é carrega a lista de músicas na sua fila de execução. Quando um cliente inclui uma música para ser tocada, estamos apenas alterando a sua fila. As playlists nunca são alteradas.

Playlist VS Fila

Servindo: .../serve

Para lançar o serviço, você primeiro precisa abrir o aplicativo ou web app do serviço de streaming, carregar uma playlist de sua preferência e começar a tocá-la. Isto vai fazer com que se crie uma fila de execução no seu streaming, que é justamente o que o @meujukebox precisa para poder começar a trabalhar.

Lançada a playlis, o proximo passo é lançar o "serviço" do @meujukebox. Isso vai fazer com que a plataforma use as chaves secretas para entrar no seu serviço de setreaming e abrir os serviços para quem quiser se conectar a ele.

A página de serviço é lançada pelo seu link exclusivo. Ele se parece com algo como "https://numedoseubar-12345678.southamerica-east1.run.app/serve".

Note que a palavra "serve" precisa aparecer ao final do link para o serviço poder ser corretamente lançado.

Ao lançar o serviço é possível que a sua plataforma de streaming solicite que você se identifique novamente com seu usuário e sua senha.

Importante:

Se você lançar o "serve" sem antes começar a tocar uma fila de execussão no app de streaming, você verá isso aqui ->

É a mesma mensagem que você vai ver se alguém tentar entrar no serviço sem que ele esteja lançado.

Para lançar o serviço, primeiro ligue o streaming e ponha uma playlist para tocar. Depois, só depois, lance o "serve".

Manage

Clicando no ícone "Manage" você tem acesso às páginas de gestão onde poderá configurar a sua jukebox, criar as listas de bloqueio de gêneros e as suas promoções especiais.

Configurações gerais

Aqui se estabelecem algumas das importantes configurações básicas do seu jukebox:

1A - ban_list: (true/false) - Aqui afirmamos se desejamos ou não utilizar a lista 2A (list_2_ban) para impedir que certos gêneros musicais sejam aceitos pelo app. Importante notar que cada artista pode ser enquadrado em mais de um gênero. Utilizando-se da "ban_list" o app vai bloquear a música caso um dos artistas possua ao menos um de seus gêneros musicais associados nesta lista.

1B - grant_list: (true/false) - Aqui afirmamos se desejamos ou não utilizar a lista 2B (list_2_grant) para garantir que certos gêneros musicais sejam aceitos pelo app. Importante notar que cada artista pode ser enquadrado em mais de um gênero. Utilizando-se da "grant_list" o app vai aceitar a música caso um dos artistas possua ao menos um de seus gêneros musicais associados nesta lista.

2A - list_2_ban: A lista de gêneros que deverão ser bloqueados pelo app caso a opção ban_list esteja em 'true'. Note que esta lista aparece aqui mas ela deve ser criada na tela 'gestão de bloqueios'.

2B - list_2 grant: A lista de gêneros que deverão ser aceitos pelo app caso a opção grant_list esteja em 'true'. Note que esta lista aparece aqui mas ela deve ser criada na tela 'gestão de bloqueios'.

Importante: Pode-se utilizar qualquer combinação entre ban_list e grant_list, mas veja que se utilizarmos as duas listas (ambos = 'true') a aprovação será mais restrita. Ao se utilizar nenhuma delas (ambos = 'false'), todos os gêneros musicais serão aceitos (sua conta e risco).

3A - refuse_msg_ban: Aqui você pode escolhe a mensagem que será exibida ao se rejeitar uma música por que ao menos um dos gêneros do artista se encontra na lista list_2_ban.

3B - refuse_msg_grant: Aqui você pode escolhe a mensagem que será exibida ao se rejeitar uma música por que nenhum dos gêneros do artista se encontra na lista list_2_grant.

4 - share_msg: Aque se define a mensagem que será adicionada à foto do estabelecimento e à capa do disco que está tocando quando o usuário gerar a imagem para compartilhamento no Instagram. Note que as palavras TRACK e ARTIST em caixa alta serão sempre substituídas pelo nome da música e o nome do artista que estiverem tocando, respectivamente.

5 - jukebox_title: É o nome da página que vai aparecer no cabeçalho do aplicativo (dependendo de que equipamento vai estar sendo usado).

6 - default_search: É o gênero musical que será utilizado para buscas de músicas caso o usuário faça uma busca sem digitar nenhuma informação da busca (nome da música, nome do artista ou nome do album).

7 e 8 - config_name e id: São respectivamente o nome da configuração em nosso sistema e o número de identificação da mesma... fyi.

Gestão dos bloqueios

Nesta página se cria e se modifica as listas "list_2_ban" e "list_2_grant" utilizadas na configuração geral.

A janela azul contém cerca de 2000 gêneros musicais utilizados nos aplicativos de streaming. Para a criação de suas listas, apenas selecione o gênero desejado e mova-o entre as diferentes listas usandos os botões "<<>>" entre cada par de listas.

O botão "LIMPAR TUDO" limpa as listas verde (grant) e vermelha (ban), devolvendo os gêneros à lista azul.

CRIAÇÂO DE LISTA "GRAN" À PARTIR DA FILA DE EXECUÇÂO:

A maneira mais prática de se criar um controle é adicionando o gêneros musicais incompatíveis com o seu estabelecimento um a um na lista vermelha, e utilizar uma de suas playlists favoritas para gerar a lista verde automaticamente, com o botão "APLICAR da FILA"

Para tal basta você carregar na fila de seu aplicativo de streaming um playlist de sua preferência e depois apertar o botão "APLICAR da FILA". O app vai verificar cada uma das músicas de sua fila de execução, vai identifica os gêneros musicais de cada um dos artistas contemplados na lista e vai adiciona-los à sua lista de gêneros aceitos. Esta maneira de controlar os gêneros aceitos é ideal para bares que têm noites temáticas e precisa "guiar" seus clientes para que não fujam do tema. Crie uma playlist por tema, e gere suas listas de controle automaticamente antes de começar a festa.

Gestão de promos

As promoções serão incluídas no aplicativo subindo nesta tela as imagens que se deseja mostrar aos clientes quando utilizarem seu jukebox. Você pode subir quantas imagens desejar e o aplicativo vai mostrá-las sempre na sequência, uma após a outra (carrossel), sempre que o usuário carregar a tela principal do jukebox.

Quando não há anuncios, seus clientes verão a sua logo por meio segundo antes dela se tornar transparente novamente. Quando há anúncio, eles serão mostrados por 2 segundos antes de darem vêz à tela do Jukebox.

Para adicionar uma promo, basta escolher o arquivo de imagem (jpg, bmo, png) no seu computador ou telefone. Para remover o anuncio basta clicar em "apagar" ao lado do mesmo.

Relatórios

Aqui você pode ver relatórios sobre como seu público interage com o seu evento. Pode-se verificar as canções que receberam mais "likes", a lista das músicas pedidas e aceias pelo seu jukebos e a lista das músicas pedidas mas rejeitadas, podendo também verificar a razão (o gênero) que causou a aceitação ou a rejeição.