Un canal HLS 24/7 a partir de archivos VOD: qué rompe el stream
En esta página
Un canal lineal hecho con una biblioteca VOD es un pedido frecuente:
- un cineclub quiere una emisión nocturna en su sitio web
- una escuela en línea quiere repetir sus clases las 24 horas
- una marca quiere sus videos en bucle en las pantallas de sus tiendas
Ninguno tiene un encoder en directo. Solo tienen archivos subidos. Aun así, quieren esto:
- todos los espectadores ven lo mismo en el mismo momento
- un show empieza a las 20:00
- junto al reproductor hay un recuadro de "ahora / a continuación"
HLS no es más que listas de segmentos. Así que la primera idea es sencilla: tomar los segmentos del primer video, luego los del segundo, luego los del tercero. Servirlos como una sola lista en directo que no deja de crecer y nunca recibe #EXT-X-ENDLIST. Al reproductor no le importa de dónde vienen los segmentos, mientras sigan llegando.
Eso funciona mientras todos los videos son iguales y nadie toca el programa. Abajo contamos dónde se nos rompió con una biblioteca real y qué hicimos al respecto en el canal 24/7 de dodocast.
Nuestro canal de demostración, Open Movies 24/7, funciona en dodocast: seis cortometrajes (películas abiertas de la Blender Foundation bajo CC BY y un clip de la NASA) se reproducen en un bucle de 22 minutos, y un show, "Caminandes marathon", empieza todos los días a las 20:00 UTC. El stream es público, y los ejemplos de abajo lo usan.

La lista maestra es un contrato para toda la sesión
En un stream en directo, el reproductor vuelve a leer una y otra vez las listas de medios. La lista maestra la lee una sola vez, cuando empieza la reproducción. A partir de ahí confía en lo que la lista maestra declara: las calidades, las resoluciones, los códecs, los grupos de audio y los grupos de subtítulos. Un ejemplo ilustrativo:
#EXTM3U
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="en",NAME="English",DEFAULT=YES,URI="audio/en.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="es",NAME="Español",URI="audio/es.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",URI="subs/en.m3u8"
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2800000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
720p/index.m3u8Con un solo video, esto no se nota. Con un canal, cada video que sale al aire durante la reproducción tiene que coincidir con lo que declaró la lista maestra. Una biblioteca real no coincide:
- algunos videos se subieron en 1080p y otros solo en 720p
- una película es 2.39:1 y las demás son 16:9
- otra no tiene pista en español
Si el reproductor está en 1080p y el siguiente video no tiene 1080p, el reproductor no tiene nada que descargar.
Por eso un canal de dodocast tiene un formato fijo. El formato define qué calidades emite el canal (de 240p a 1080p) y una sola relación de aspecto para todas ellas. Un video que no encaja se queda fuera del programa. Es mejor eso que un stream roto para todos los que ya están mirando. La consola muestra el motivo:
| Etiqueta | Qué significa |
|---|---|
| "missing 1080p" (falta 1080p) | Al video le falta una calidad que el canal declaró. |
| "1080p encoding…" (codificando 1080p) | El video se acaba de subir y su codificación en 1080p todavía no ha terminado. Encaja cuando termina la codificación. |
| "too wide" (demasiado ancho) | Su encuadre es más ancho que el del canal; por ejemplo, una película 2.39:1 en un canal 16:9. |
En CODECS, avc1.640028 significa H.264 perfil High, nivel 4.0. El navegador lee esta cadena para decidir si su decodificador puede con el video. Si el canal declara solo el nivel de los videos que hay ahora en el programa, un video más pesado añadido después puede fallar en algunos dispositivos. Por eso el canal declara un límite superior con algo de margen (la consola lo llama "Codec level headroom", margen de nivel del códec). Un video añadido al aire se mantiene dentro de ese límite. Los dispositivos muy antiguos rechazan un nivel declarado alto. Si te importan, puedes desactivar el margen, pero entonces vuelve el riesgo con los videos más pesados.
Los grupos AUDIO y SUBTITLES funcionan igual. Supongamos que el canal declaró inglés y español, y el siguiente video solo tiene inglés. Alguien tiene que decidir qué oirá un espectador que eligió español. Dejamos esa decisión al propietario del canal. El propietario define qué idiomas promete el canal. Para los videos sin esos idiomas, elige una de dos opciones: usar la pista predeterminada del video o dejar el video fuera del aire. Si no declaras subtítulos, el reproductor no muestra ninguno, aunque los videos los tengan.
Por la misma razón, el formato, los idiomas de subtítulos y la clave de cifrado solo se pueden cambiar con el canal apagado.
Editar el programa sin cortes
El programa también cambia. Se añaden videos nuevos, se quitan los viejos y se reordena el resto, y se quiere hacer al aire. Si un cambio se aplica al instante, un espectador que está en medio de un video aterriza en un punto cualquiera de otro.
En dodocast, un cambio publica una nueva versión del programa. La nueva versión entra en vigor en el siguiente límite entre videos. Hasta entonces sigue sonando la versión anterior. La consola muestra "Edit takes effect at 9:36 PM" (el cambio entra en vigor a las 21:36) y marca los videos como "added" (añadido) o "removed" (quitado). El espectador solo ve que empieza el siguiente video.

