Sotto il cofano
Player basati su Docker, SaaS API-first, MCP per l'integrazione AI — tutto ciò che serve al tuo team tecnico per la valutazione.
Piattaforma SaaS
media-player.app è un servizio cloud completamente gestito. Nessun server da gestire, nessuna installazione, nessuna manutenzione. Tu ti concentri sui contenuti — noi gestiamo l'infrastruttura.
Hosted e gestito
Docker come runtime
Architettura
Ogni display è alimentato da tre container Docker isolati. Funziona su qualsiasi sistema Linux con Docker — dal Raspberry Pi ai server x86. Responsabilità chiare, scalabili indipendentemente e aggiornabili singolarmente.
Agent
Piano di controlloRegistrazione dispositivo, gestione token, download contenuti e programmazione playlist. Fornisce un'API locale sulla porta 7071 per controllare il container di riproduzione.
Playback
Piano di riproduzioneAPI locale unificata sulla porta 7070. Utilizza mpv per video con accelerazione hardware (DRM/KMS) e Chromium in modalità kiosk per contenuti web. Gestisce le transizioni tra gli elementi.
Heartbeat
MonitoraggioInvia report di stato regolari al backend: temperatura CPU, carico, memoria, disco. Implementa la logica watchdog per il riavvio automatico dei container.
Architettura storage
Meccanismo di aggiornamento
Hardware supportato
Il software del player è basato su Docker e funziona su qualsiasi sistema Linux con Docker. Ottimizzato per ARM64 (Raspberry Pi) e AMD64 (server x86, mini PC). Il supporto per display commerciali con SoC è pianificato.
Raspberry Pi 5
ConsigliatoRaspberry Pi 4
SupportatoLinux x86 / Mini-PC
SupportatoDisplay commerciali con SoC
PianificatoMotore di riproduzione
Riproduzione ibrida: mpv per video e immagini con accelerazione hardware tramite DRM/KMS/VAAPI, Chromium per contenuti web in modalità kiosk. Il container agent controlla la riproduzione tramite un'API REST locale.
mpv — Video e immagini
Decodifica con accelerazione hardware tramite V4L2 M2M (Raspberry Pi) o VAAPI (x86). Output framebuffer tramite DRM/KMS per latenza minima, senza X11 o Wayland.
Chromium — Contenuti web
Chromium headless in modalità kiosk per pagine HTML, dashboard e contenuti interattivi. Controllato tramite Chrome DevTools Protocol (CDP).
| Formato | Codec / Decoder | Accelerazione HW | Risoluzione max |
|---|---|---|---|
| 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 contenuti
Dall'upload alla riproduzione: ogni file viene verificato, versionato e sincronizzato atomicamente sui player. Il player esegue sempre uno stato consistente — mai un download parziale.
Upload e versionamento
Verifica e storage
Sincronizzazione e attivazione plan
Sicurezza
Isolamento multi-tenant, comunicazione crittografata e autenticazione basata su token. Nessun dispositivo ha accesso ai dati di un altro tenant.
Autenticazione
Isolamento tenant
Sicurezza dispositivo
Sicurezza del trasporto
REST API
L'intera piattaforma è API-first. Tutto ciò che la dashboard può fare, puoi automatizzarlo tramite l'API REST. Documentazione OpenAPI inclusa.
# Recupera player
GET /api/v1/players
GET /api/v1/players/{id}
GET /api/v1/players/{id}/health
# Crea contenuto
POST /api/v1/media-items
POST /api/v1/playlists
POST /api/v1/channels
# Assegnazioni
PUT /api/v1/playlists/{id}/items
PUT /api/v1/channels/{id}/playlists
# Autenticazione
Authorization: Bearer {token}
X-Tenant-ID: {tenant_id}
Content-Type: application/jsonAPI JSON RESTful
Struttura risorse coerente, verbi HTTP, codici di stato standard. Request/response JSON.
Documentazione OpenAPI 3.1
Documentazione API interattiva generata automaticamente. Testa gli endpoint direttamente nel browser.
Paginazione a cursore
Paginazione efficiente per grandi dataset. Filtraggio, ordinamento e ricerca su tutti gli endpoint di lista.
MCP — Integrazione AI
media-player.app implementa il Model Context Protocol (MCP) come superficie di integrazione di prima classe. Oltre all'API REST, agenti AI, workflow n8n e pipeline LangChain possono controllare la piattaforma direttamente.
Cos'è MCP?
Il Model Context Protocol è uno standard aperto per la comunicazione tra agenti AI e sistemi esterni. Invece di un'API proprietaria, qualsiasi client AI-capable (Claude, GPT, LLM personalizzati) può controllare la piattaforma tramite tool, risorse e prompt.
Tool MCP
Casi d'uso
Sicurezza
Monitoraggio e telemetria
Ogni display invia dati di stato al backend a intervalli configurabili. Il container heartbeat raccoglie metriche di sistema ed eventi di riproduzione.
| Metrica | Sorgente | Intervallo |
|---|---|---|
| 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 |
Requisiti di rete
I player necessitano di una connessione internet in uscita. Non è necessario aprire porte in ingresso — il player si connette al backend, non il contrario.
Connessioni in uscita
Larghezza di banda e offline
In sintesi
Piattaforma SaaS
Player Runtime
Piattaforme
Integrazione
Monitoraggio
Sicurezza
Convinto?
Prova media-player.app gratuitamente o consulta la documentazione API.
Utilizziamo la tua email solo per informarti sul lancio. Niente spam.