P2P LiveFree live streaming · peer-to-peer delivery

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 em https://p2p.gia.tv/o_seu_nome e 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.

  1. 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 .m3u8 que indicou), exatamente como qualquer outro leitor.
  2. 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.
  3. 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.
  4. 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.
  5. 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:

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.

RequisitoPorquê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 CDNSem 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áveisOs 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 sSegmentos 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 suporteOs 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

Registo

  1. Aceda a https://p2p.gia.tv/signup.
  2. 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_utilizador e não pode ser alterado depois.
  3. Introduza o seu e-mail e uma palavra-passe (mínimo de 8 caracteres).
  4. Se quiser, cole já o seu endereço .m3u8 e um título para o canal, ou acrescente-os mais tarde no painel.
  5. 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.
  6. 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:

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

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:

EstadoSignificado
P2P a funcionarEste espectador recebe segmentos de pares (ou é o líder do enxame e serve outros).
P2P: a iniciarLigado à 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 funcionaVeja 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:

<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>

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.

  1. Abra a sua página de canal num navegador (por exemplo, Chrome). Espere até o vídeo começar.
  2. 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).
  3. 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.
  4. 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:

Limites

ItemValorNotas
Canais por conta1Crie mais contas para mais transmissões.
Espectadores por canal (enxame)até 500 por omissãoDefinido pelo administrador. Acima do limite, os novos espectadores continuam a ver a partir da origem, mas sem P2P.
Pares por espectadoraté 12Gerido automaticamente (o site pode alterar o número).
Comprimento do endereço da transmissão1024 caracteres
Título / descrição120 / 600 caracteres
Carga na origem1 a poucas descargas completas por enxameO líder mais os espectadores cujos pares são demasiado lentos.
Envio do leitorlimitado por par e no totalEspectadores com envio lento servem automaticamente menos.

Resolução de problemas

«Transmissão offline» no painel / nenhum vídeo

Funciona para mim, mas não para um espectador noutro país

Funciona no VLC mas não no navegador

«P2P não funciona: sinalização inacessível»

«P2P não funciona: sem WebRTC» / «reprodução nativa»

«P2P: a iniciar» indefinidamente com dois espectadores

O vídeo para / volta a carregar

A página inicial não mostra o meu canal

A incorporação mostra um quadro preto

Esqueci-me da palavra-passe

Alterei o meu endereço de e-mail, mas as Definições continuam a mostrar o antigo

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.