Smart-SignageSmart-Signage
Dokumentacja

Wszystko, czego potrzeba, by opanować Smart-Signage.

Od założenia pierwszego konta po zarządzanie parkiem 500 ekranów: pojęcia, przewodniki, API, odtwarzacze.

Szybki start

Smart-Signage to platforma SaaS. Masz do niej dostęp z dowolnej nowoczesnej przeglądarki. Żadnej instalacji po stronie zarządzającego. Po stronie ekranu instalujesz odtwarzacz dopasowany do sprzętu (web, APK Android, wkrótce Tizen).

  1. 1

    Załóż konto

    Na my.smart-signage.app załóż darmowe konto. Twoja przestrzeń jest gotowa natychmiast.

  2. 2

    Wgraj pierwsze media

    Obraz, wideo, PDF lub kanał web. Przeciągnij i upuść, to wszystko.

  3. 3

    Ułóż playlistę

    Przeciągnij media w kolejności, ustaw czas trwania dla każdego elementu, dodaj przejścia.

  4. 4

    Sparuj ekran

    Otwórz odtwarzacz, zeskanuj 6-cyfrowy kod PIN, jest on powiązany z najemcą.

  5. 5

    Opublikuj

    Przypisz playlistę do ekranu, emisja rusza w ciągu minuty.

Kluczowe pojęcia

Sześć podmiotów strukturyzuje platformę. Zrozum je raz, przydadzą się wszędzie.

Najemca (Tenant)
Klient. Całkowicie izoluje media, playlisty, ekrany i użytkowników. Operator (np. Smart-Signage) zarządza wieloma najemcami z konsoli administracyjnej.
Użytkownik & rola
Owner, Admin, Editor, Operator, Viewer. Role określają, co widać i co można zmieniać.
Medium
Obraz, wideo, PDF, URL lub szablon HTML. Przechowywane na CDN z miniaturą i automatycznie wykrytym czasem trwania.
Playlista
Uporządkowana sekwencja mediów z czasem trwania, przejściem, rotacją i przybliżeniem dla każdego elementu.
Harmonogram
Przypisanie playlisty do ekranu na przedziale godzinowym lub konkretnym dniu. Wiele harmonogramów = dayparting.
Device (ekran)
Podłączony odtwarzacz. Identyfikowany kodem PIN, następnie tokenem. Przesyła heartbeat i zrzut ekranu.

Najemcy i użytkownicy

Wielo-najemczość

Każdy najemca ma własne media, playlisty i ekrany. Użytkownik należy do jednego lub kilku najemców. Operatorzy (resellerzy, integratorzy) mają dostęp do wszystkich najemców w swoim portfolio przez konsolę administracyjną.

Role

RolaMediaPlaylistyEkranyRozliczenia
OwnerWszystkoWszystkoWszystkoWszystko
AdminWszystkoWszystkoWszystkoOdczyt
EditorTwórz / edytujTwórz / edytujPrzypisuj playlisty
OperatorOdczytOdczytPrzypisuj / paruj
ViewerOdczytOdczytOdczyt

Uwierzytelnianie

Domyślnie e-mail / hasło, z możliwością resetu przez e-mail. Jednokrotne logowanie (SSO) dostępne w ofercie Premium.

Media i biblioteka

Obsługiwane formaty

TypFormatyMaks. rozmiarUwagi
ObrazJPG, PNG, WEBP, SVG20 MBMiniatura generowana automatycznie
WideoMP4 (H.264 / H.265), WEBM500 MBAutomatyczna rekompresja wielorozdzielczościowa
PDFPDF 1.7+50 MBStrona po stronie lub cały dokument
URLWeb (HTTPS)Iframe w piaskownicy, ograniczone skrypty
SzablonHTML / CSS / JS5 MBZmienne {{nazwa}}, {{cena}}, {{data}}…

Organizacja

Foldery, tagi, wyszukiwanie pełnotekstowe. Medium jest wersjonowane: zastąpienie pliku propaguje nową wersję do wszystkich playlist, które go używają. Bez potrzeby ponownego przypisywania.

Szablony i Studio IA

Studio IA generuje szablon HTML/CSS na podstawie Twojego briefu. Edytujesz wynik wizualny, kod pozostaje dostępny dla profili technicznych.

Dostępne zmienne

<div class="promo">
  <h1>{{ tytul }}</h1>
  <p>{{ opis }}</p>
  <span class="cena">{{ cena }} €</span>
  <small>Ważne do {{ data_konca | date:"d MMM" }}</small>
