Pod maską
Odtwarzacze oparte na Dockerze, SaaS API-first, MCP do integracji z AI — wszystko, czego Twój zespół techniczny potrzebuje do oceny.
Platforma SaaS
media-player.app to w pełni zarządzana usługa chmurowa. Bez własnego serwera, bez instalacji, bez konserwacji. Ty skupiasz się na treściach — my zajmujemy się infrastrukturą.
Hostowane i zarządzane
Docker jako środowisko uruchomieniowe
Architektura
Każdy wyświetlacz jest zasilany przez trzy izolowane kontenery Docker. Działa na dowolnym systemie Linux z Dockerem — od Raspberry Pi po serwery x86. Jasny podział odpowiedzialności, niezależna skalowalność i możliwość indywidualnej aktualizacji.
Agent
Warstwa sterowaniaRejestracja urządzeń, zarządzanie tokenami, pobieranie treści i harmonogramowanie playlist. Udostępnia lokalne API na porcie 7071 do sterowania kontenerem odtwarzania.
Playback
Warstwa odtwarzaniaZunifikowane lokalne API na porcie 7070. Używa mpv do sprzętowo akcelerowanego wideo (DRM/KMS) i Chromium w trybie kiosku do treści webowych. Zarządza przejściami między elementami.
Heartbeat
MonitoringWysyła regularne raporty kondycji do backendu: temperatura CPU, obciążenie, pamięć, dysk. Implementuje logikę watchdog do automatycznego restartu kontenerów.
Architektura przechowywania
Mechanizm aktualizacji
Obsługiwane urządzenia
Oprogramowanie odtwarzacza jest oparte na Dockerze i działa na każdym systemie Linux z Dockerem. Zoptymalizowane dla ARM64 (Raspberry Pi) i AMD64 (serwery x86, mini-PC). Wsparcie dla profesjonalnych wyświetlaczy z SoC jest planowane.
Raspberry Pi 5
RekomendowanyRaspberry Pi 4
ObsługiwanyLinux x86 / Mini-PC
ObsługiwanyProfesjonalne wyświetlacze z SoC
PlanowaneSilnik odtwarzania
Hybrydowe odtwarzanie: mpv do wideo i zdjęć z akceleracją sprzętową przez DRM/KMS/VAAPI, Chromium do treści webowych w trybie kiosku. Kontener agenta steruje odtwarzaniem poprzez lokalne REST API.
mpv — Wideo i zdjęcia
Sprzętowe dekodowanie przez V4L2 M2M (Raspberry Pi) lub VAAPI (x86). Wyjście framebuffer przez DRM/KMS dla minimalnych opóźnień, bez X11 ani Wayland.
Chromium — Treści webowe
Bezgłowy Chromium w trybie kiosku do stron HTML, dashboardów i treści interaktywnych. Sterowany przez Chrome DevTools Protocol (CDP).
| Format | Kodek / Dekoder | Akceleracja sprzętowa | Maks. rozdzielczość |
|---|---|---|---|
| H.264 / AVC | h264_v4l2m2m | ✓ Sprzętowa | 4K 30fps |
| H.265 / HEVC | hevc_v4l2m2m | ✓ Sprzętowa | 4K 60fps |
| VP9 | vp9_v4l2m2m | ✓ Sprzętowa | 4K 30fps |
| AV1 | av1 (SW) | — CPU | 1080p |
| JPEG / PNG | GPU decode | ✓ Sprzętowa | 4K |
| HTML / CSS / JS | Chromium | — CPU | Fullscreen |
Pipeline treści
Od wgrania do odtworzenia: każdy plik jest weryfikowany, wersjonowany i atomowo synchronizowany z odtwarzaczami. Odtwarzacz zawsze pracuje w spójnym stanie — nigdy z częściowo pobranym plikiem.
Wgrywanie i wersjonowanie
Weryfikacja i przechowywanie
Synchronizacja planu i aktywacja
Bezpieczeństwo
Izolacja multi-tenant, szyfrowana komunikacja i uwierzytelnianie oparte na tokenach. Żadne urządzenie nie ma dostępu do danych innego tenanta.
Uwierzytelnianie
Izolacja tenantów
Bezpieczeństwo urządzeń
Bezpieczeństwo transportu
REST API
Cała platforma jest API-first. Wszystko, co można zrobić w panelu, da się zautomatyzować przez REST API. Dokumentacja OpenAPI w zestawie.
# Pobierz odtwarzacze
GET /api/v1/players
GET /api/v1/players/{id}
GET /api/v1/players/{id}/health
# Utwórz treść
POST /api/v1/media-items
POST /api/v1/playlists
POST /api/v1/channels
# Przypisania
PUT /api/v1/playlists/{id}/items
PUT /api/v1/channels/{id}/playlists
# Uwierzytelnianie
Authorization: Bearer {token}
X-Tenant-ID: {tenant_id}
Content-Type: application/jsonRESTful JSON API
Spójna struktura zasobów, metody HTTP, standardowe kody statusu. Żądania i odpowiedzi w formacie JSON.
Dokumentacja OpenAPI 3.1
Automatycznie generowana interaktywna dokumentacja API. Testuj endpointy bezpośrednio w przeglądarce.
Paginacja kursorowa
Wydajna paginacja dla dużych zbiorów danych. Filtrowanie, sortowanie i wyszukiwanie na wszystkich endpointach listowych.
MCP — Integracja z AI
media-player.app implementuje Model Context Protocol (MCP) jako pełnoprawną powierzchnię integracyjną. Oprócz REST API, agenty AI, przepływy n8n i pipeline'y LangChain mogą sterować platformą bezpośrednio.
Czym jest MCP?
Model Context Protocol to otwarty standard komunikacji między agentami AI a systemami zewnętrznymi. Zamiast zastrzeżonego API, dowolny klient z obsługą AI (Claude, GPT, własne modele LLM) może sterować platformą za pomocą narzędzi, zasobów i promptów.
Narzędzia MCP
Przypadki użycia
Bezpieczeństwo
Monitoring i telemetria
Każdy wyświetlacz wysyła dane o kondycji do backendu w konfigurowalnych odstępach czasu. Kontener heartbeat zbiera metryki systemowe i zdarzenia odtwarzania.
| Metryka | Źródło | Interwał |
|---|---|---|
| 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 |
Wymagania sieciowe
Odtwarzacze potrzebują wychodzącego połączenia internetowego. Nie trzeba otwierać żadnych portów przychodzących — odtwarzacz łączy się z backendem, nie odwrotnie.
Połączenia wychodzące
Przepustowość i tryb offline
W skrócie
Platforma SaaS
Środowisko odtwarzacza
Platformy
Integracja
Monitoring
Bezpieczeństwo
Przekonany?
Wypróbuj media-player.app za darmo lub sprawdź dokumentację API.
Twój adres e-mail wykorzystamy wyłącznie do powiadomienia o starcie. Żadnego spamu.