FAQ / Aiuto

Risposte rapide alle domande più frequenti

Ci sono limiti di storage, spettatori o partecipanti alla chat?
Nessun limite integrato. La capacità dipende dalle risorse del tuo server (disco, CPU, memoria) e dalla configurazione.
Quante persone possono guardare contemporaneamente?
Non c’è un limite fisso. La concorrenza dipende solo dalla banda e dalla configurazione (a differenza di molte soluzioni WebRTC che limitano il numero di spettatori).
Qual è la latenza minima?
La versione Premium può scendere a circa 4 secondi. La versione gratuita punta piuttosto a ~10 secondi per una riproduzione affidabile.
HLS vs WebRTC: qual è la differenza?
WebRTC offre latenza sotto il secondo, ma consuma molte risorse ed è adatto a piccole sessioni interattive; in pratica si gestiscono pochi spettatori per emittente. HLS aggiunge qualche secondo di latenza, ma funziona via HTTP e scala a un numero molto grande di spettatori con hosting classico o CDN.
Politica di licenza
1 licenza = 1 dominio. Una licenza consente l’attivazione su un solo dominio di produzione. Per usare il plugin su più domini, acquista licenze aggiuntive.
Quali browser possono trasmettere?
Lo streaming richiede MediaStreamTrackProcessor e l’encoder H.264 tramite WebCodecs. Usa Chrome/Edge su desktop o Chrome su Android. iOS Safari e Firefox non possono trasmettere.
Gli spettatori possono guardare su iOS?
Sì. La visione funziona su tutti i browser moderni, incluso Safari su iOS.
Dove vengono salvati i file dello stream?
In wp-content/uploads/castio/{stream_id}. Attiva «Save recording» per conservare i file e generare automaticamente una playlist di replay.
Come funziona la protezione con password?
Gli spettatori inseriscono una password; un cookie firmato concede l’accesso per 24 ore.
Come funziona il paywall Stripe?
Usa Stripe Checkout per un pagamento una tantum e verifica la sessione al ritorno per sbloccare l’accesso.
Dove sono i report delle vendite?
Apri Stream Live → Sale Reports per vedere le vendite per stream.
  • Filtra per periodo con i selettori Start/End.
  • Il banner Totals mostra il numero totale di vendite e il lordo per valuta.
  • Ogni riga stream mostra il prezzo configurato, le vendite, il lordo, gli acquirenti (email) e la data dell’ultima vendita.
  • I dati recuperano le ultime 100 Stripe Checkout Sessions del periodo. Clicca Refresh per aggiornare.

Gli importi non includono le commissioni Stripe; usa il Dashboard Stripe per i totali inclusivi delle fee.

Integrare Stripe – passo dopo passo
  1. Vai su Stripe Dashboard → Developers → API keys.
  2. Copia la tua Publishable key (inizia con pk_) e la tua Secret key (inizia con sk_).
  3. In WordPress, apri Stream Live → Settings e incolla le chiavi nei campi.
  4. Opzionale: imposta la valuta predefinita (codice ISO come usd, eur).
  5. Nella pagina admin dello stream, scegli Video access → Paywall e imposta prezzo/valuta.
  6. Condividi l’URL viewer. Gli spettatori pagano via Stripe Checkout e vengono reindirizzati con accesso sbloccato.
✉️Come funzionano gli inviti via email?
  1. Nella pagina Stream Live, abilita Invite by email.
  2. Clicca Add users to be invited per aprire il selettore. Scegli utenti esistenti o aggiungi email, poi Save Selection.
  3. Opzionale: clicca Send Preview to Me nella modal per testare l’email.
  4. Clicca Start per avviare il live; gli inviti vengono inviati in background ai destinatari selezionati.

Personalizza oggetto e template HTML in Stream Live → Settings → Invitation Email. Placeholder disponibili: {{viewer_url}}, {{stream_id}}, {{stream_title}}, {{start_time}}.

Limiti anti-flood della chat
È attivo un anti-flood lato server: intervallo minimo tra messaggi per IP e limite di burst su una finestra temporale. Se i messaggi vengono bloccati, rallenta la digitazione o riduci le raffiche.
Reimpostare la tabella della chat
Usa WP-CLI: wp db query "TRUNCATE TABLE $(wp db prefix)castio_chat;". Fai un backup prima; elimina definitivamente tutta la cronologia.
Problemi di pagamento Stripe
  • Verifica che in Stream Live → Settings ci siano chiavi pk_ e sk_ valide (test vs live).
  • Devi impostare un prezzo sullo stream quando selezioni Paywall.
  • Il viewer torna con ?session_id=... ; il plugin verifica e sblocca. Se non funziona, controlla HTTPS e che l’URL di ritorno sia accessibile pubblicamente.
  • Usa i log Stripe per verificare creazione e stato delle Checkout Sessions.
Consigli
  • Usa 2–4 s di latenza per un buon compromesso tra qualità e stabilità.
  • Attiva «Save recording» per pubblicare una VOD alla fine.
  • Crea automaticamente una pagina Viewer per condividere facilmente e avere permalink.
🎞️Dove sono i video registrati?
Apri Stream Live → Recorded Videos per sfogliare i replay. Puoi cercare per nome/ID, previsualizzare HLS, rinominare il titolo ed eliminare in massa. I replay sono in uploads/castio/{id} come vod.m3u8.
👁️Come creare una pagina Viewer?
Nella pagina Stream Live, clicca Auto-create Viewer Page dopo aver creato uno stream. In alternativa embed manuale con [castio_viewer stream="123"]. Opzioni: chat="0|1", poll="1.5". Viewer al volo: /?castio_viewer=1&stream=123.
👥Utenti online (Presenza)
Il viewer invia periodicamente la propria presenza. Gli admin possono interrogare /wp-json/castio/v1/presence/list?stream_id=123 e i grafici usano questi dati. Se «Other users can see user list» è attivo, una lista pubblica dei nomi è esposta via /wp-json/castio/v1/presence/public?stream_id=123.
⏱️Live vs Replay
Il replay viene creato se «Save recording» è attivo prima dell’avvio. La pagina recordings elenca replay (vod.m3u8) e live (index.m3u8). Il viewer apre automaticamente il replay se l’URL termina con #replay.
Risoluzione problemi di riproduzione video
Se il video non parte: verifica che l’URL della playlist si carichi e che il server invii i MIME type corretti (m3u8: application/vnd.apple.mpegurl, m4s/mp4: video/mp4). Per browser non Safari, hls.js viene caricato automaticamente per le preview.
Storage e pulizia
Usa l’eliminazione in massa nella pagina recordings per cancellare sessioni vecchie. Valuta un CDN se il volume cresce. Vengono eliminati solo i file in uploads/castio/{id}.
Sicurezza & privacy
Gli endpoint admin applicano controlli di capability e nonce. Password/paywall proteggono l’accesso tramite cookie firmati. Le scritture sono limitate alle cartelle per stream.
Accesso riservato agli utenti registrati
Attiva «Only logged-in users can access video» nell’admin Stream Live per obbligare gli spettatori ad accedere. Se la registrazione WordPress è disattivata, puoi spuntare «Allow new users to register» per consentire la registrazione e permettere ai nuovi spettatori di creare un account.