</div>

Zmienne są definiowane dla playlisty lub emisji. Możesz je też zasilać przez API (oferta Premium) — przydatne dla agencji nieruchomości, restauracji, cen dynamicznych.

Ograniczenia Studio IA

  • Brak zewnętrznych skryptów spoza listy dozwolonych (bezpieczeństwo).
  • Czcionki przez Google Fonts lub wgranie własnych przez najemcę.
  • 2 generacje / mies. w Free, 20 / mies. w planach płatnych.

Playlisty

Playlista to uporządkowana sekwencja elementów. Każdy element ma czas trwania, tryb dopasowania (cover / contain / fill), rotację, przybliżenie i przejście.

Dostępne przejścia

  • CUT — cięcie na sucho (domyślne, najbardziej płynne).
  • FADE — przenikanie 500 ms.
  • SLIDE — przesunięcie poziome 800 ms.

Dobre praktyki

  • Czas trwania obrazu: średnio 6–10 s. Za krótko = niepełne odczytanie. Za długo = znużenie.
  • Wideo: zostaw domyślny czas trwania (= długość pliku).
  • Mieszaj 70% treści stałych + 30% promocji / sezonowych.

Harmonogram i dayparting

Harmonogram przypisuje playlistę do ekranu w przedziale godzinowym. Kilka harmonogramów może współistnieć według kolejności priorytetu.

Rodzaje przedziałów

  • Godzinowy — np. poniedziałek-piątek 8:00-11:00: playlista „Rogaliki”.
  • Z datą — np. od 1 do 6 stycznia: playlista „Ciasto Trzech Króli” (wysoki priorytet).
  • Stały — playlista domyślna, odtwarzana poza wszelkimi specjalnymi przedziałami.

Priorytet

Gdy kilka harmonogramów jest aktywnych w tym samym momencie, wygrywa najwyższy priorytet. Promocja sezonowa ma pierwszeństwo przed harmonogramem tygodniowym, który ma pierwszeństwo przed playlistą stałą.

Ekrany i parowanie

Sparuj ekran

  1. 1

    Otwórz odtwarzacz

    Na ekranie uruchom aplikację Smart-Signage lub otwórz https://player.smart-signage.app.

  2. 2

    Zanotuj PIN

    Wyświetli się 6-cyfrowy kod, ważny 10 minut.

  3. 3

    Dodaj ekran

    W Smart-Signage → Ekrany → Dodaj, wpisz PIN i nazwę ekranu.

  4. 4

    Przypisz playlistę

    Wybierz playlistę lub harmonogram. Emisja się rozpoczyna.

Właściwości ekranu

  • Nazwa, lokalizacja, najemca, tagi.
  • Wykryta rozdzielczość i orientacja (1920×1080, 1080×1920, 4K…).
  • Zaplanowany przedział trybu uśpienia (np. 22:00-6:00).
  • Głośność dźwięku.

Monitoring i alerty

Heartbeat

Każdy odtwarzacz wysyła sygnał co 30 sekund: wersję, status, aktualną playlistę, pozycję w playliście, temperaturę (jeśli dostępna), czas działania, wersję OS, ostatnio odtworzone medium.

Zrzut ekranu

Na żądanie lub zaplanowany co 5 minut. Idealny do wizualnej weryfikacji, że ekran faktycznie wyświetla to, co powinien. Przechowywany zaszyfrowany, wygasa po 30 dniach.

Alerty

  • Ekran offline > 5 min (konfigurowalne).
  • Limit pamięci bliski wyczerpania.
  • Błąd emisji (uszkodzone medium, nieobsługiwany format).
  • Aktualizacja odtwarzacza dostępna.

Kanał: e-mail. Webhooki dostępne z API w ofercie Premium.

API i webhooki

Dostępne w ofercie Premium: REST API + webhooki do automatyzacji — tworzenie medium, uruchamianie playlisty, odbieranie zdarzenia. Dostęp udzielany na życzenie, token Bearer w zakresie najemcy.

Przykład: wypchnij promocję błyskawiczną

curl -X POST https://my.smart-signage.app/api/v1/playlists/promo-flash/activate \
  -H "Authorization: Bearer $SMARTSIGNAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "piekarnia-dupont",
    "duration": 1800,
    "devices": ["bellecour-witryna", "confluence-sciana"]
  }'

