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 enhttps://p2p.gia.tv/su_nombrey 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.
- 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
.m3u8que indicó), exactamente igual que cualquier otro reproductor. - 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.
- 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.
- 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.
- 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:
- Ancho de banda: con 50 espectadores, su origen soporta aproximadamente la carga de 1–3 espectadores. Cuantos más espectadores tiene un canal, mayor es el ahorro (normalmente un 80–97 %).
- Calidad: los espectadores ven la misma emisión HLS con la misma calidad. El P2P solo cambia de dónde vienen los bytes.
- Fiabilidad: si los pares son lentos o desaparecen, el reproductor vuelve al origen sin que se note. Por eso el origen debe estar siempre accesible; el P2P reduce su carga, no lo sustituye.
- Privacidad: los pares solo intercambian segmentos de vídeo y pequeños mensajes de control. No se intercambian datos personales entre espectadores. Mediante WebRTC, los espectadores pueden ver las direcciones IP de los demás, como en cualquier servicio de vídeo P2P.
Requisitos
Su emisión debe cumplir estos requisitos. El botón Comprobar la emisión ahora del panel comprueba la mayoría por usted.
| Requisito | Por 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 CDN | Los 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 estables | Los 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 s | Los 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 admita | Los 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
- Wowza, nginx-rtmp / nginx con el módulo HLS, Ant Media, Red5, MistServer, SRS, OvenMediaEngine (salida HLS), Unified Streaming, Flussonic.
- OBS / vMix / codificadores de hardware → RTMP → cualquiera de los anteriores → HLS.
- Cualquier CDN que tome la señal de los anteriores, incluida la red Tulix / SSH101.
- FFmpeg escribiendo HLS en un 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. - El HLS bajo demanda (una lista con
#EXT-X-ENDLIST) también funciona; ahí el P2P va incluso mejor, porque los espectadores están en posiciones distintas y pueden compartir más.
Registro
- Vaya a https://p2p.gia.tv/signup.
- 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_usuarioy no podrá cambiarse después. - Introduzca su correo y una contraseña (8 caracteres como mínimo).
- Si quiere, pegue ya su dirección
.m3u8y un título para el canal, o añádalos más tarde en el panel. - Acepte las Condiciones de uso y la Política de uso aceptable. Debe poseer los derechos de todo lo que emita.
- 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:
- el estado de la emisión (en línea/fuera de línea), cuándo se comprobó por última vez y el error si falló;
- los espectadores ahora y el máximo de espectadores simultáneos;
- el ahorro P2P: la parte de los bytes de vídeo que los espectadores recibieron de otros espectadores en lugar de su origen, y los totales;
- la calidad: resolución, tasa de bits, número de variantes, códecs y el resultado de la comprobación CORS, según su lista;
- el formulario de ajustes de la emisión: dirección, título, descripción, URL de la miniatura, marca 18+, marca «no listado»;
- Compartir e insertar: la URL de su página, el código de inserción, la URL de inserción y un enlace a la vista de diagnóstico;
- un gráfico de espectadores de 24 horas (en cuanto alguien haya mirado).
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
- Título / descripción / miniatura se muestran en su página y en la cuadrícula de canales de la página principal. La miniatura debe ser una URL de imagen https (JPEG/PNG/WebP, se recomienda 16:9).
- Contenido para adultos (18+) marca su canal con una etiqueta. Los canales para adultos se ocultan de la página principal salvo que el administrador lo permita; la página y la inserción funcionan siempre. Emitir contenido para adultos sin esta marca infringe la Política de uso aceptable.
- No listado quita el canal de la página principal y del sitemap. La página y la inserción siguen funcionando. Útil para eventos privados o mientras hace pruebas.
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:
| Estado | Significado |
|---|---|
| P2P funcionando | Este espectador recibe segmentos de pares (o es el líder del enjambre y sirve a otros). |
| P2P: iniciando | Conectado 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 funciona | Vea 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:
- Adaptable: coloque el iframe en un contenedor y haga que lo ocupe por completo:
<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>
- Sin reproducción automática:
https://p2p.gia.tv/embed/user_name?autoplay=0muestra un botón de reproducir. - La reproducción automática empieza sin sonido (los navegadores lo exigen); un toque en «Activar sonido» activa el audio.
- WordPress: pegue el iframe en un bloque «HTML personalizado». Wix/Squarespace/Webflow: use su elemento de «código de inserción».
- El atributo
allow="autoplay …"importa: sin él, muchos navegadores no permiten la reproducción automática dentro de un iframe. - Los espectadores de su reproductor insertado y los de su página de canal están en el mismo enjambre; comparten segmentos entre sí.
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.
- Abra su página de canal en un navegador (por ejemplo, Chrome). Espere a que se reproduzca el vídeo.
- 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).
- 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.
- 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:
- Dos pestañas del mismo navegador también sirven, pero los navegadores ralentizan las pestañas en segundo plano; mantenga ambas visibles.
- Las redes de empresa y algunos operadores móviles bloquean WebRTC (UDP). Un servidor TURN (configurado por el administrador del sitio) ayuda en la mayoría de esos casos.
- El primer espectador siempre muestra descargas del origen; es lo esperado. Fíjese en el segundo espectador.
- Reproducir desde el origen mientras el estado dice «P2P: iniciando» es normal en los primeros segmentos.
Límites
| Elemento | Valor | Notas |
|---|---|---|
| Canales por cuenta | 1 | Cree más cuentas para más emisiones. |
| Espectadores por canal (enjambre) | hasta 500 por defecto | Lo fija el administrador. Por encima del límite, los nuevos espectadores siguen viendo desde el origen, pero sin P2P. |
| Pares por espectador | hasta 12 | Se gestiona automáticamente (el sitio puede cambiar el número). |
| Longitud de la dirección de la emisión | 1024 caracteres | |
| Título / descripción | 120 / 600 caracteres | |
| Carga en el origen | de 1 a unas pocas descargas completas por enjambre | El líder más los espectadores cuyos pares son demasiado lentos. |
| Subida del reproductor | limitada por par y en total | Los 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
- Abra su
.m3u8en un navegador: debe descargarse un archivo de texto con#EXTM3U. Si no, su origen no responde o la URL es incorrecta. - Pulse Comprobar la emisión ahora y lea el error.
403/404indican que la URL es incorrecta o está protegida;timeout, que el servidor no responde desde Internet;no segments, que la lista está vacía (el codificador no está funcionando). - La dirección debe empezar por
https://cuando los espectadores usan este sitio https (los navegadores bloquean el contenido mixto).
Se reproduce para mí, pero no para un espectador de otro país
- Pregunte al espectador qué dice la línea de estado bajo el reproductor. Error de emisión — HTTP 403 o no se puede acceder a la emisión significa que su origen o CDN trata esa región de otra forma (restricción geográfica, protección contra enlaces externos, un nodo sin cabeceras CORS); la comprobación desde este servidor no puede verlo. Este navegador no puede decodificar la emisión es un problema de códec en su dispositivo. P2P: iniciando o P2P no funciona con el vídeo reproduciéndose es normal: el P2P es opcional.
- El administrador del sitio ve los mismos motivos por espectador en Analítica en vivo.
- Desde la 2.1.0, este sitio sirve él mismo la biblioteca del reproductor (sin CDN de terceros), así que un CDN de scripts bloqueado ya no es una causa.
Funciona en VLC pero no en el navegador
- Casi siempre es CORS. Vea CORS. VLC no necesita CORS; los navegadores, sí.
- O el códec: los navegadores no suelen poder reproducir vídeo MPEG-2, HEVC sin soporte de hardware ni audio AC-3/E-AC-3. Use H.264 + AAC.
«P2P no funciona: señalización inaccesible»
- La red del espectador bloquea las conexiones WebSocket, o interfiere una extensión del navegador. El vídeo sigue reproduciéndose desde el origen.
- Si le pasa a todo el mundo, el sitio se está reiniciando o un proxy delante de él no deja pasar las conexiones WebSocket (asunto del administrador).
«P2P no funciona: sin WebRTC» / «reproducción nativa»
- Navegadores muy antiguos, algunos navegadores de privacidad con WebRTC desactivado y Safari de iOS. No hay nada que hacer por su parte.
«P2P: iniciando» sin fin con dos espectadores
- Ambos espectadores están detrás de NAT o cortafuegos restrictivos y no hay servidor TURN. Pida al administrador que configure TURN.
- Los nombres de los segmentos difieren según el espectador (tokens de sesión en las URL). Los pares anuncian los segmentos por su nombre; si los nombres difieren, no se encuentran. Use una URL idéntica para todos los espectadores.
- Los dos reproductores no están en el mismo enjambre: deben usar exactamente la misma URL de emisión (el identificador del enjambre se obtiene de ella). Un
?token=distinto, ohttpfrente ahttps, crea enjambres distintos.
El vídeo se detiene / se vuelve a cargar
- Compruebe primero el origen: si la emisión se detiene ya para el primer espectador, el origen o el codificador son demasiado lentos. Reduzca la tasa de bits o corrija el codificador.
- Mantenga los segmentos cortos (2–4 s) y la ventana de la lista en 6 segmentos o más; con una ventana de 3 segmentos no hay margen para recuperarse.
- Los pares demasiado lentos se descartan automáticamente; el reproductor descarga del origen dentro del plazo.
La página principal no muestra mi canal
- El canal debe estar en línea (se comprueba cada pocos minutos; use Comprobar la emisión ahora), no estar «no listado», no ser 18+ (salvo que el administrador lo permita), no estar bloqueado y la cuenta no debe estar desactivada. Algunos sitios solo muestran un canal cuando su dirección de correo está confirmada.
La inserción muestra un recuadro negro
- Use exactamente el código del iframe, incluido
allow="autoplay; …". Mire en la consola del navegador si hay errores de contenido mixto o de CORS. Pruebe?autoplay=0.
He olvidado mi contraseña
- https://p2p.gia.tv/reset si el sitio tiene el correo configurado; si no, póngase en contacto con el administrador.
He cambiado mi dirección de correo, pero los Ajustes siguen mostrando la antigua
- Es intencionado: cuando el sitio envía correos, una dirección nueva solo se aplica cuando abre el enlace de confirmación que le enviamos (en un plazo de 24 horas) y pulsa Confirmar. Hasta entonces, los Ajustes muestran la dirección como pendiente y su cuenta conserva la antigua. Su dirección antigua también recibe un aviso. Para cancelar un cambio, guarde el formulario con su dirección actual.
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.