Bajo el capó
Reproductores basados en Docker, SaaS API-first, MCP para integración con IA — todo lo que tu equipo de ingeniería necesita para la evaluación.
Plataforma SaaS
media-player.app es un servicio en la nube totalmente gestionado. Sin servidor que administrar, sin instalación, sin mantenimiento. Tú te centras en tu contenido — nosotros nos encargamos de la infraestructura.
Alojado y gestionado
Docker como entorno de ejecución
Arquitectura
Cada pantalla funciona con tres contenedores Docker aislados. Se ejecuta en cualquier sistema Linux con Docker — desde Raspberry Pi hasta servidores x86. Responsabilidades claras, escalables de forma independiente y actualizables individualmente.
Agent
Plano de controlRegistro de dispositivos, gestión de tokens, descarga de contenido y programación de listas de reproducción. Proporciona una API local en el puerto 7071 para controlar el contenedor de reproducción.
Playback
Plano de reproducciónAPI local unificada en el puerto 7070. Utiliza mpv para vídeo con aceleración por hardware (DRM/KMS) y Chromium en modo quiosco para contenido web. Gestiona las transiciones entre elementos.
Heartbeat
MonitorizaciónEnvía informes de estado periódicos al backend: temperatura de CPU, carga, memoria, disco. Implementa lógica watchdog para reinicios automáticos de contenedores.
Arquitectura de almacenamiento
Mecanismo de actualización
Hardware compatible
El software del reproductor está basado en Docker y se ejecuta en cualquier sistema Linux con Docker. Optimizado para ARM64 (Raspberry Pi) y AMD64 (servidores x86, mini PCs). La compatibilidad con pantallas comerciales con SoC está planificada.
Raspberry Pi 5
RecomendadoRaspberry Pi 4
CompatibleLinux x86 / Mini-PC
CompatiblePantallas comerciales con SoC
PlanificadoMotor de reproducción
Reproducción híbrida: mpv para vídeo e imágenes con aceleración por hardware vía DRM/KMS/VAAPI, Chromium para contenido web en modo quiosco. El contenedor agent controla la reproducción a través de una API REST local.
mpv — Vídeo e imágenes
Decodificación con aceleración por hardware vía V4L2 M2M (Raspberry Pi) o VAAPI (x86). Salida de framebuffer vía DRM/KMS para mínima latencia, sin X11 ni Wayland.
Chromium — Contenido web
Chromium headless en modo quiosco para páginas HTML, dashboards y contenido interactivo. Controlado mediante Chrome DevTools Protocol (CDP).
| Formato | Códec / Decodificador | Aceleración HW | Resolución máx. |
|---|---|---|---|
| H.264 / AVC | h264_v4l2m2m | ✓ Hardware | 4K 30fps |
| H.265 / HEVC | hevc_v4l2m2m | ✓ Hardware | 4K 60fps |
| VP9 | vp9_v4l2m2m | ✓ Hardware | 4K 30fps |
| AV1 | av1 (SW) | — CPU | 1080p |
| JPEG / PNG | GPU decode | ✓ Hardware | 4K |
| HTML / CSS / JS | Chromium | — CPU | Fullscreen |
Pipeline de contenido
De la subida a la reproducción: cada archivo se verifica, versiona y sincroniza de forma atómica a los reproductores. El reproductor siempre ejecuta un estado consistente — nunca una descarga parcial.
Subida y versionado
Verificación y almacenamiento
Sincronización y activación de planes
Seguridad
Aislamiento multi-tenant, comunicación cifrada y autenticación basada en tokens. Ningún dispositivo tiene acceso a los datos de otro inquilino.
Autenticación
Aislamiento de inquilinos
Seguridad del dispositivo
Seguridad del transporte
REST API
Toda la plataforma es API-first. Todo lo que el panel puede hacer, puedes automatizarlo a través de la REST API. Documentación OpenAPI incluida.
# Obtener reproductores
GET /api/v1/players
GET /api/v1/players/{id}
GET /api/v1/players/{id}/health
# Crear contenido
POST /api/v1/media-items
POST /api/v1/playlists
POST /api/v1/channels
# Asignaciones
PUT /api/v1/playlists/{id}/items
PUT /api/v1/channels/{id}/playlists
# Autenticación
Authorization: Bearer {token}
X-Tenant-ID: {tenant_id}
Content-Type: application/jsonAPI JSON RESTful
Estructura de recursos consistente, verbos HTTP, códigos de estado estándar. Petición/respuesta en JSON.
Documentación OpenAPI 3.1
Documentación interactiva de la API generada automáticamente. Prueba los endpoints directamente en el navegador.
Paginación por cursor
Paginación eficiente para grandes conjuntos de datos. Filtrado, ordenación y búsqueda en todos los endpoints de listado.
MCP — Integración con IA
media-player.app implementa el Model Context Protocol (MCP) como superficie de integración de primera clase. Más allá de la REST API, agentes de IA, flujos de trabajo n8n y pipelines de LangChain pueden controlar la plataforma directamente.
¿Qué es MCP?
El Model Context Protocol es un estándar abierto para la comunicación entre agentes de IA y sistemas externos. En lugar de una API propietaria, cualquier cliente compatible con IA (Claude, GPT, LLMs personalizados) puede controlar la plataforma mediante herramientas, recursos y prompts.
Herramientas MCP
Casos de uso
Seguridad
Monitorización y telemetría
Cada pantalla envía datos de estado al backend a intervalos configurables. El contenedor heartbeat recopila métricas del sistema y eventos de reproducción.
| Métrica | Fuente | Intervalo |
|---|---|---|
| CPU Temperature | /sys/class/thermal | 30s |
| CPU Load | /proc/loadavg | 30s |
| Memory Usage | /proc/meminfo | 30s |
| Disk Usage | statvfs() | 60s |
| Network Latency | API ping | 60s |
| Playout Events | Playback Engine | realtime |
| Container Status | Docker API | 30s |
| Display State | HDMI / CEC | 30s |
Requisitos de red
Los reproductores necesitan una conexión a internet saliente. No es necesario abrir puertos de entrada — el reproductor se conecta al backend, no al revés.
Conexiones salientes
Ancho de banda y modo offline
De un vistazo
Plataforma SaaS
Entorno del reproductor
Plataformas
Integración
Monitorización
Seguridad
¿Convencido?
Prueba media-player.app gratis o consulta la documentación de la API.
Solo usamos tu correo para avisarte del lanzamiento. Sin spam.