Central de Ajuda
Encontre respostas para os problemas mais comuns com o Helph Sing.
O botão "Continuar" ou "Criar sessão" não funciona / fica cinza+
Isso acontece quando a página é acessada via endereço IP (ex: 192.168.x.x) em modo de desenvolvimento. Use o comando `npm run preview` para iniciar o servidor em modo de produção — aí todos os botões funcionam normalmente em qualquer dispositivo na mesma rede Wi-Fi.
O QR Code não abre no celular+
Certifique-se de que o celular está na mesma rede Wi-Fi que o computador onde o Helph Sing está rodando. Se estiver usando 4G/5G, o QR Code não funcionará porque o endereço IP é local. Troque para Wi-Fi e tente novamente.
Digitei meu nome mas a página voltou para o início+
Esse comportamento pode ocorrer em modo de desenvolvimento (npm run dev) acessado via IP — o JavaScript não carrega corretamente em dispositivos móveis. Use `npm run preview` para resolver. Se já estiver em produção, tente recarregar a página e repetir o processo.
A tela de exibição (TV) está com letras muito pequenas+
A tela de exibição em `/admin/[sessão]/screen` foi otimizada para telas maiores (1920px+). Se as letras ainda estiverem pequenas, tente diminuir o zoom do navegador (Ctrl+- no Windows, Cmd+- no Mac) ou aumentar o zoom da TV nas configurações de acessibilidade.
A busca de músicas não encontra nenhum resultado+
Verifique se a chave da YouTube Data API está configurada corretamente na variável de ambiente `YOUTUBE_API_KEY`. A cota diária da API do YouTube é limitada — se houver muitas buscas em um dia, pode acabar. O sistema já cacheia os resultados por 30 dias para economizar cota.
Meu pedido foi enviado mas não aparece na fila+
Se a sessão tiver aprovação manual ativada, o pedido fica em "Pendentes" até o organizador aprovar. O organizador precisa acessar o painel admin e clicar em "Aprovar" para o pedido entrar na fila.
Como faço para gerenciar a sessão pelo celular?+
No painel admin da sessão, há um QR Code especial na aba "Admin" (na seção de QR Codes). Escaneie esse QR Code com o celular para abrir o painel de controle. Atenção: compartilhe esse QR apenas com quem deve ter controle total da sessão.
A sessão expirou ou foi encerrada por engano+
Sessões encerradas não podem ser reabertas. Crie uma nova sessão em /admin. As sessões recentes aparecem na mesma página para facilitar o acesso.
O vídeo do YouTube não carrega ou fica preto+
Alguns vídeos de karaokê têm restrições de incorporação definidas pelo criador do conteúdo e não podem ser tocados em players externos. Tente buscar o mesmo título com palavras diferentes ou escolha outro vídeo nos resultados.
Como funciona a pontuação?+
A pontuação é gerada automaticamente ao final de cada música e é apenas recreativa — não mede habilidade vocal real. Serve para animar a festa com um ranking divertido entre os participantes.
💡 Dica principal para uso em eventos
Sempre use npm run preview para iniciar o Helph Sing em eventos. Esse comando faz um build de produção que funciona corretamente em todos os dispositivos da rede — celulares, tablets e TVs.
O comando npm run dev é apenas para desenvolvimento local no mesmo computador.