P2P LiveFree live streaming · peer-to-peer delivery

P2P Live — Manuale utente

Questo manuale spiega tutto ciò che serve a chi trasmette e a chi guarda: come funziona il servizio, come registrarsi, come deve essere il tuo flusso, come incorporare il player, come verificare che la distribuzione peer-to-peer (P2P) funzioni, quali sono i limiti e come risolvere i problemi più comuni.

In breve: registrati, incolla l’indirizzo del tuo flusso HLS (un URL .m3u8) e ottieni una pagina pubblica all’indirizzo https://p2p.gia.tv/tuo_nome più un codice di incorporamento. Gli spettatori di quella pagina condividono il video tra loro attraverso i browser, così il tuo server di streaming o la tua CDN consegna il flusso una volta invece che una volta per spettatore.

Come funziona

Ogni pagina di canale contiene un player HLS standard (hls.js) con un motore P2P collegato.

  1. Il primo spettatore di un canale scarica la playlist e i segmenti video dal tuo server di origine (l’indirizzo .m3u8 che hai inserito), esattamente come qualsiasi altro player.
  2. Ogni spettatore successivo apre la stessa pagina. I player si trovano tramite il server di segnalazione di questo sito (un piccolo servizio WebSocket) e si collegano direttamente, da browser a browser, attraverso canali dati WebRTC.
  3. Ogni segmento video viene scaricato dall’origine da un solo spettatore (il leader dello sciame) e poi inoltrato agli altri attraverso le connessioni P2P. Se un segmento non arriva in tempo da un peer, il player lo scarica da solo dall’origine: la riproduzione non dipende mai dai peer.
  4. Ogni segmento viene verificato (hash e analisi del contenuto) prima di essere passato al player. Un peer non può inserire dati errati nella riproduzione di un altro spettatore.
  5. I player inviano statistiche anonime (byte dall’origine, byte dai peer, interruzioni, peer collegati), così vedi la quota di alleggerimento nella tua dashboard.

Cosa significa per te:

Requisiti

Il tuo flusso deve soddisfare questi requisiti. Il pulsante Controlla il flusso ora nella dashboard ne verifica la maggior parte per te.

