FAQ / Ajuda

Respostas rápidas para dúvidas frequentes

Há limites de armazenamento, espectadores ou participantes do chat?
Nenhum limite embutido. A capacidade depende dos recursos do seu servidor (disco, CPU, memória) e da configuração.
Quantas pessoas podem assistir ao mesmo tempo?
Não há limite fixo. A simultaneidade depende apenas da banda e do seu setup (diferente de muitas soluções WebRTC que limitam o número de espectadores).
Qual é a latência mínima?
A versão Premium pode chegar a cerca de 4 segundos. A versão gratuita mira ~10 segundos para uma reprodução confiável.
HLS vs WebRTC: qual a diferença?
WebRTC oferece latência abaixo de 1 segundo, mas consome muitos recursos e é mais indicado para pequenas sessões interativas; na prática, suporta poucos espectadores por emissor. HLS adiciona alguns segundos de latência, mas funciona via HTTP e escala para um grande número de espectadores com hospedagem tradicional ou CDN.
Política de licenças
1 licença = 1 domínio. Uma licença permite ativação em apenas um domínio de produção. Para usar o plugin em vários domínios, compre licenças adicionais.
Quais navegadores podem transmitir?
A transmissão exige MediaStreamTrackProcessor e encoder H.264 via WebCodecs. Use Chrome/Edge no desktop ou Chrome no Android. iOS Safari e Firefox não conseguem transmitir.
Os espectadores conseguem assistir no iOS?
Sim. A visualização funciona em todos os navegadores modernos, incluindo o Safari no iOS.
Onde ficam armazenados os arquivos do stream?
Em wp-content/uploads/castio/{stream_id}. Ative «Save recording» para manter os arquivos e gerar automaticamente uma playlist de replay.
Como funciona a proteção por senha?
Os espectadores digitam uma senha; um cookie assinado concede acesso por 24 horas.
Como funciona o paywall do Stripe?
Usa o Stripe Checkout para um pagamento único e valida a sessão no retorno para liberar o acesso.
Onde ficam os relatórios de vendas?
Abra Stream Live → Sale Reports para ver vendas por stream.
  • Filtre por período com os seletores Start/End.
  • A faixa Totals mostra o total de vendas e o bruto por moeda.
  • Cada linha de stream mostra o preço configurado, vendas, bruto, compradores (e-mails) e a data da última venda.
  • Os dados buscam as últimas 100 Stripe Checkout Sessions do período. Clique em Refresh para atualizar.

Os valores não incluem as taxas do Stripe; use o Dashboard do Stripe para totais com taxas incluídas.

Integrar Stripe – passo a passo
  1. Vá ao Stripe Dashboard → Developers → API keys.
  2. Copie sua Publishable key (começa com pk_) e sua Secret key (começa com sk_).
  3. No WordPress, abra Stream Live → Settings e cole as chaves nos campos.
  4. Opcional: defina a moeda padrão (código ISO como usd, eur).
  5. Na página de admin do stream, escolha Video access → Paywall e defina preço/moeda.
  6. Compartilhe a URL do viewer. Os espectadores pagam via Stripe Checkout e são redirecionados com o acesso liberado.
✉️Como funcionam os convites por e-mail?
  1. Na página Stream Live, marque Invite by email.
  2. Clique em Add users to be invited para abrir o seletor. Escolha usuários existentes ou adicione e-mails e depois Save Selection.
  3. Opcional: clique em Send Preview to Me na modal para testar o e-mail.
  4. Clique em Start para iniciar o ao vivo; os convites são enviados em segundo plano aos destinatários selecionados.

Personalize o assunto e o template HTML em Stream Live → Settings → Invitation Email. Placeholders disponíveis: {{viewer_url}}, {{stream_id}}, {{stream_title}}, {{start_time}}.

Limites anti-flood do chat
Um anti-flood no servidor está ativo: intervalo mínimo entre mensagens por IP e limite de rajada em uma janela. Se mensagens forem bloqueadas, diminua o ritmo ou reduza rajadas.
Resetar a tabela do chat
Use WP-CLI: wp db query "TRUNCATE TABLE $(wp db prefix)castio_chat;". Faça backup antes; isso apaga todo o histórico permanentemente.
Problemas de pagamento Stripe
  • Verifique se Stream Live → Settings tem chaves pk_ e sk_ válidas (test vs live).
  • Um preço deve estar definido no stream quando Paywall estiver selecionado.
  • O viewer retorna com ?session_id=...; o plugin valida e libera. Se não funcionar, verifique HTTPS e se a URL de retorno é publicamente acessível.
  • Use os logs do Stripe para verificar criação e status das Checkout Sessions.
Dicas
  • Use 2–4 s de latência para um bom equilíbrio entre qualidade e estabilidade.
  • Ative «Save recording» para publicar um VOD ao encerrar.
  • Crie automaticamente uma página Viewer para compartilhar facilmente e ter permalinks.
🎞️Onde ficam os vídeos gravados?
Abra Stream Live → Recorded Videos para navegar pelos replays. Você pode pesquisar por nome/ID, pré-visualizar HLS, renomear o título e excluir em massa. Os replays ficam em uploads/castio/{id} como vod.m3u8.
👁️Como criar uma página Viewer?
Na página Stream Live, clique em Auto-create Viewer Page após criar um stream. Ou embed manual com [castio_viewer stream="123"]. Opções: chat="0|1", poll="1.5". Viewer on-the-fly: /?castio_viewer=1&stream=123.
👥Usuários online (Presença)
O viewer envia periodicamente sua presença. Admins podem consultar /wp-json/castio/v1/presence/list?stream_id=123 e os gráficos usam esses dados. Se «Other users can see user list» estiver ativo, uma lista pública de nomes fica exposta via /wp-json/castio/v1/presence/public?stream_id=123.
⏱️Ao vivo vs Replay
O replay é criado se «Save recording» estiver ativo antes de iniciar. A página recordings lista o replay (vod.m3u8) e o ao vivo (index.m3u8). O viewer abre automaticamente o replay se a URL terminar com #replay.
Solução de problemas de reprodução
Se o vídeo não iniciar: verifique se a URL da playlist carrega e se o servidor envia os MIME types corretos (m3u8: application/vnd.apple.mpegurl, m4s/mp4: video/mp4). Para navegadores não Safari, o hls.js é carregado automaticamente para previews.
Armazenamento e limpeza
Use a exclusão em massa na página recordings para remover sessões antigas. Considere um CDN se o volume crescer. Apenas arquivos em uploads/castio/{id} são excluídos.
Segurança e privacidade
Os endpoints de admin aplicam verificações de capabilities e nonces. Senha/paywall protegem o acesso via cookies assinados. Escritas são limitadas às pastas por stream.
Acesso apenas para usuários logados
Ative «Only logged-in users can access video» no admin Stream Live para exigir login. Se o registro do WordPress estiver desativado, você pode marcar «Allow new users to register» para permitir cadastro e que novos espectadores criem conta.