Guía de programación¶
La guía de programación de Catena llega en archivos XMLTV: el operador da de alta una fuente, el servidor descarga el archivo según un calendario y guarda los programas de los canales que estén vinculados a streams. Desde ahí la guía llega a todos los consumidores a la vez — la vitrina del espectador, la ficha del canal en la consola y la exportación XMLTV para reproductores externos.
La sección de la consola es Guía de programación.
Dé de alta una fuente¶
Pulse Añadir fuente y rellene los campos:
- Nombre — cómo se llama la fuente en la consola; debe ser único en la instalación.
- URL del archivo — de dónde se descarga la exportación XMLTV. Sirve también un archivo comprimido con gzip: la compresión se detecta por el contenido, no por la extensión de la dirección.
- Actualizar cada, horas — el intervalo de la actualización programada.
- Conservar historial, días — cuánto tiempo se guardan en la base los programas pasados.
Una fuente suele cubrir muchos canales: en un proveedor es un único archivo para todo un paquete.
Vincule los streams a los canales del archivo¶
Mientras no haya ningún stream vinculado, la importación guarda el catálogo de canales del archivo, pero no los programas: no tiene sentido almacenar el horario de cuatro mil canales cuando se emiten doscientos.
La vinculación vive en los ajustes del stream, bloque Guía de programación:
- Fuente de la guía — de qué fuente sale el horario. Un stream tiene una sola.
- Canal EPG — el identificador del canal dentro de ese archivo.
Un canal EPG puede vincularse a muchos streams: la versión SD y la HD de una misma emisión comparten horario. Lo contrario no ocurre: un stream nunca tiene dos horarios, y las guías de fuentes distintas no se fusionan.
Si un canal desaparece del archivo nuevo, la vinculación se mantiene y queda marcada como Este canal EPG no está en el catálogo de la fuente. Es un estado que se muestra, no un fallo de integridad: se arregla eligiendo otro canal o devolviendo el anterior a la exportación.
Una vinculación nueva no espera a la descarga programada: el servidor reimporta la fuente por su cuenta y agrupa en una sola descarga los cambios hechos seguidos. Esa reimportación usa el archivo ya guardado; no se descarga nada otra vez.
El catálogo de canales del archivo¶
La pestaña Catálogo de canales muestra todo lo que declara el archivo, incluidos los canales que aún no usa ningún stream: el identificador, los nombres, el número de programas y las emisiones vinculadas. La búsqueda cubre a la vez nombres e identificadores — los proveedores dan varios alias por canal.
Asignación masiva¶
Emparejar por nombre empareja streams con canales del catálogo y muestra el resultado como propuesta. Una propuesta no es una decisión: solo se escriben las filas marcadas, y cada fila puede corregirse antes de pulsar Asignar.
Esta es la forma práctica de traer la guía a una instalación existente: nadie vincula doscientos streams a mano.
Qué hace una importación¶
Actualizar ahora lanza la descarga de inmediato. Tanto la actualización programada como la manual descargan el archivo de nuevo: «actualizar» nunca importa en silencio la copia de ayer.
La importación sustituye una ventana: el contenido del intervalo que describe el archivo se pone en correspondencia exacta con el archivo. Un programa que se movió se mueve, uno cancelado desaparece, y el historial fuera de la ventana no se toca. El lector ve o la guía anterior o la nueva, nunca una mezcla.
Un elemento defectuoso del archivo se omite con un aviso y no tumba la descarga entera; solo detiene el análisis un XML que no se puede leer en absoluto — por ejemplo, la página de error del proveedor en lugar de la exportación. En ese caso la guía guardada antes no cambia.
Lanzar una importación de la misma fuente mientras hay otra en curso se rechaza: la que está corriendo ni se interrumpe ni se duplica.
Historial de descargas¶
Cada fuente muestra su Última descarga, y la pestaña Historial de descargas conserva las anteriores. Los estados son:
- nunca descargada — la fuente acaba de darse de alta;
- en curso — hay una descarga en marcha y su mensaje nombra la etapa actual;
- correcta — el archivo se analizó y se escribió;
- con error — el mensaje explica la causa.
Junto al estado están los contadores: Programas (encontrados en el archivo), Guardados, Canales en el archivo, Vinculados. Ahí está la respuesta a «por qué la parrilla está vacía»: una descarga correcta con cientos de canales y cero vinculados significa que el archivo está bien y faltan las vinculaciones.
Dónde se ve la guía¶
- La vitrina del espectador — la parrilla en el botón amarillo y el catch-up de programas desde el archivo (Vitrina).
- La ficha del canal en la consola — el bloque Guía de programación con el día siguiente.
- La exportación XMLTV — el mismo catálogo para un reproductor externo (Lista M3U y XMLTV).
La guía siempre se lee por ventana: ambos límites son obligatorios, y el intervalo y la longitud de la lista están acotados — no más de 7 días y 200 emisiones por petición. Una petición más amplia se rechaza nombrando el límite, en lugar de recortarse en silencio.
El espectador recibe solo sus canales: la fórmula de acceso se aplica antes de leer la guía, y un canal fuera de sus paquetes no aparece en la respuesta aunque se lo nombre explícitamente.
Logotipos de canal¶
La exportación declara para un canal no solo un nombre, sino también un icono. Catena lo descarga ella misma y lo guarda en bytes: la dirección del proveedor no aparece en la respuesta; de lo contrario, cada lector —incluido el televisor del espectador, que no tiene salida a ninguna otra red— tendría que ir a buscar esa imagen fuera.
En la ficha del canal el logotipo y el nombre se proponen, no se aplican solos: el nombre y la imagen propios del operador no se pisan con una importación. Si el canal no tiene stream asignado, no hay nada que proponer: el logotipo se busca por la cadena «stream → vinculación → canal del archivo».
Cómo leer una parrilla vacía¶
De arriba abajo:
- La descarga terminó con error — lea el mensaje: lo más habitual es que la dirección sirva una página de error o pida autorización en lugar de la exportación.
- La descarga fue correcta y hay cero vinculados — vincule los streams, a mano o con la asignación masiva.
- Hay vinculación y no hay programas — compruebe que el canal del catálogo tenga un número de programas distinto de cero: el proveedor pudo entregar el archivo sin ese canal.
- Hay programas y la vitrina está vacía — compruebe que el canal de catena apunte a ese stream: la guía se direcciona por emisión, y un canal sin stream no tiene horario.
Qué sigue¶
- Vitrina — la guía tal como la ve el espectador.
- Lista M3U y XMLTV — la guía exportada para reproductores externos.
- Canales — cómo se une un canal de catena a un stream.