RequisitoPerchéCome verificarlo
HLS (playlist .m3u8) su http:// o https://Il player è un player HLS. RTMP, RTSP, DASH, l’ingest WebRTC e i semplici file MP4 non sono supportati direttamente.Apri l’URL in un browser: deve scaricarsi un piccolo file di testo che inizia con #EXTM3U.
Intestazione CORS Access-Control-Allow-Origin: * (o esattamente https://p2p.gia.tv) sulle playlist e sui segmenti, da ogni nodo della tua CDNSenza di essa i browser rifiutano le richieste tra siti diversi. Senza CORS il flusso non si riproduce affatto, con o senza P2P. Un’intestazione che indica un altro sito non vale.Dashboard → Controlla il flusso ora → «CORS». Oppure curl -sI -H 'Origin: https://p2p.gia.tv' TUO_URL e cerca l’intestazione.
https:// se i tuoi spettatori usano https (questo sito usa https)I browser bloccano i contenuti http:// nelle pagine https:// (contenuto misto).Assicurati che l’URL inizi con https://.
URL dei segmenti stabiliI peer si scambiano i segmenti per nome. Se ogni spettatore riceve un URL con un nome diverso per lo stesso segmento (token per spettatore, indicazioni del bilanciatore come lb_backend_hint, URL assoluti su server che cambiano), i peer non possono condividere.Dashboard → Controlla il flusso ora → «Condivisione». Oppure apri due volte la playlist media: i nomi dei segmenti devono essere uguali. Gli URL firmati uguali per tutti gli spettatori vanno bene.
Durata dei segmenti 2–10 sSegmenti molto corti (< 1 s) aumentano la segnalazione; molto lunghi (> 10 s) ritardano la condivisione tra peer.#EXT-X-TARGETDURATION nella playlist media.
Codec: video H.264, audio AAC o MP3 (segmenti TS o fMP4); H.265/HEVC solo dove il browser lo supportaI decodificatori del browser.Con la vista diagnostica o il controllo della dashboard.

Requisiti dell’origine

Il controllo verifica la playlist da questo server. Una CDN o un’origine che tratta gli spettatori in modo diverso a seconda del paese o della rete (blocco geografico, protezione dall’hotlinking, nodi regionali senza intestazioni CORS) può sembrare a posto qui e fallire comunque per alcuni spettatori. Questi spettatori vedono sotto il player Errore del flusso — l’origine ha rifiutato questo spettatore: HTTP 403 …, e lo stesso motivo compare a te in Amministrazione → Analisi in diretta (se amministri il sito): chiedi allo spettatore il motivo mostrato, o il registro eventi della vista diagnostica.

CORS

È di gran lunga il problema più frequente. La tua origine deve inviare Access-Control-Allow-Origin: * (o esattamente l’origine del sito, https://p2p.gia.tv) in ogni risposta: la playlist principale, le playlist media e i segmenti. Esempi:

nginx

location /live/ {
    add_header Access-Control-Allow-Origin * always;
    add_header Access-Control-Allow-Headers Range always;
    add_header Access-Control-Expose-Headers Content-Length always;
    types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; video/mp4 m4s mp4; }
}

Apache (.htaccess nella cartella HLS)

Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"

Wowza Streaming Engine: Application → Properties → Custom → aggiungi cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (modulo cupertinostreaming), oppure usa l’impostazione CORS dell’origine HTTP.

CDN (Cloudflare, Akamai, CloudFront, Bunny…): attiva CORS nelle impostazioni dell’origine o della pull zone, con * come origine consentita. Su Cloudflare, «Transform Rules → Response headers» può aggiungere l’intestazione.

Prova dalla riga di comando (l’intestazione deve comparire nell’output):

curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control

Sorgenti che funzionano bene

Registrazione

  1. Vai su https://p2p.gia.tv/signup.
  2. Scegli un nome utente: 3–20 caratteri, lettere minuscole, cifre e trattino basso. Diventa il tuo indirizzo pubblico https://p2p.gia.tv/nome_utente e non potrà essere cambiato in seguito.
  3. Inserisci la tua e-mail e una password (almeno 8 caratteri).
  4. Se vuoi, incolla subito il tuo indirizzo .m3u8 e un titolo per il canale, oppure aggiungili più tardi nella dashboard.
  5. Accetta i Termini di utilizzo e la Politica di utilizzo accettabile. Devi possedere i diritti su tutto ciò che trasmetti.
  6. Fai clic su Crea il canale. Accedi subito e arrivi alla tua dashboard.

Su alcuni siti la registrazione è chiusa; in quel caso usa la pagina dei contatti.

La tua dashboard

https://p2p.gia.tv/dashboard mostra:

Controlla il flusso ora scarica la tua playlist lato server e mostra: online/offline, diretta o VOD, durata obiettivo, varianti, migliore risoluzione/bitrate, codec e se l’intestazione CORS è presente. I flussi vengono controllati anche automaticamente ogni pochi minuti; la pagina iniziale elenca solo i canali online.

Quando il sito invia e-mail, dopo la registrazione la dashboard ti chiede di confermare il tuo indirizzo e-mail (vedi Domande frequenti).

Opzioni del canale

La tua pagina di canale

https://p2p.gia.tv/nome_utente mostra il player, il titolo, la descrizione, il numero attuale di spettatori, il link di condivisione, il codice di incorporamento e un piccolo riquadro diagnostico.

Sotto il video c’è una riga di stato P2P:

StatoSignificato
P2P funzionaQuesto spettatore riceve segmenti dai peer (o è il leader dello sciame e ne serve altri).
P2P: avvioCollegato alla segnalazione, in attesa di peer o del primo segmento condiviso. Normale per il primo spettatore e nei primi 10–20 secondi.
P2P non funzionaVedi il testo accanto: WebRTC non disponibile, riproduzione nativa (Safari su iOS), segnalazione irraggiungibile o tutti i peer falliti. Il video continua a essere riprodotto dall’origine.

La pagina non blocca mai la riproduzione a causa del P2P. Se qualcosa va storto, lo spettatore guarda semplicemente dall’origine.

Mobile: Chrome e Firefox su Android supportano il P2P. Safari su iOS riproduce l’HLS in modo nativo (senza Media Source Extensions), quindi iPhone e iPad riproducono sempre dall’origine e non partecipano al P2P. Safari su desktop partecipa.

Incorporamento

Copia il codice di incorporamento dalla dashboard o dalla pagina del canale:

<iframe src="https://p2p.gia.tv/embed/user_name" width="854" height="480" frameborder="0" scrolling="no"
        allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>

Opzioni:

<div style="position:relative;aspect-ratio:16/9;max-width:960px">
  <iframe src="https://p2p.gia.tv/embed/user_name" style="position:absolute;inset:0;width:100%;height:100%;border:0"
          allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
</div>

Un player essenziale senza la grafica del sito si trova a https://p2p.gia.tv/?src=TUO_M3U8 (produzione) e https://p2p.gia.tv/debug.html?src=TUO_M3U8 (diagnostica). Usano lo stesso motore P2P e lo stesso sciame della tua pagina di canale, perché lo sciame è ricavato dall’URL del flusso.

Prove

Per vedere il P2P servono due player; un solo spettatore scarica sempre dall’origine.

  1. Apri la pagina del canale in un browser (ad esempio Chrome). Aspetta che il video parta.
  2. Apri la stessa pagina in un secondo browser (Firefox, Edge, un altro profilo di Chrome, una finestra in incognito o un altro computer/telefono su qualsiasi rete).
  3. Entro 10–20 secondi circa, la riga di stato del secondo player dovrebbe indicare P2P funziona. Il primo diventa il leader e mostra che serve dei peer.
  4. Per i dettagli apri il link Vista diagnostica (anche https://p2p.gia.tv/debug.html?src=TUO_M3U8). Mostra ogni segmento con la sua provenienza (ORIGIN o PEER), i peer collegati, i byte in ciascuna direzione, lo stato della segnalazione, un riquadro di verifica che dice esattamente perché il P2P funziona o no, e una procedura di prova integrata.

Note:

Limiti

VoceValoreNote
Canali per account1Crea altri account per altri flussi.
Spettatori per canale (sciame)fino a 500 per impostazione predefinitaStabilito dall’amministratore. Oltre il limite, i nuovi spettatori guardano ancora dall’origine, ma senza P2P.
Peer per spettatorefino a 12Gestito automaticamente (il sito può cambiare il numero).
Lunghezza dell’indirizzo del flusso1024 caratteri
Titolo / descrizione120 / 600 caratteri
Carico sull’origineda 1 a pochi download completi per sciameIl leader più gli spettatori i cui peer sono troppo lenti.
Upload del playerlimitato per peer e in totaleGli spettatori con upload lento ne servono automaticamente meno.

Risoluzione dei problemi

«Flusso offline» nella dashboard / nessun video

Funziona per me ma non per uno spettatore in un altro paese

Funziona in VLC ma non nel browser

«P2P non funziona: segnalazione irraggiungibile»

«P2P non funziona: niente WebRTC» / «riproduzione nativa»

«P2P: avvio» all’infinito con due spettatori

Il video si blocca / va in buffering

La pagina iniziale non mostra il mio canale

L’incorporamento mostra un riquadro nero

Ho dimenticato la password

Ho cambiato il mio indirizzo e-mail, ma le Impostazioni mostrano ancora quello vecchio

Domande frequenti

Il mio video viene registrato o ritrasmesso? No. Il sito si limita a mettere in contatto i player. Il video viene preso dalla tua origine dai browser degli spettatori e passato tra loro. Sul server non viene salvato nulla.

Posso usare un flusso di un altro fornitore (ad esempio il mio canale Tulix/SSH101)? Sì, se hai il diritto di distribuirlo e l’origine invia le intestazioni CORS. La pagina dell’elenco SSH101 mostra un esempio di integrazione.

È gratuito? Sì. Il servizio è fornito così com’è, secondo i Termini di utilizzo. Gli abusi (violazione del diritto d’autore, contenuti illegali) portano al blocco; vedi la Politica di utilizzo accettabile.

Quanti spettatori posso avere? Quanti la tua origine potrebbe servirne senza P2P con circa il 5–20 % del carico. In pratica vale per ogni canale il limite di sciame fissato dall’amministratore (500 per impostazione predefinita).

Gli spettatori possono vedersi tra loro? Solo tecnicamente (indirizzi IP all’interno di WebRTC, come in qualsiasi servizio video P2P). Niente nomi, niente chat, nessuna cronologia.

Quali browser? Chrome, Edge, Firefox, Opera, Brave (con WebRTC consentito), Safari su desktop, Chrome/Firefox su Android. Safari su iOS riproduce senza P2P.

Funziona con DRM / HLS cifrato? Le playlist cifrate con AES-128 funzionano (i segmenti vengono condivisi cifrati; ogni spettatore prende la chiave dal tuo server delle chiavi). I DRM FairPlay/Widevine non sono supportati.

Posso cambiare il mio nome utente? No, è l’indirizzo permanente della tua pagina. Crea un nuovo account per un nuovo nome.

Posso eliminare il mio account? Sì: Impostazioni → Elimina account, con la password attuale. L’account e la pagina del canale vengono eliminati subito, gli spettatori collegati vengono disconnessi e al tuo indirizzo e-mail arriva un avviso. Non si può annullare. (Gli account amministratore vengono eliminati da un altro amministratore.)

Perché la dashboard mi chiede di confermare il mio indirizzo e-mail? Quando il sito invia e-mail, i nuovi account ricevono un link di conferma (valido 7 giorni). Aprilo e premi Conferma; Invia di nuovo il link nella dashboard ne invia uno nuovo (fino a 3 all’ora). Alcuni siti elencano un canale nella pagina iniziale solo dopo che il suo indirizzo è stato confermato.

Contatti

Domande e segnalazioni di abusi: pagina dei contatti · e-mail: info@tulix.com · abusi/DMCA: https://p2p.gia.tv/report.