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 Enterprise.

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.

Ograniczenia Studio IA

  • Brak zewnętrznych skryptów spoza listy dozwolonych (bezpieczeństwo).
  • Czcionki przez Google Fonts lub wgranie własnych przez najemcę.
  • 3 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łą. Pełne szczegóły — alert awaryjny, emisja stała, pilot, ściana ekranów — opisano w następnej sekcji.

Priorytet emisji: co zostanie wyświetlone?

Kilka źródeł może celować w ten sam ekran w tym samym momencie: harmonogram, emisja uruchomiona ręcznie, ściana ekranów, alert. Nic nie jest kasowane na stałe — gdy tylko źródło o wyższym priorytecie się zatrzyma, poprzednie wraca samo.

Zasada w jednym zdaniu

Alert awaryjny przykrywa wszystko; poza tym wyświetla się źródło o najwyższym priorytecie; a jeśli steruje ono ścianą ekranów, każdy ekran pokazuje swoją część.

Na co patrzy ekran, po kolei

  1. 1

    Czy aktywny jest alert awaryjny?

    Jeśli tak, przykrywa cały ekran, na całym parku, i nic nie przechodzi przed niego. Treść nadal leci pod spodem: po zdjęciu alertu pojawia się z powrotem bez żadnej interwencji.

  2. 2

    Które źródło wygrywa treść?

    Każde źródło ma priorytet od 0 do 99. Wygrywa najwyższy. Przy równym priorytecie wygrywa najstarsze — lepiej więc podnieść priorytet temu, które ma mieć pierwszeństwo, niż liczyć na tę kolejność.

  3. 3

    Czy ta treść steruje ścianą ekranów?

    Jeśli tak, ekran wyświetla tylko swój kafelek ściany, zsynchronizowany ze wspólnym zegarem, aby wszystkie matryce pokazywały ten sam obraz w tej samej chwili. W przeciwnym razie wyświetla treść na pełnym ekranie.

Poziomy, od najsilniejszego do najsłabszego

  • Alert awaryjny — poza konkursem: to nakładka, a nie treść. Przykrywa wszystkie ekrany parku, dopóki go nie zdejmiesz.
  • 99 · Emisja stała (z karty ekranu) — treść narzucona na tym ekranie, na wybrany czas lub do naciśnięcia Stop. Przechodzi przed harmonogramy, nie zmieniając ich.
  • 99 · Pilot, emitowana treść — zastępuje trwającą emisję stałą (jedna treść stała na ekran) i przechodzi przed harmonogramy. Zatrzymanie dotyczy tylko tego ekranu; pozostałe ekrany przycisku działają dalej.
  • 99 · Pilot, wymuszony harmonogram — nie tworzy żadnej treści: wymusza istniejący harmonogram na maksymalnym poziomie. Wyłączenie działa na WSZYSTKIE ekrany, które ten harmonogram obejmuje, nie tylko na wyświetlany.
  • 0 do 98 · Harmonogramy — zwykła emisja: godziny, dni, daty ważności. Ścianą ekranów steruje się harmonogramem: konkuruje więc na tym poziomie, jak pozostałe.

Do zapamiętania

  • Ekran wyświetla tylko jedną treść stałą naraz: uruchomienie emisji zastępuje poprzednią na tym ekranie.
  • Twoje harmonogramy nigdy nie są zmieniane: wracają same, gdy tylko to, co było przed nimi, zostanie zatrzymane lub wygaśnie.
  • Trzy źródła dzielą poziom 99. Przy remisie wygrywa najstarsze: zatrzymaj to, którego już nie chcesz, zamiast nakładać kolejne.
  • Alert awaryjny jest jedynym, który stosuje się z urzędu do całego parku — pozostałe ustawia się ekran po ekranie.
  • Karta ekranu pokazuje pasek dla każdego aktywnego źródła: widzisz, co jest emitowane, i stamtąd to zatrzymujesz.

Zdalne sterowanie ekranem

Harmonogram obsługuje to, co zaplanowane, zdalne sterowanie — to, co nieprzewidziane. To strona internetowa, na której wybiera się treść z listy i wysyła ją na wybrany ekran. Przełączenie jest natychmiastowe: nic nie jest publikowane ponownie, nic nie zostaje nadpisane, harmonogram pozostaje w tle.

Z czego się z niego korzysta

Zdalne sterowanie otwiera się w przeglądarce, na komputerze, tablecie lub telefonie — nie trzeba instalować żadnej aplikacji. Istnieje też wersja na smartwatch (Wear OS), z tymi samymi przyciskami, aby przejąć kontrolę bez wyjmowania telefonu.

Wybór jednego ekranu lub całej strefy

Ekrany grupuje się w platformie za pomocą Tagów: miejsce (hala północna, recepcja), rola (ekrany witrynowe, ekrany kasowe) lub oddział. Przycisk zdalnego sterowania celuje w Tag, a treść trafia na wszystkie ekrany grupy w ramach jednej operacji. Ten podział przygotowuje się raz, przy instalacji floty urządzeń; potem wystarczy wybrać strefę, a następnie komunikat.

