Estas guías asignan los conceptos de un sector a los objetos que la plataforma tiene hoy (bouquets, líneas, paquetes, cuentas de socio, nodos, la API). Son correspondencias conceptuales, no funciones específicas de un sector, y una cuenta de socio es una cuenta delegada, no un inquilino aislado.
Correspondencia conceptual
Nada en el panel se llama sala ni socio. La tabla indica qué objeto cumple cada papel; los capítulos siguientes los configuran en ese orden.
| En tu sector | En la plataforma | Dónde en el panel |
|---|---|---|
| Película de la exposición y archivo | Catálogo VOD: películas y series con temporadas y episodios, categorías y metadatos | Movies y Series, o la tarea de ingesta VOD |
| Emisión de inauguración o conferencia | Canal en directo: un stream con sus fuentes, EPG y formatos de salida | Streams → añadir un stream en directo (URL de origen o envío RTMP) |
| Colección de salas o de socios | Bouquet: un conjunto con nombre de canales, películas o series que concede un paquete | Bouquets, a partir de Streams y Movies / Series |
| Acceso de visitante o de socio | Línea: un acceso con su paquete, bouquets, caducidad, límite de conexiones y salidas | Lines → añadir, o códigos de activación, o la Reseller API |
| Periodo de afiliación | Fecha de caducidad de la línea, renovada mediante un paquete, un crédito o la API | La fecha de caducidad de la línea y la duración del paquete |
| Dispositivos por socio | Conexiones máximas de la línea: cuántos dispositivos pueden ver a la vez | Las conexiones máximas de la línea |
Requisitos previos
Lo que debes tener antes de instalar.
- Un servidor en el edificio (Ubuntu 22.04 o 24.04), el instalador y la red de las salas que usarán las pantallas y los dispositivos de los socios.
- La película de la exposición, las grabaciones de archivo de las que tengas los derechos, un codificador para el salón de actos y las pantallas o reproductores multimedia para las salas.
- La clave de licencia y, si el edificio no tiene internet, el procedimiento de activación sin conexión; y una decisión sobre quién en taquilla vende las membresías.
Despliegue de la infraestructura
El servidor en el edificio, activado in situ.
- Ejecuta el instalador en el servidor y define la URL base de reproducción como la dirección a la que accede la red de las salas.
- Activa la clave de licencia sin conexión desde el panel; tras la activación el servicio funciona en la red local sin internet.
- Añade la película de la exposición en Películas y la señal del salón de actos en Emisiones, y compruébalas en el reproductor web.
- Para una segunda sede o un programa público grande, registra un nodo desde Servidores; el panel lo instala por SSH y dirige a él a los espectadores de esa sede.
Organización del contenido
Salas, archivo y colecciones para socios.
- Crea categorías por exposición y por año, y una serie para un ciclo de conferencias con un episodio por charla.
- Crea un bouquet para las pantallas de las salas y otro para la biblioteca de charlas y películas de archivo de los socios.
- Crea un paquete para las salas y uno por tipo de membresía, cada uno con sus bouquets; la duración del paquete de membresía es el periodo de la membresía.
- Añade carteles y descripciones breves a cada película para que la biblioteca se vea bien en el reproductor.
Configuración de socios (revendedores)
La taquilla y la tienda como cuentas delegadas.
- Crea un grupo con permisos limitados a líneas y códigos de activación, sin acceso al catálogo ni a los servidores.
- Añade la taquilla, o la tienda, como revendedor con ese grupo, los paquetes de membresía y un saldo de créditos.
- Un centro cultural que gestiona varias sedes puede añadir un revendedor por sede, cada uno vendiendo membresías con su propio saldo.
Configuración del acceso de visitantes y socios
Pantallas y socios en líneas.
- Crea una línea por pantalla de sala en Líneas → añadir con el paquete de las salas y vincúlala a la dirección de la pantalla cuando la red da direcciones fijas.
- Crea códigos de activación en taquilla por cada membresía vendida; el socio introduce el código en el reproductor y la línea empieza.
- Define el máximo de conexiones por membresía como el número de dispositivos que puede usar un socio, normalmente dos.
- Entrega al socio la aplicación reproductora, una lista M3U o la dirección del reproductor web, según lo que encaje con su dispositivo.
Película de la exposición y archivo
La biblioteca a la carta.
- Sube la película de la exposición y el archivo digitalizado como películas, o ingiérelos con la tarea de ingesta VOD en la raíz multimedia.
- Añade metadatos de TMDB donde existan y escribe tú el título y la descripción del resto.
- Mantén el archivo que no es para el público solo en el bouquet de los socios y comprueba con una línea de prueba qué ve cada paquete.
Inauguraciones y conferencias
Un evento como canal en directo.
- Añade una emisión en directo para el codificador del salón de actos (envío RTMP) y colócala en el bouquet de los socios, o en el bouquet de las salas para una inauguración que se muestra en las pantallas.
- Activa catch-up para que un socio que llega tarde pueda rebobinar, y sube la grabación a la biblioteca después.
- Prueba el codificador y la emisión antes del evento con una línea de prueba, en la misma red que usará la audiencia.
Caducidad y renovación de la membresía
La membresía como validez de la línea.
- Una línea caduca al final del periodo de su paquete; una renovación en taquilla añade otro periodo.
- Desactiva una línea cuando se cancele una membresía; los códigos de activación que nunca se usaron siguen sin usarse hasta que se canjean.
- Suscribe la tienda o el sistema de membresías a los webhooks para ver las líneas que están a punto de caducar o que ya han caducado.
Integración con la tienda o el sistema de membresías
Los sistemas venden el acceso; el reproductor reproduce.
- Crea una clave de la Reseller API para la tienda o el sistema de membresías; llama a create_line, renew_line y disable_line, con un identificador de petición en cada escritura.
- Usa un conector de comercio cuando las membresías se vendan en línea; cualquier otro sistema usa la Reseller API y los webhooks.
- No hay inicio de sesión único para los espectadores: un socio entra en el reproductor con las credenciales de la línea o con el código de activación.
Consideraciones de seguridad
Mantén las colecciones donde corresponde.
- Mantén la red de las salas separada de la red de los visitantes y sirve cualquier acceso público detrás de un proxy inverso con TLS y TRUSTED_PROXIES definido.
- Inicio de sesión en dos pasos para cada cuenta del panel; la taquilla recibe un grupo de permisos limitado a líneas y códigos.
- Enlaces de reproducción firmados y con caducidad, un límite de conexiones por membresía y vinculación a dirección para las pantallas de sala.
- Activa la copia de seguridad cifrada de la base de datos con una copia externa y usa el registro de auditoría para revisar los cambios de líneas y de catálogo.
Resolución de problemas
Las primeras comprobaciones habituales.
- Una pantalla de sala está en negro: comprueba que su línea esté activada y no caducada, la vinculación a dirección de la pantalla y que el servidor sea accesible en la red de las salas.
- El código de un socio no funciona: comprueba que el código no se haya canjeado ya y que el paquete que abre siga asignado a la taquilla.
- La activación de la licencia falla sin conexión: comprueba el archivo de activación con la clave de licencia y el reloj del servidor.
- La inauguración en directo se entrecorta: comprueba la tasa de bits del codificador frente al enlace de subida y el estado de la emisión en Emisiones.