Como usar
Guia rápido para organizar seu evento com o Helph Sing.
1️⃣ Criar a sessão
Vá em Criar sessão, escolha o tipo — 🎤 Helph Sing (Karaokê): convidados cantam, com pontuação divertida; 🎵 MusicBox: só toca as músicas pedidas, sem pontuação — dê um nome e crie. Dá para alternar o modo depois, durante o evento.
⚠️ Guarde o link de admin (tem a chave secreta ?k=). Sem ele, ninguém controla a sessão — nem você.
2️⃣ Abrir a tela da TV
No painel, clique em 📺 Tela e abra na TV/projetor. No primeiro acesso, clique no aviso “Clique para ativar” — isso libera o som (exigência dos navegadores). Depois disso tudo toca sozinho.
Use o botão ⛶ para tela cheia.
3️⃣ Convidados entram pelo QR Code
A TV mostra o QR de convidado (e o código da sessão). O convidado escaneia, digita o nome/apelido, busca a música e envia o pedido. No Karaokê a busca prioriza versões karaokê; no MusicBox busca a música normal.
O QR de admin (aba 🔑 no painel) dá controle TOTAL — compartilhe só com quem for ajudar a organizar.
4️⃣ Aprovar pedidos (ou liberar direto)
Com aprovação manual ligada, os pedidos caem em “Pedidos” e você aprova um a um. Com ela desligada (interruptor na barra lateral), os pedidos entram direto na fila. Alterne quando quiser — vale para os próximos pedidos.
5️⃣ Controlar a reprodução
Na barra lateral do painel: ▶ tocar · ⏸ pausar · ⏭ pular · ⏹ parar · volume · 🔇/🔊. Os comandos chegam na TV em até 5 segundos. Pular não gera pontuação.
🚨 Vídeo não toca? Alguns vídeos bloqueiam reprodução incorporada. Pule (⏭), remova da fila e escolha outra versão.
6️⃣ Karaokê ↔ MusicBox durante o evento
Na barra lateral, use Alternar para MusicBox / Helph Sing. Cada modo tem a própria fila: ao alternar, a fila do outro modo fica guardada e volta quando você alternar de novo. A TV e a busca dos convidados seguem o modo ativo.
7️⃣ Encerrar e apagar
🔒 Encerrar fecha a sessão (convidados não pedem mais). 🗑 Apagar remove a sessão e TODOS os dados (nomes, pedidos, pontuações) — use ao fim do evento se quiser limpar tudo (LGPD).
8️⃣ Testar antes do evento (recomendado!)
Rodando local: use npm run preview (modo produção) — celulares na mesma rede Wi-Fi acessam pelo IP mostrado no QR. O modo npm run dev NÃO funciona bem em celular.
Faça o fluxo completo uma vez: pedir → aprovar → tocar → pontuar. Teste também a internet do local — o app depende de internet para YouTube e banco. Faça as buscas das músicas prováveis um dia antes: buscas repetidas usam cache e não gastam a quota diária (100 buscas/dia).