P2P LiveFree live streaming · peer-to-peer delivery

P2P Live — Manual del usuario

Este manual explica todo lo que necesita quien emite o quien mira: cómo funciona el servicio, cómo registrarse, cómo debe ser su emisión, cómo insertar el reproductor, cómo comprobar que la entrega entre pares (P2P) funciona, cuáles son los límites y cómo resolver los problemas más frecuentes.

En resumen: regístrese, pegue la dirección de su emisión HLS (una URL .m3u8) y obtendrá una página pública en https://p2p.gia.tv/su_nombre y un código para insertarla. Los espectadores de esa página comparten el vídeo entre sí a través de sus navegadores, de modo que su servidor de streaming o su CDN entrega la emisión una vez en lugar de una vez por espectador.

Cómo funciona

Cada página de canal contiene un reproductor HLS estándar (hls.js) con un motor P2P conectado.

  1. El primer espectador de un canal descarga la lista de reproducción y los segmentos de vídeo de su servidor de origen (la dirección .m3u8 que indicó), exactamente igual que cualquier otro reproductor.
  2. Cada espectador adicional abre la misma página. Los reproductores se encuentran a través del servidor de señalización de este sitio (un pequeño servicio WebSocket) y se conectan directamente, de navegador a navegador, mediante canales de datos WebRTC.
  3. Cada segmento de vídeo lo descarga del origen un espectador (el líder del enjambre) y luego se reenvía a los demás por las conexiones P2P. Si un segmento no llega a tiempo desde un par, el reproductor lo pide él mismo al origen, así que la reproducción nunca depende de los pares.
  4. Cada segmento se verifica (hash y análisis del contenido) antes de entregarlo al reproductor. Un par no puede introducir datos erróneos en la reproducción de otro espectador.
  5. Los reproductores envían estadísticas anónimas (bytes del origen, bytes de pares, cortes, pares conectados) para que vea el porcentaje de descarga en su panel.

Lo que esto significa para usted:

Requisitos

Su emisión debe cumplir estos requisitos. El botón Comprobar la emisión ahora del panel comprueba la mayoría por usted.