Una parrilla sobre el bucle
El programa es un bucle que corre sin fin. Pero la televisión va por el reloj: un maratón a las 20:00, clases los días laborables a las 9:00. Por eso los shows van en una parrilla, por encima del bucle.
Un show es un video o toda una lista de reproducción a una hora fija: una vez, todos los días o ciertos días de la semana. Un show dura de 1 a 1440 minutos. Si el material es más largo, el canal lo corta. Si es más corto, el canal completa el resto con relleno. Los shows no pueden solaparse.
Las horas de los shows usan la zona horaria del canal. Así, "todos los días a las 20:00" sigue siendo a las 20:00 tras los cambios de horario de verano. No se desplaza una hora dos veces al año.
También tuvimos que decidir qué hace el bucle cuando termina un show. No había una única respuesta correcta, así que es un ajuste del canal:
| Opción | Después de un show | Sirve para |
|---|---|---|
| From the start (desde el principio) | El bucle vuelve a empezar. | un programa de relleno corto que quieres que se vea entero |
| Continue (continuar) | El bucle sigue desde el punto en que lo interrumpió el show. | un programa largo en el que repetir el comienzo molestaría |
| Background air (emisión de fondo) | El bucle siguió corriendo todo el tiempo. El show simplemente se emitió por encima. | un canal de "televisión de verdad" cuyo fondo va con su propio reloj |
La parrilla también se puede editar al aire. El canal recalcula la parrilla en menos de un minuto. Los espectadores ven el cambio desde la siguiente emisión.

EPG y cifrado
Un canal en un sitio web casi siempre necesita al lado un recuadro de "ahora en emisión" o una guía de programación. El canal publica su estado actual y su guía en JSON con CORS abierto. Así que puedes consultarlos directamente desde el navegador, sin tener que extraer datos del reproductor. Las dos solicitudes de abajo funcionan con el canal de demostración.

El estado dice qué video se emite ahora, cuál sigue y cuándo empieza el próximo show:
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI"Una respuesta recortada:
{
"title": "Open Movies 24/7",
"state": "ON",
"currentItem": { "title": "Wing It!", "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
"nextItem": { "title": "Big Buck Bunny", "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
"nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 }
}Respuesta completa
{
"code": "cBlTOROrQI",
"title": "Open Movies 24/7",
"description": null,
"tags": [],
"state": "ON",
"serverTimeMs": 1795088315571,
"itemCount": 6,
"totalDurationMs": 1324106,
"encrypted": false,
"poster": "https://stream.dodocast.com/preview/xOa9tZc7QO/cover.jpg?v=4ed796473e0a3fba01e92351074b25f147caa1eb3c33a090f026009ec0a356e1",
"currentItem": { "code": "xOa9tZc7QO", "title": "Wing It!", "durationMs": 237894, "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
"nextItem": { "code": "x10F5HR9Zt", "title": "Big Buck Bunny", "durationMs": 634425, "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
"currentShow": null,
"nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 },
"access": { "type": "PUBLIC", "granted": true, "requiresPassword": false },
"embedding": { "policy": "ALL", "domains": [] },
"theme": { "colorPrimary": "indigo", "colorNeutral": "zinc" },
"watchLayout": "LIVE_STAGE",
"sources": {
"mp4": "https://stream.dodocast.com/ch/mp4/cBlTOROrQI/master.m3u8",
"ts": "https://stream.dodocast.com/ch/ts/cBlTOROrQI/master.m3u8"
}
}El pen de abajo usa solo esta solicitud y hls.js. El reproductor reproduce el canal de demostración, y el recuadro de debajo se actualiza cuando termina un video.
Abrir el ejemplo en vivo en CodePen →Un reproductor del canal de demostración y un recuadro «ahora / a continuación» con el JSON de estado del canal (hls.js, sin SDK).La guía enumera solo los shows de la parrilla, no los videos del bucle. De forma predeterminada cubre las próximas 24 horas; con from y to (tiempo Unix en milisegundos) puede cubrir hasta dos semanas. Esta solicitud pide los próximos siete días:
FROM=$(date +%s)000; TO=$(( $(date +%s) + 7*86400 ))000
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI/epg?from=$FROM&to=$TO"Respuesta (las dos primeras de siete entradas)
{
"code": "cBlTOROrQI",
"title": "Open Movies 24/7",
"serverTimeMs": 1795089367508,
"entries": [
{ "startsAtMs": 1795118400000, "endsAtMs": 1795118820000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] },
{ "startsAtMs": 1795204800000, "endsAtMs": 1795205220000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] }
]
}El Player SDK ya lo incluye. getChannelState() devuelve lo de ahora y lo siguiente, getChannelGuide() devuelve hasta dos semanas y progress() indica cuánto has avanzado en el show actual.
Además, un programa mezcla con facilidad videos cifrados y sin cifrar. Si cada video trae su propia clave, el reproductor cambia de clave en cada límite. Un video abierto en medio de un stream cifrado deja un hueco. Por eso el canal tiene su propia clave. Ignora los ajustes de cifrado de cada video y cifra los segmentos a medida que los entrega. AES-128 y SAMPLE-AES protegen contra la descarga casual. No son DRM, y el sitio lo dice.
Lo que el canal todavía no hace
- recibir una señal en directo de una cámara o un encoder
- insertar pausas publicitarias en el stream (SCTE-35)
- permitir a los espectadores retroceder en el canal (DVR)
Una transmisión puntual en modo Premiere sí permite retroceder hasta su inicio, pero no saltar hacia delante.
El recorrido de 2 minutos por dodocast muestra todo esto en la consola. Nuestro reproductor HLS gratuito muestra qué hay dentro de cualquier stream HLS: sus calidades, CODECS y pistas. También reproduce el stream con hls.js o con el reproductor integrado del navegador, para que puedas comparar los dos.
Desarrollamos dodocast, una plataforma de video para hosting, canales 24/7 y transmisiones programadas. Si tienes preguntas sobre cómo construir HLS lineal a partir de VOD, escríbenos a hello@dodocast.com.