Co umieszcza się na pilocie

  • Wyemitować treść — trafia na wszystkie ekrany Tagu i przechodzi przed harmonogramy, na wybrany czas albo aż do zatrzymania.
  • Wymusić istniejący harmonogram — przycisk nie tworzy żadnej treści: podnosi już działający harmonogram na najwyższy poziom priorytetu.
  • Zrobić zdjęcie i je wyemitować — zdjęcie zrobione telefonem pojawia się natychmiast na ekranach strefy.
  • Zmienić zmienną — pole do zmiany wartości w szablonie, na przykład ceny dnia, bez otwierania platformy.
  • Tytuł sekcji — zwykły separator, aby uporządkować przyciski według kategorii.

Oddanie kontroli

Drugie naciśnięcie przycisku lub upływ wybranego czasu zdejmuje nadpisanie: ekran sam wraca do swoich harmonogramów, a nic nie zostało zmienione. Uwaga na zasięg zatrzymania — z karty ekranu zwalniasz tylko ten jeden, pozostałe ekrany przycisku działają dalej, natomiast wyłączenie wymuszonego harmonogramu dotyczy wszystkich ekranów, które ten harmonogram obejmuje.

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.

Sale konferencyjne: Microsoft 365 i Google Workspace

Tablet przy drzwiach sali pokazuje kalendarz tej sali: wolna czy zajęta, trwające spotkanie, następne. Kalendarz Twojej organizacji pozostaje źródłem prawdy — nikt nie wprowadza tej samej rezerwacji dwa razy, a to, co widać przy drzwiach, jest dokładnie tym, co jest w kalendarzu.

Obsługiwane kalendarze

  • Microsoft 365 / Exchange Online — odczyt kalendarza sali i rezerwacja z tabletu.
  • Google Workspace — również odczyt i rezerwacja, przez konto usługi.
  • Kanał iCal (.ics) — tylko do odczytu: zajętość jest wyświetlana, ale sali nie można zarezerwować z tabletu.

Podłączenie organizacji

  1. 1

    Otwórz Ustawienia → Kalendarz

    Połączenie konfiguruje się raz, dla całej przestrzeni, a potem obowiązuje dla wszystkich sal i wszystkich tabletów.

  2. 2

    Poproś administratora o autoryzację dostępu

    Po stronie Microsoft administrator Twojego tenanta udziela uprawnienia aplikacyjnego: konfiguruje je kreator albo wpisujesz samodzielnie identyfikator tenanta, identyfikator aplikacji i sekret. Po stronie Google podajesz klucz konta usługi, z delegacją w skali domeny albo po prostu udostępniając kalendarz każdej sali temu kontu.

  3. 3

    Przetestuj połączenie

    Przycisk sprawdza dostęp i pokazuje dokładny błąd, jeśli czegoś brakuje. Dopóki test nie przejdzie, nic nie jest emitowane.

  4. 4

    Dodaj swoje sale

    Sale zadeklarowane w Microsoft 365 lub Google Workspace są wykrywane automatycznie: wystarczy dodać je jednym kliknięciem. W przeciwnym razie wpisujesz adres e-mail zasobu — albo adres URL kanału w przypadku kalendarza iCal.

  5. 5

    Przypisz każdy tablet do jego sali

    Tworzysz media typu widget «Kalendarz», wybierasz w nim salę, a następnie emitujesz to media na danym tablecie, jak każdą inną treść. Jedna sala może zasilać kilka tabletów.

Co to daje w codziennym użyciu

  • Widok zajętości — wolna czy zajęta, trwające spotkanie, następne, plan dnia lub tygodnia w zależności od wybranej prezentacji.
  • Rezerwacja na miejscu — przycisk «30 min», «60 min»… tworzy prawdziwe wydarzenie w kalendarzu sali, od razu widoczne dla wszystkich. Proponowane czasy trwania są konfigurowalne.
  • Zwolnienie sali — jeśli trwające spotkanie zarezerwowano z tabletu, przycisk pozwala zakończyć je wcześniej i oddać termin. Spotkania utworzone w kalendarzu nigdy nie są ruszane.
  • Wszystkie tablety zgodne — rezerwacja zrobiona na jednym pojawia się w kilka sekund na pozostałych ekranach tej samej sali.
  • Pasek świetlny — na zgodnych tabletach salowych Philips i iiyama listwa LED zmienia kolor na zielony lub czerwony w zależności od zajętości, widoczna z daleka na korytarzu.

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 Enterprise.

API i webhooki

Smart-Signage udostępnia API REST i webhooki, aby zautomatyzować to, co tego wymaga: utworzyć medium, uruchomić playlistę, otrzymać powiadomienie o zdarzeniu. Dostęp i dokumentację techniczną udostępniamy na życzenie, w ramach oferty Enterprise. Każdy klient otrzymuje własny token, ograniczony wyłącznie do jego środowiska.

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.