RequisitoPor quéCómo comprobarlo
HLS (lista .m3u8) por http:// o https://El reproductor es un reproductor HLS. RTMP, RTSP, DASH, la ingesta WebRTC y los archivos MP4 simples no se admiten directamente.Abra la URL en un navegador: debe descargarse un pequeño archivo de texto que empieza por #EXTM3U.
Cabecera CORS Access-Control-Allow-Origin: * (o exactamente https://p2p.gia.tv) en las listas y en los segmentos, desde todos los nodos de su CDNLos navegadores rechazan las peticiones entre sitios sin ella. Sin CORS la emisión no se reproduce en absoluto, con P2P o sin él. Una cabecera que nombra otro sitio no sirve.Panel → Comprobar la emisión ahora → «CORS». O curl -sI -H 'Origin: https://p2p.gia.tv' SU_URL y busque la cabecera.
https:// si sus espectadores usan https (este sitio usa https)Los navegadores bloquean los medios http:// en páginas https:// (contenido mixto).Asegúrese de que la URL empieza por https://.
URL de segmentos establesLos pares intercambian segmentos por su nombre. Si cada espectador recibe una URL con nombre distinto para el mismo segmento (tokens por espectador, pistas del balanceador como lb_backend_hint, URL absolutas en servidores que cambian), los pares no pueden compartir.Panel → Comprobar la emisión ahora → «Compartir». O abra la lista de medios dos veces: los nombres de los segmentos deben coincidir. Las URL firmadas que son iguales para todos los espectadores no son un problema.
Duración de segmento de 2–10 sLos segmentos muy cortos (< 1 s) aumentan la señalización; los muy largos (> 10 s) retrasan el intercambio entre pares.#EXT-X-TARGETDURATION en la lista de medios.
Códecs: vídeo H.264, audio AAC o MP3 (segmentos TS o fMP4); H.265/HEVC solo donde el navegador lo admitaLos decodificadores del navegador.Con la vista de diagnóstico o la comprobación del panel.

Requisitos del origen

La comprobación prueba la lista desde este servidor. Un CDN u origen que trata a los espectadores de forma distinta según el país o la red (bloqueo geográfico, protección contra enlaces externos, nodos regionales sin cabeceras CORS) puede parecer correcto aquí y fallar para algunos espectadores. Esos espectadores ven bajo el reproductor Error de emisión — el origen rechazó a este espectador: HTTP 403 …, y el mismo motivo le aparece a usted en Administración → Analítica en vivo (si administra el sitio): pida al espectador el motivo que se muestra, o el registro de eventos de la vista de diagnóstico.

CORS

Es, con diferencia, el problema más frecuente. Su origen debe enviar Access-Control-Allow-Origin: * (o exactamente el origen del sitio, https://p2p.gia.tv) en cada respuesta: la lista maestra, las listas de medios y los segmentos. Ejemplos:

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 en el directorio HLS)

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

Wowza Streaming Engine: Application → Properties → Custom → añada cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (módulo cupertinostreaming), o use el ajuste CORS del origen HTTP.

CDN (Cloudflare, Akamai, CloudFront, Bunny…): active CORS en la configuración del origen o de la zona de extracción, con * como origen permitido. En Cloudflare, «Transform Rules → Response headers» puede añadir la cabecera.

Prueba desde la línea de comandos (la cabecera debe aparecer en la salida):

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

Fuentes que funcionan bien

Registro

  1. Vaya a https://p2p.gia.tv/signup.
  2. Elija un nombre de usuario: de 3 a 20 caracteres, letras minúsculas, cifras y guion bajo. Será su dirección pública https://p2p.gia.tv/nombre_de_usuario y no podrá cambiarse después.
  3. Introduzca su correo y una contraseña (8 caracteres como mínimo).
  4. Si quiere, pegue ya su dirección .m3u8 y un título para el canal, o añádalos más tarde en el panel.
  5. Acepte las Condiciones de uso y la Política de uso aceptable. Debe poseer los derechos de todo lo que emita.
  6. Pulse Crear canal. Inicia sesión de inmediato y llega a su panel.

En algunos sitios el registro está cerrado; en ese caso use la página de contacto.

Su panel

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

Comprobar la emisión ahora descarga su lista desde el servidor y muestra: en línea/fuera de línea, en directo o VOD, duración objetivo, variantes, mejor resolución/tasa de bits, códecs y si la cabecera CORS está presente. Las emisiones también se comprueban automáticamente cada pocos minutos; la página principal solo muestra canales en línea.

Cuando el sitio envía correos, su panel le pide tras el registro que confirme su dirección de correo (vea Preguntas frecuentes).

Opciones del canal

Su página de canal

https://p2p.gia.tv/nombre_de_usuario muestra el reproductor, el título, la descripción, el número actual de espectadores, el enlace para compartir, el código de inserción y un pequeño recuadro de diagnóstico.

Bajo el vídeo hay una línea de estado P2P:

EstadoSignificado
P2P funcionandoEste espectador recibe segmentos de pares (o es el líder del enjambre y sirve a otros).
P2P: iniciandoConectado a la señalización, esperando pares o el primer segmento compartido. Normal para el primer espectador y durante los primeros 10–20 segundos.
P2P no funcionaVea el texto al lado: WebRTC no disponible, reproducción nativa (Safari de iOS), señalización inaccesible o todos los pares fallaron. El vídeo sigue reproduciéndose desde el origen.

La página nunca bloquea la reproducción por culpa del P2P. Si algo falla, el espectador simplemente ve la emisión desde el origen.

Móvil: Chrome y Firefox en Android admiten P2P. Safari de iOS reproduce HLS de forma nativa (sin Media Source Extensions), por lo que iPhone y iPad siempre reproducen desde el origen y no participan en el P2P. Safari de escritorio sí participa.

Inserción

Copie el código de inserción de su panel o de su página de 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>

Opciones:

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

Hay un reproductor sin el marco del sitio en https://p2p.gia.tv/?src=SU_M3U8 (producción) y https://p2p.gia.tv/debug.html?src=SU_M3U8 (diagnóstico). Usan el mismo motor P2P y el mismo enjambre que su página de canal, porque el enjambre se obtiene de la URL de la emisión.

Pruebas

Para ver el P2P necesita dos reproductores; un solo espectador siempre descarga del origen.

  1. Abra su página de canal en un navegador (por ejemplo, Chrome). Espere a que se reproduzca el vídeo.
  2. Abra la misma página en un segundo navegador (Firefox, Edge, otro perfil de Chrome, una ventana de incógnito u otro ordenador o teléfono en cualquier red).
  3. En unos 10–20 segundos, la línea de estado del segundo reproductor debería decir P2P funcionando. El primero se convierte en el líder e indica que sirve a pares.
  4. Para ver detalles, abra el enlace Vista de diagnóstico (también https://p2p.gia.tv/debug.html?src=SU_M3U8). Muestra cada segmento con su origen (ORIGIN o PEER), los pares conectados, los bytes en cada sentido, el estado de la señalización, un bloque de diagnóstico que dice exactamente por qué el P2P funciona o no, y un procedimiento de prueba integrado.

Notas:

Límites

ElementoValorNotas
Canales por cuenta1Cree más cuentas para más emisiones.
Espectadores por canal (enjambre)hasta 500 por defectoLo fija el administrador. Por encima del límite, los nuevos espectadores siguen viendo desde el origen, pero sin P2P.
Pares por espectadorhasta 12Se gestiona automáticamente (el sitio puede cambiar el número).
Longitud de la dirección de la emisión1024 caracteres
Título / descripción120 / 600 caracteres
Carga en el origende 1 a unas pocas descargas completas por enjambreEl líder más los espectadores cuyos pares son demasiado lentos.
Subida del reproductorlimitada por par y en totalLos espectadores con subida lenta sirven menos automáticamente.

Solución de problemas

«Emisión fuera de línea» en el panel / ningún vídeo

Se reproduce para mí, pero no para un espectador de otro país

Funciona en VLC pero no en el navegador

«P2P no funciona: señalización inaccesible»

«P2P no funciona: sin WebRTC» / «reproducción nativa»

«P2P: iniciando» sin fin con dos espectadores

El vídeo se detiene / se vuelve a cargar

La página principal no muestra mi canal

La inserción muestra un recuadro negro

He olvidado mi contraseña

He cambiado mi dirección de correo, pero los Ajustes siguen mostrando la antigua

Preguntas frecuentes

¿Se graba o se reemite mi vídeo? No. El sitio solo pone en contacto a los reproductores. El vídeo lo obtienen los navegadores de los espectadores de su origen y se lo pasan entre sí. No se guarda nada en el servidor.

¿Puedo usar una emisión de otro proveedor (por ejemplo, mi canal de Tulix/SSH101)? Sí, si tiene derecho a distribuirla y el origen envía cabeceras CORS. La página del directorio SSH101 muestra un ejemplo de integración.

¿Es gratis? Sí. El servicio se ofrece tal cual, conforme a las Condiciones de uso. El abuso (infracción de derechos de autor, contenido ilegal) conlleva el bloqueo; vea la Política de uso aceptable.

¿Cuántos espectadores puedo tener? Tantos como su origen podría atender sin P2P con aproximadamente un 5–20 % de la carga. En la práctica se aplica por canal el límite de enjambre fijado por el administrador (500 por defecto).

¿Pueden verse los espectadores entre sí? Solo técnicamente (direcciones IP dentro de WebRTC, como en cualquier servicio de vídeo P2P). Sin nombres, sin chat, sin historial.

¿Qué navegadores? Chrome, Edge, Firefox, Opera, Brave (con WebRTC permitido), Safari de escritorio, Chrome/Firefox en Android. Safari de iOS reproduce sin P2P.

¿Funciona con DRM / HLS cifrado? Las listas cifradas con AES-128 funcionan (los segmentos se comparten cifrados; cada espectador obtiene la clave de su servidor de claves). El DRM FairPlay/Widevine no se admite.

¿Puedo cambiar mi nombre de usuario? No: es la dirección permanente de su página. Cree una cuenta nueva para tener otro nombre.

¿Puedo eliminar mi cuenta? Sí: Ajustes → Eliminar la cuenta, con su contraseña actual. La cuenta y la página del canal se eliminan de inmediato, los espectadores conectados se desconectan y se envía un aviso a su dirección de correo. No se puede deshacer. (Las cuentas de administrador las elimina otro administrador.)

¿Por qué mi panel me pide confirmar mi dirección de correo? Cuando el sitio envía correos, las cuentas nuevas reciben un enlace de confirmación (válido 7 días). Ábralo y pulse Confirmar; Enviar el enlace de nuevo en el panel envía uno nuevo (hasta 3 por hora). Algunos sitios solo muestran un canal en la página principal cuando su dirección está confirmada.

Contacto

Preguntas y denuncias de abuso: página de contacto · correo: info@tulix.com · abuso/DMCA: https://p2p.gia.tv/report.