Emitowane webhooki

  • device.offline — ekran bez heartbeatu > próg.
  • device.online — ekran wrócił.
  • playlist.started / playlist.ended.
  • media.uploaded.
  • billing.threshold — przekroczony próg rozliczeniowy.

Bezpieczeństwo i zgodność

  • Hosting — OVHcloud Roubaix & Strasburg, dane przechowywane we Francji.
  • Szyfrowanie — TLS 1.3 w transmisji, AES-256 w spoczynku, tokeny ekranu odwoływalne natychmiast.
  • RODO — DPA dostępne na żądanie, aktualny rejestr czynności przetwarzania.
  • Kopie zapasowe — codzienne, przechowywane 30 dni.
  • Audyt — log wszystkich działań administracyjnych, możliwy do wyeksportowania.

Odtwarzacze

Odtwarzacz to aplikacja działająca na ekranie. Trzy warianty pokrywające 95% istniejącego parku.

Odtwarzacz Web

Chrome / Edge / Firefox / Safari ≥ 2022

  • Zero instalacji
  • Automatyczne aktualizacje
  • Instalowalna PWA
  • Zależny od przeglądarki
  • Tryb uśpienia systemu do zarządzania
Zalecane

Odtwarzacz Android

Android 9+ · APK podpisane przez Smart-Signage

  • Natywny tryb kiosku
  • Solidna pamięć podręczna offline
  • Auto-aktualizacja
  • Wymaga początkowej instalacji
Wkrótce

Odtwarzacz Tizen / WebOS

TV profesjonalne Samsung & LG · 2024+

  • Bez zewnętrznej przystawki
  • Zoptymalizowany przez producenta
  • W wersji beta
  • Certyfikacja w toku

Odtwarzacz Web — instalacja

  1. 1

    Otwórz URL

    https://player.smart-signage.app — działa bez konta.

  2. 2

    Włącz pełny ekran

    F11 lub opcja „Pełny ekran kiosku” przeglądarki.

  3. 3

    Wyłącz uśpienie

    System → Zasilanie → Nigdy nie usypiaj (ekran).

  4. 4

    Zainstaluj jako PWA

    Opcjonalnie: ikona w pasku adresu → Zainstaluj. Ekran otworzy aplikację ponownie po restarcie.

  5. 5

    Sparuj

    Wpisz PIN wyświetlony w Smart-Signage.

Odtwarzacz Android — instalacja

  1. 1

    Pobierz APK

    Z Smart-Signage → Ekrany → Pobierz odtwarzacz Android (podpisany).

  2. 2

    Zezwól na nieznane źródła

    Ustawienia → Bezpieczeństwo → Nieznane źródła, na czas instalacji.

  3. 3

    Zainstaluj

    Otwórz APK z menedżera plików lub przez ADB.

  4. 4

    Tryb kiosku

    Aplikacja blokuje ekran na Smart-Signage przy starcie. Aby wyjść: 6-cyfrowy kod administratora.

  5. 5

    Sparuj

    PIN pojawia się na ekranie. Wpisz go po stronie Smart-Signage.

Tryb offline

Odtwarzacze Web i Android przechowują w pamięci podręcznej aktywną playlistę i jej media. Jeśli sieć padnie:

  • Emisja trwa dalej, dopóki media są w pamięci podręcznej.
  • Heartbeat trafia do kolejki i jest wysyłany po powrocie sieci.
  • Dyskretny baner sygnalizuje „offline od Xmin” (tylko na panelu, nie na ekranie).

Aktualizacje

OdtwarzaczTryb aktualizacjiCzęstotliwość
WebAutomatycznie po przeładowaniu przeglądarkiCiągła
AndroidOTA podpisane przez Smart-SignageMiesięczna (bezpieczeństwo: ad hoc)
TizenSklep producentaWkrótce

Zalecana konfiguracja sprzętowa

ZastosowanieCPURAMPamięćSieć
1 ekran Full HDARM A53 lub x86 dual-core2 GB16 GBWi-Fi N lub Ethernet
Ściana 2×2 lub 4KARM A76 lub x86 quad-core4 GB32 GBZalecany Ethernet
Ciężkie wideo / interaktywnex86 i3 lub ARM A788 GB64 GB SSDEthernet Gigabit

Nie znalazłeś odpowiedzi?

Zespół wsparcia odpowiada w ciągu 24 godzin roboczych. Poza tym FAQ i przewodnik wsparcia pokrywają najczęstsze przypadki.