P2P Live — Manual do utilizador
Este manual explica tudo o que quem transmite ou quem assiste precisa de saber: como o serviço funciona, como se registar, como deve ser a sua transmissão, como incorporar o leitor, como verificar se a entrega ponto a ponto (P2P) está a funcionar, quais são os limites e como resolver os problemas mais comuns.
Em resumo: registe-se, cole o endereço da sua transmissão HLS (um URL
.m3u8) e obtém uma página pública emhttps://p2p.gia.tv/o_seu_nomee um código de incorporação. Os espectadores dessa página partilham o vídeo entre si através dos navegadores, pelo que o seu servidor de streaming ou CDN entrega a transmissão uma vez em vez de uma vez por espectador.
Como funciona
Cada página de canal contém um leitor HLS normal (hls.js) com um motor P2P associado.
- O primeiro espectador de um canal descarrega a lista de reprodução e os segmentos de vídeo do seu servidor de origem (o endereço
.m3u8que indicou), exatamente como qualquer outro leitor. - Cada espectador adicional abre a mesma página. Os leitores encontram-se através do servidor de sinalização deste site (um pequeno serviço WebSocket) e ligam-se diretamente, de navegador para navegador, por canais de dados WebRTC.
- Cada segmento de vídeo é descarregado da origem por um espectador (o líder do enxame) e depois reencaminhado para os outros pelas ligações P2P. Se um segmento não chegar a tempo de um par, o leitor vai buscá-lo ele próprio à origem, pelo que a reprodução nunca depende dos pares.
- Cada segmento é verificado (hash e análise do conteúdo) antes de ser entregue ao leitor. Um par não consegue introduzir dados errados na reprodução de outro espectador.
- Os leitores enviam estatísticas anónimas (bytes da origem, bytes de pares, interrupções, pares ligados) para que veja a taxa de descarga no seu painel.
O que isto significa para si:
- Largura de banda: com 50 espectadores, a sua origem suporta aproximadamente a carga de 1 a 3 espectadores. Quanto mais espectadores um canal tem, maior é a descarga (normalmente 80–97 %).
- Qualidade: os espectadores veem a mesma transmissão HLS com a mesma qualidade. O P2P só muda a proveniência dos bytes.
- Fiabilidade: se os pares forem lentos ou desaparecerem, o leitor volta à origem sem se notar. Por isso, a origem tem de estar sempre acessível; o P2P reduz a sua carga, não a substitui.
- Privacidade: os pares trocam apenas segmentos de vídeo e pequenas mensagens de controlo. Não são trocados dados pessoais entre espectadores. Através do WebRTC, os espectadores podem ver os endereços IP uns dos outros, como em qualquer serviço de vídeo P2P.
Requisitos
A sua transmissão tem de cumprir estes requisitos. O botão Verificar a emissão agora do painel testa a maioria por si.
| Requisito | Porquê | Como verificar |
|---|---|---|
HLS (lista .m3u8) por http:// ou https:// | O leitor é um leitor HLS. RTMP, RTSP, DASH, ingestão WebRTC e ficheiros MP4 simples não são suportados diretamente. | Abra o URL num navegador: deve ser descarregado um pequeno ficheiro de texto que começa por #EXTM3U. |
Cabeçalho CORS Access-Control-Allow-Origin: * (ou exatamente https://p2p.gia.tv) nas listas e nos segmentos, a partir de todos os nós da sua CDN | Sem ele, os navegadores recusam pedidos entre sites. Sem CORS a transmissão não reproduz de todo, com ou sem P2P. Um cabeçalho que indica outro site não conta. | Painel → Verificar a emissão agora → «CORS». Ou curl -sI -H 'Origin: https://p2p.gia.tv' O_SEU_URL e procure o cabeçalho. |
| https:// se os seus espectadores usam https (este site usa https) | Os navegadores bloqueiam conteúdos http:// em páginas https:// (conteúdo misto). | Confirme que o URL começa por https://. |
| URL de segmentos estáveis | Os pares trocam segmentos pelo nome. Se cada espectador receber um URL com nome diferente para o mesmo segmento (tokens por espectador, indicações do balanceador como lb_backend_hint, URL absolutos em servidores que mudam), os pares não conseguem partilhar. | Painel → Verificar a emissão agora → «Partilha». Ou abra a lista de média duas vezes: os nomes dos segmentos devem ser iguais. URL assinados iguais para todos os espectadores não são problema. |
| Duração dos segmentos de 2–10 s | Segmentos muito curtos (< 1 s) aumentam a sinalização; muito longos (> 10 s) atrasam a partilha entre pares. | #EXT-X-TARGETDURATION na lista de média. |
| Codecs: vídeo H.264, áudio AAC ou MP3 (segmentos TS ou fMP4); H.265/HEVC apenas onde o navegador o suporte | Os descodificadores do navegador. | Com a vista de diagnóstico ou a verificação do painel. |
Requisitos da origem
A verificação testa a lista a partir deste servidor. Uma CDN ou origem que trata os espectadores de forma diferente consoante o país ou a rede (bloqueio geográfico, proteção contra hotlinking, nós regionais sem cabeçalhos CORS) pode parecer correta aqui e falhar mesmo assim para alguns espectadores. Esses espectadores veem por baixo do leitor Erro na transmissão — a origem recusou este espectador: HTTP 403 …, e o mesmo motivo aparece-lhe em Administração → Análise em direto (se administrar o site): peça ao espectador o motivo mostrado, ou o registo de eventos da vista de diagnóstico.
CORS
É de longe o problema mais frequente. A sua origem tem de enviar Access-Control-Allow-Origin: * (ou exatamente a origem do site, https://p2p.gia.tv) em todas as respostas: a lista principal, as listas de média e os segmentos. Exemplos:
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 na pasta HLS)
Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"
Wowza Streaming Engine: Application → Properties → Custom → adicione cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (módulo cupertinostreaming), ou use a definição CORS da origem HTTP.
CDN (Cloudflare, Akamai, CloudFront, Bunny…): ative o CORS nas definições da origem ou da pull zone, com * como origem permitida. Na Cloudflare, «Transform Rules → Response headers» pode acrescentar o cabeçalho.
Teste na linha de comandos (o cabeçalho tem de aparecer no resultado):
curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control
Fontes que funcionam bem
- Wowza, nginx-rtmp / nginx com o módulo HLS, Ant Media, Red5, MistServer, SRS, OvenMediaEngine (saída HLS), Unified Streaming, Flussonic.
- OBS / vMix / codificadores de hardware → RTMP → qualquer um dos anteriores → HLS.
- Qualquer CDN que vá buscar o sinal aos anteriores, incluindo a rede Tulix / SSH101.
- FFmpeg a escrever HLS num servidor web:
ffmpeg -re -i input -c:v libx264 -preset veryfast -g 60 -c:a aac -f hls -hls_time 4 -hls_list_size 10 -hls_flags delete_segments /var/www/live/stream.m3u8. - O HLS a pedido (uma lista com
#EXT-X-ENDLIST) também funciona; aí o P2P funciona ainda melhor, porque os espectadores estão em posições diferentes e podem partilhar mais.
Registo
- Aceda a https://p2p.gia.tv/signup.
- Escolha um nome de utilizador: 3 a 20 caracteres, letras minúsculas, algarismos e sublinhado. Passa a ser o seu endereço público
https://p2p.gia.tv/nome_de_utilizadore não pode ser alterado depois. - Introduza o seu e-mail e uma palavra-passe (mínimo de 8 caracteres).
- Se quiser, cole já o seu endereço
.m3u8e um título para o canal, ou acrescente-os mais tarde no painel. - Aceite os Termos de Utilização e a Política de Utilização Aceitável. Tem de deter os direitos de tudo o que transmite.
- Clique em Criar canal. Fica com sessão iniciada de imediato e chega ao seu painel.
Em alguns sites os registos estão fechados; nesse caso use a página de contacto.
O seu painel
https://p2p.gia.tv/dashboard mostra:
- o estado da transmissão (online/offline), quando foi verificada pela última vez e o erro, se falhou;
- os espectadores agora e o pico de espectadores simultâneos;
- a descarga P2P: a parte dos bytes de vídeo que os espectadores receberam de outros espectadores em vez da sua origem, e os totais;
- a qualidade: resolução, débito, número de variantes, codecs e o resultado da verificação CORS, tal como detetados na sua lista;
- o formulário das definições da transmissão: endereço, título, descrição, URL da miniatura, indicação 18+, indicação «não listado»;
- Partilhar e incorporar: o URL da sua página, o código de incorporação, o URL de incorporação e uma ligação para a vista de diagnóstico;
- um gráfico de espectadores de 24 horas (assim que alguém tiver assistido).
Verificar a emissão agora descarrega a sua lista a partir do servidor e mostra: online/offline, direto ou VOD, duração alvo, variantes, melhor resolução/débito, codecs e se o cabeçalho CORS está presente. As transmissões também são verificadas automaticamente a cada poucos minutos; a página inicial só lista canais online.
Quando o site envia e-mails, depois do registo o seu painel pede-lhe que confirme o seu endereço de e-mail (veja Perguntas frequentes).
Opções do canal
- Título / descrição / miniatura aparecem na sua página e na grelha de canais da página inicial. A miniatura tem de ser um URL de imagem https (JPEG/PNG/WebP, recomenda-se 16:9).
- Conteúdo para adultos (18+) marca o seu canal com um distintivo. Os canais para adultos ficam ocultos da página inicial, salvo se o administrador os permitir; a página e a incorporação funcionam sempre. Transmitir conteúdo para adultos sem esta indicação viola a Política de Utilização Aceitável.
- Não listado retira o canal da página inicial e do sitemap. A página e a incorporação continuam a funcionar. Útil para eventos privados ou durante testes.
A sua página de canal
https://p2p.gia.tv/nome_de_utilizador mostra o leitor, o título, a descrição, o número atual de espectadores, a ligação para partilhar, o código de incorporação e uma pequena caixa de diagnóstico.
Por baixo do vídeo há uma linha de estado P2P:
| Estado | Significado |
|---|---|
| P2P a funcionar | Este espectador recebe segmentos de pares (ou é o líder do enxame e serve outros). |
| P2P: a iniciar | Ligado à sinalização, à espera de pares ou do primeiro segmento partilhado. Normal para o primeiro espectador e durante os primeiros 10–20 segundos. |
| P2P não funciona | Veja o texto ao lado: WebRTC indisponível, reprodução nativa (Safari no iOS), sinalização inacessível ou todos os pares falharam. O vídeo continua a ser reproduzido a partir da origem. |
A página nunca bloqueia a reprodução por causa do P2P. Se algo correr mal, o espectador simplesmente vê a partir da origem.
Telemóvel: Chrome e Firefox no Android suportam P2P. O Safari no iOS reproduz HLS de forma nativa (sem Media Source Extensions), pelo que iPhones e iPads reproduzem sempre a partir da origem e não participam no P2P. O Safari no computador participa.
Incorporação
Copie o código de incorporação do seu painel ou da página do canal:
<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>
Opções:
- Responsivo: coloque o iframe num contentor e faça-o ocupar todo o espaço:
<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>
- Sem reprodução automática:
https://p2p.gia.tv/embed/user_name?autoplay=0mostra um botão de reproduzir. - A reprodução automática começa sem som (os navegadores exigem-no); um toque em «Ativar som» liga o áudio.
- WordPress: cole o iframe num bloco «HTML personalizado». Wix/Squarespace/Webflow: use o elemento de «código de incorporação».
- O atributo
allow="autoplay …"é importante: sem ele, muitos navegadores recusam a reprodução automática dentro de um iframe. - Os espectadores do seu leitor incorporado e os da sua página de canal estão no mesmo enxame; partilham segmentos entre si.
Existe um leitor simples, sem o aspeto do site, em https://p2p.gia.tv/?src=O_SEU_M3U8 (produção) e https://p2p.gia.tv/debug.html?src=O_SEU_M3U8 (diagnóstico). Usam o mesmo motor P2P e o mesmo enxame que a sua página de canal, porque o enxame é obtido a partir do URL da transmissão.
Testar
Precisa de dois leitores para ver o P2P; um único espectador descarrega sempre da origem.
- Abra a sua página de canal num navegador (por exemplo, Chrome). Espere até o vídeo começar.
- Abra a mesma página num segundo navegador (Firefox, Edge, outro perfil do Chrome, uma janela anónima, ou outro computador/telemóvel em qualquer rede).
- Em cerca de 10–20 segundos, a linha de estado do segundo leitor deve indicar P2P a funcionar. O primeiro passa a ser o líder e mostra que serve pares.
- Para ver detalhes, abra a ligação Vista de diagnóstico (também
https://p2p.gia.tv/debug.html?src=O_SEU_M3U8). Mostra cada segmento com a sua proveniência (ORIGIN ou PEER), os pares ligados, os bytes em cada sentido, o estado da sinalização, um bloco de diagnóstico que diz exatamente porque é que o P2P funciona ou não, e um procedimento de teste incorporado.
Notas:
- Dois separadores do mesmo navegador também funcionam, mas os navegadores abrandam os separadores em segundo plano; mantenha ambos visíveis.
- As redes empresariais e alguns operadores móveis bloqueiam o WebRTC (UDP). Um servidor TURN (configurado pelo administrador do site) ajuda na maioria desses casos.
- O primeiro espectador mostra sempre descargas da origem; é o esperado. Observe o segundo espectador.
- A reprodução a partir da origem enquanto o estado indica «P2P: a iniciar» é normal nos primeiros segmentos.
Limites
| Item | Valor | Notas |
|---|---|---|
| Canais por conta | 1 | Crie mais contas para mais transmissões. |
| Espectadores por canal (enxame) | até 500 por omissão | Definido pelo administrador. Acima do limite, os novos espectadores continuam a ver a partir da origem, mas sem P2P. |
| Pares por espectador | até 12 | Gerido automaticamente (o site pode alterar o número). |
| Comprimento do endereço da transmissão | 1024 caracteres | |
| Título / descrição | 120 / 600 caracteres | |
| Carga na origem | 1 a poucas descargas completas por enxame | O líder mais os espectadores cujos pares são demasiado lentos. |
| Envio do leitor | limitado por par e no total | Espectadores com envio lento servem automaticamente menos. |
Resolução de problemas
«Transmissão offline» no painel / nenhum vídeo
- Abra o seu
.m3u8num navegador: tem de ser descarregado um ficheiro de texto com#EXTM3U. Caso contrário, a sua origem não responde ou o URL está errado. - Execute Verificar a emissão agora e leia o erro.
403/404significam que o URL está errado ou protegido;timeout, que o servidor não responde a partir da Internet;no segments, que a lista está vazia (o codificador não está a funcionar). - O endereço tem de começar por
https://quando os espectadores usam este site em https (os navegadores bloqueiam conteúdo misto).
Funciona para mim, mas não para um espectador noutro país
- Pergunte ao espectador o que diz a linha de estado por baixo do leitor. Erro na transmissão — HTTP 403 ou não é possível aceder à transmissão significa que a sua origem ou CDN trata essa região de forma diferente (restrição geográfica, proteção contra hotlinking, um nó sem cabeçalhos CORS); a verificação a partir deste servidor não consegue ver isso. Este navegador não consegue descodificar a transmissão é um problema de codec no dispositivo dele. P2P: a iniciar ou P2P não funciona com o vídeo a reproduzir não é problema: o P2P é opcional.
- O administrador do site vê os mesmos motivos por espectador em Análise em direto.
- Desde a 2.1.0, a biblioteca do leitor é servida pelo próprio site (sem CDN de terceiros), por isso uma CDN de scripts bloqueada já não é uma causa.
Funciona no VLC mas não no navegador
- Quase sempre é o CORS. Veja CORS. O VLC não precisa de CORS; os navegadores precisam.
- Ou o codec: os navegadores normalmente não reproduzem vídeo MPEG-2, HEVC sem suporte de hardware nem áudio AC-3/E-AC-3. Use H.264 + AAC.
«P2P não funciona: sinalização inacessível»
- A rede do espectador bloqueia ligações WebSocket, ou uma extensão do navegador interfere. O vídeo continua a ser reproduzido a partir da origem.
- Se acontecer a todos, o site está a reiniciar ou um proxy à frente dele não deixa passar as ligações WebSocket (assunto do administrador).
«P2P não funciona: sem WebRTC» / «reprodução nativa»
- Navegadores muito antigos, alguns navegadores focados na privacidade com o WebRTC desativado, e o Safari no iOS. Não há nada a fazer do seu lado.
«P2P: a iniciar» indefinidamente com dois espectadores
- Ambos os espectadores estão atrás de NAT/firewalls restritivos e não há servidor TURN. Peça ao administrador que configure o TURN.
- Os nomes dos segmentos diferem consoante o espectador (tokens de sessão nos URL). Os pares anunciam os segmentos pelo nome; se os nomes forem diferentes, não se encontram. Use um URL idêntico para todos os espectadores.
- Os dois leitores não estão no mesmo enxame: têm de usar exatamente o mesmo URL de transmissão (o identificador do enxame é obtido a partir dele). Um
?token=diferente, ouhttpem vez dehttps, cria enxames diferentes.
O vídeo para / volta a carregar
- Verifique primeiro a origem: se a transmissão para logo no primeiro espectador, a origem ou o codificador são demasiado lentos. Reduza o débito ou corrija o codificador.
- Mantenha os segmentos curtos (2–4 s) e a janela da lista em 6 segmentos ou mais; com uma janela de 3 segmentos não há margem para recuperar.
- Os pares demasiado lentos são ignorados automaticamente; o leitor descarrega da origem dentro do prazo.
A página inicial não mostra o meu canal
- O canal tem de estar online (verificado a cada poucos minutos; use Verificar a emissão agora), não estar «não listado», não ser 18+ (salvo se o administrador o permitir), não estar bloqueado, e a conta não pode estar desativada. Alguns sites só listam um canal depois de o seu endereço de e-mail estar confirmado.
A incorporação mostra um quadro preto
- Use exatamente o código do iframe, incluindo
allow="autoplay; …". Procure na consola do navegador erros de conteúdo misto ou de CORS. Experimente?autoplay=0.
Esqueci-me da palavra-passe
- https://p2p.gia.tv/reset se o site tiver o e-mail configurado; caso contrário, contacte o administrador.
Alterei o meu endereço de e-mail, mas as Definições continuam a mostrar o antigo
- É intencional: quando o site envia e-mails, um novo endereço só passa a valer depois de abrir a ligação de confirmação que lhe enviámos (no prazo de 24 horas) e carregar em Confirmar. Até lá, as Definições mostram o endereço como pendente e a sua conta mantém o antigo. O seu endereço antigo também recebe um aviso. Para cancelar uma alteração, guarde o formulário com o seu endereço atual.
Perguntas frequentes
O meu vídeo é gravado ou retransmitido? Não. O site apenas apresenta os leitores uns aos outros. O vídeo é obtido da sua origem pelos navegadores dos espectadores e passado entre eles. Nada é guardado no servidor.
Posso usar uma transmissão de outro fornecedor (por exemplo, o meu canal Tulix/SSH101)? Sim, se tiver o direito de a distribuir e a origem enviar cabeçalhos CORS. A página do diretório SSH101 mostra um exemplo de integração.
É gratuito? Sim. O serviço é fornecido tal como está, nos termos dos Termos de Utilização. Os abusos (violação de direitos de autor, conteúdo ilegal) levam ao bloqueio; veja a Política de Utilização Aceitável.
Quantos espectadores posso ter? Tantos quantos a sua origem conseguiria servir sem P2P com cerca de 5–20 % da carga. Na prática, aplica-se por canal o limite de enxame definido pelo administrador (500 por omissão).
Os espectadores conseguem ver-se uns aos outros? Só tecnicamente (endereços IP dentro do WebRTC, como em qualquer serviço de vídeo P2P). Sem nomes, sem chat, sem histórico.
Que navegadores? Chrome, Edge, Firefox, Opera, Brave (com WebRTC permitido), Safari no computador, Chrome/Firefox no Android. O Safari no iOS reproduz sem P2P.
Funciona com DRM / HLS cifrado? As listas cifradas com AES-128 funcionam (os segmentos são partilhados cifrados; cada espectador obtém a chave do seu servidor de chaves). DRM FairPlay/Widevine não é suportado.
Posso mudar o meu nome de utilizador? Não, é o endereço permanente da sua página. Crie uma nova conta para um novo nome.
Posso eliminar a minha conta? Sim: Definições → Eliminar a conta, com a sua palavra-passe atual. A conta e a página do canal são eliminadas de imediato, os espectadores ligados são desligados e é enviado um aviso para o seu endereço de e-mail. Não pode ser anulado. (As contas de administrador são eliminadas por outro administrador.)
Porque é que o meu painel me pede para confirmar o meu endereço de e-mail? Quando o site envia e-mails, as contas novas recebem uma ligação de confirmação (válida 7 dias). Abra-a e carregue em Confirmar; Enviar o link de novo no painel envia uma nova (até 3 por hora). Alguns sites só listam um canal na página inicial depois de o seu endereço estar confirmado.
Contacto
Perguntas e denúncias de abuso: página de contacto · e-mail: info@tulix.com · abuso/DMCA: https://p2p.gia.tv/report.