martignage
Dokumentace

Vše, co potřebujete k ovládnutí Smart-Signage.

Od založení prvního účtu po řízení sítě 500 obrazovek: koncepty, návody, API, přehrávače.

Rychlý start

Smart-Signage je SaaS platforma. Přistupujete k ní z libovolného moderního prohlížeče. Na straně správce se nic neinstaluje. Na straně obrazovky nainstalujete přehrávač odpovídající vašemu hardwaru (web, APK pro Android, Tizen se chystá).

  1. 1

    Založte si účet

    Na my.smart-signage.app si vytvořte účet zdarma. Vaše prostředí je připravené okamžitě.

  2. 2

    Nahrajte první média

    Obrázek, video, PDF nebo webový obsah. Stačí přetáhnout.

  3. 3

    Sestavte seznam stop

    Přetáhněte média v požadovaném pořadí, upravte délku každé položky, přidejte přechody.

  4. 4

    Spárujte obrazovku

    Otevřete přehrávač, načtěte šestimístný PIN a obrazovka je propojená s tenantem.

  5. 5

    Publikujte

    Přiřaďte obrazovce seznam stop a vysílání se rozjede do minuty.

Klíčové koncepty

Platformu tvoří šest entit. Pochopte je jednou a využijete je všude.

Tenant
Jeden klient. Zcela odděluje média, seznamy stop, obrazovky i uživatele. Operátor (např. Smart-Signage) spravuje více tenantů z administrátorské konzole.
Uživatel & role
Owner, Admin, Editor, Operator, Viewer. Role určují, co kdo vidí a co může měnit.
Médium
Obrázek, video, PDF, URL nebo HTML šablona. Uložené na CDN s náhledem a automaticky zjištěnou délkou.
Seznam stop
Uspořádaná řada médií s délkou, přechodem, rotací a přiblížením u každé položky.
Plánování
Přiřazení seznamu stop obrazovce v daném časovém rozsahu nebo dni. Více plánů = dayparting.
Zařízení (obrazovka)
Připojený přehrávač. Identifikovaný PINem a poté tokenem. Posílá heartbeat a snímky obrazovky.

Tenanti a uživatelé

Multi-tenant

Každý tenant má vlastní média, seznamy stop a obrazovky. Uživatel patří k jednomu nebo více tenantům. Operátoři (prodejci, integrátoři) mají přes administrátorskou konzoli přístup ke všem tenantům ve svém portfoliu.

Role

RoleMédiaSeznamy stopObrazovkyFakturace
OwnerVšeVšeVšeVše
AdminVšeVšeVšeČtení
EditorVytvářet / upravovatVytvářet / upravovatPřiřazovat seznamy stop
OperatorČístČístPřiřazovat / párovat
ViewerČístČístČíst

Ověřování

Ve výchozím stavu e-mail a heslo, s obnovou hesla e-mailem. Jednotné přihlášení (SSO) je dostupné v plánu Premium.

Média a knihovna

Podporované formáty

TypFormátyMax. velikostPoznámky
ObrázekJPG, PNG, WEBP, SVG20 MBNáhled se generuje automaticky
VideoMP4 (H.264 / H.265), WEBM500 MBAutomatická rekomprese do více rozlišení
PDFPDF 1.7+50 MBPo stránkách nebo celý dokument
URLWeb (HTTPS)Iframe v sandboxu, omezené skripty
ŠablonaHTML / CSS / JS5 MBProměnné {{nazev}}, {{cena}}, {{datum}}…

Organizace

Složky, tagy, fulltextové vyhledávání. Médium je verzované: nahrazením souboru se nová verze propíše do všech seznamů stop, které jej používají. Nic nemusíte přiřazovat znovu.

Šablony a AI Studio

AI Studio vygeneruje HTML/CSS šablonu z vašeho zadání. Vizuální výsledek upravíte a technicky zdatní uživatelé mají stále přístup ke kódu.

Dostupné proměnné

<div class="promo">
  <h1>{{ nazev }}</h1>
  <p>{{ popis }}</p>
  <span class="cena">{{ cena }} Kč</span>
  <small>Platí do {{ datum_konce | date:"d MMM" }}</small>
</div>

Proměnné se definují pro každý seznam stop nebo každé vysílání. Lze je plnit i přes API (plán Premium) — hodí se realitním kancelářím, restauracím nebo dynamickým cenám.

Omezení AI Studia

  • Žádné externí skripty mimo whitelist (bezpečnost).
  • Písma přes Google Fonts nebo nahraná tenantem.
  • 2 generování / měsíc v plánu Free, 20 / měsíc v placených plánech.

Seznamy stop

Seznam stop je uspořádaná řada položek. Každá položka má délku, režim přizpůsobení (cover / contain / fill), rotaci, přiblížení a přechod.

Dostupné přechody

  • CUT — tvrdý střih (výchozí, nejplynulejší).
  • FADE — prolínačka 500 ms.
  • SLIDE — vodorovné posunutí 800 ms.

Osvědčené postupy

  • Délka obrázku: v průměru 6 až 10 s. Příliš krátce = divák nedočte. Příliš dlouho = omrzí.
  • Video: ponechte výchozí délku (= délku souboru).
  • Míchejte 70 % stálého obsahu a 30 % akcí a sezónních novinek.

Plánování a dayparting

Plánování přiřadí obrazovce seznam stop v daném časovém rozsahu. Vedle sebe může existovat více plánů seřazených podle priority.

Typy časových rozsahů

  • Časový — např. pondělí–pátek 8–11 h: seznam stop „Croissanty“.
  • Datovaný — např. 1. až 6. ledna: seznam stop „Tříkrálový koláč“ (vysoká priorita).
  • Trvalý — výchozí seznam stop, který běží mimo všechny zvláštní rozsahy.

Priorita

Když je ve stejném okamžiku aktivních více plánů, vyhrává ten s nejvyšší prioritou. Sezónní akce má přednost před týdenním programem a ten před trvalým seznamem stop. Kompletní podrobnosti — nouzové upozornění, trvalé vysílání, dálkové ovládání, videostěna — najdete v následující sekci.

Priority vysílání: co se zobrazí?

Na stejnou obrazovku může ve stejnou chvíli mířit více zdrojů: plánování, ručně spuštěné vysílání, videostěna, upozornění. Nic se nepřepíše natrvalo — jakmile prioritní zdroj skončí, předchozí se sám vrátí.

Pravidlo v jedné větě

Nouzové upozornění překryje vše; jinak se zobrazí zdroj s nejvyšší prioritou; a pokud tento zdroj řídí videostěnu, každá obrazovka ukáže svou část.

Na co se obrazovka dívá, a v jakém pořadí

  1. 1

    Je aktivní nouzové upozornění?

    Pokud ano, překryje celou obrazovku v celé síti a nic se před ně nedostane. Obsah pod ním běží dál: po zrušení upozornění se znovu objeví bez jakéhokoli zásahu.

  2. 2

    Který zdroj získá obsah?

    Každý zdroj nese prioritu 0 až 99. Vyhrává nejvyšší. Při shodě vyhrává starší — raději tedy zvyšte prioritu zdroje, který má mít přednost, než abyste na toto pořadí spoléhali.

  3. 3

    Řídí tento obsah videostěnu?

    Pokud ano, obrazovka zobrazí jen svou dlaždici, sladěnou podle sdílených hodin, aby všechny panely ukazovaly stejný obraz ve stejný okamžik. Jinak zobrazí obsah přes celou plochu.

Úrovně od nejsilnější po nejslabší

  • Nouzové upozornění — mimo pořadí: je to překryvná vrstva, ne obsah. Překryje všechny obrazovky v síti, dokud jej nezrušíte.
  • 99 · Trvalé vysílání (z karty obrazovky) — obsah vynucený na této obrazovce, na zvolenou dobu nebo až do zastavení. Předbíhá plány, aniž by je měnil.
  • 99 · Dálkové ovládání, vysílaný obsah — nahradí probíhající trvalé vysílání (jedna obrazovka má jen jeden trvalý obsah) a předbíhá plány. Zastavení se týká jen této obrazovky; ostatní obrazovky daného tlačítka běží dál.
  • 99 · Dálkové ovládání, vynucené plánování — nevytváří žádný obsah: vynutí existující plán na nejvyšší úrovni. Jeho vypnutí platí pro VŠECHNY obrazovky, na které plán míří, nejen pro tu zobrazenou.
  • 0 až 98 · Plánování — běžné vysílání: časy, dny, období platnosti. Videostěna se řídí plánem, takže soutěží na této úrovni jako ostatní.

Co si zapamatovat

  • Obrazovka zobrazuje vždy jen jeden trvalý obsah: spuštění vysílání nahradí na této obrazovce to předchozí.
  • Vaše plánování se nikdy nemění: samo se vrátí, jakmile to, co bylo před ním, skončí nebo vyprší.
  • Úroveň 99 sdílejí tři zdroje. Při shodě vyhrává starší: raději zastavte ten, který už nechcete, než abyste je vršili na sebe.
  • Nouzové upozornění je jediné, které se automaticky uplatní na celou síť — ostatní se řeší obrazovku po obrazovce.
  • Karta obrazovky zobrazuje pruh pro každý aktivní zdroj: vidíte, co se vysílá, a přímo odtud to zastavíte.

Obrazovky a párování

Spárování obrazovky

  1. 1

    Otevřete přehrávač

    Na obrazovce spusťte aplikaci Smart-Signage nebo otevřete https://player.smart-signage.app.

  2. 2

    Poznamenejte si PIN

    Zobrazí se šestimístný kód platný 10 minut.

  3. 3

    Přidejte obrazovku

    Ve Smart-Signage → Obrazovky → Přidat zadejte PIN a název obrazovky.

  4. 4

    Přiřaďte seznam stop

    Vyberte seznam stop nebo plánování. Vysílání se rozjede.

Vlastnosti obrazovky

  • Název, umístění, tenant, tagy.
  • Zjištěné rozlišení a orientace (1920×1080, 1080×1920, 4K…).
  • Naplánovaný interval úsporného režimu (např. 22–6 h).
  • Hlasitost zvuku.

Monitoring a upozornění

Heartbeat

Každý přehrávač posílá každých 30 sekund signál: verzi, stav, aktuální seznam stop, pozici v seznamu, teplotu (je-li dostupná), dobu běhu, verzi OS a poslední přehrané médium.

Snímek obrazovky

Na vyžádání nebo naplánovaně každých 5 minut. Ideální na vizuální kontrolu, že obrazovka opravdu vysílá to, co má. Ukládá se šifrovaně a po 30 dnech vyprší.

Upozornění

  • Obrazovka offline > 5 min (lze nastavit).
  • Kvóta úložiště blízko limitu.
  • Selhání vysílání (poškozené médium, nepodporovaný formát).
  • Aktualizace přehrávače k dispozici.

Kanály: e-mail, webhook a Slack/Teams přes webhook.

API a webhooky

Dostupné v plánu Premium: REST API a webhooky pro automatizaci — vytvořit médium, spustit seznam stop, přijmout událost. Přístup poskytujeme na vyžádání, token Bearer je omezený na tenanta.

Příklad: poslat bleskovou akci

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": "maison-dupont",
    "duration": 1800,
    "devices": ["bellecour-vitrine", "confluence-mur"]
  }'

Odesílané webhooky

  • device.offline — obrazovka bez heartbeatu > prahová hodnota.
  • device.online — obrazovka je zpět.
  • playlist.started / playlist.ended.
  • media.uploaded.
  • billing.threshold — překročený fakturační práh.

Bezpečnost a soulad s předpisy

  • Hosting — OVHcloud Roubaix & Štrasburk, data uložená ve Francii.
  • Šifrování — TLS 1.3 při přenosu, AES-256 v klidu, tokeny obrazovek lze okamžitě zneplatnit.
  • GDPR — DPA na vyžádání, aktuální záznamy o činnostech zpracování.
  • Zálohy — denní, uchovávané 30 dní.
  • Audit — log všech administrátorských akcí, s možností exportu.

Přehrávače

Přehrávač je aplikace běžící na obrazovce. Tři varianty pokrývají 95 % existujících zařízení.

Webový přehrávač

Chrome / Edge / Firefox / Safari ≥ 2022

  • Nulová instalace
  • Automatické aktualizace
  • Instalovatelná PWA
  • Závisí na prohlížeči
  • Nutno ošetřit úsporný režim systému
Doporučeno

Přehrávač pro Android

Android 9+ · APK podepsané Smart-Signage

  • Nativní režim kiosku
  • Odolná offline mezipaměť
  • Automatické aktualizace
  • Vyžaduje počáteční instalaci
Brzy

Přehrávač Tizen / WebOS

Profesionální TV Samsung & LG · 2024+

  • Bez externího boxu
  • Optimalizováno výrobcem
  • V beta verzi
  • Probíhá certifikace

Webový přehrávač — instalace

  1. 1

    Otevřete URL

    https://player.smart-signage.app — funguje i bez účtu.

  2. 2

    Zapněte celou obrazovku

    F11 nebo možnost „Režim kiosku na celou obrazovku“ v prohlížeči.

  3. 3

    Vypněte úsporný režim

    Systém → Napájení → Nikdy nepřepínat obrazovku do úsporného režimu.

  4. 4

    Nainstalujte jako PWA

    Nepovinné: ikona v adresním řádku → Nainstalovat. Po restartu obrazovka aplikaci otevře znovu.

  5. 5

    Spárujte

    Zadejte zobrazený PIN ve Smart-Signage.

Přehrávač pro Android — instalace

  1. 1

    Stáhněte APK

    Ze Smart-Signage → Obrazovky → Stáhnout přehrávač pro Android (podepsaný).

  2. 2

    Povolte neznámé zdroje

    Nastavení → Zabezpečení → Neznámé zdroje, po dobu instalace.

  3. 3

    Nainstalujte

    Otevřete APK ze správce souborů nebo přes ADB.

  4. 4

    Režim kiosku

    Aplikace při startu uzamkne obrazovku na Smart-Signage. Ukončení: šestimístný administrátorský kód.

  5. 5

    Spárujte

    PIN se zobrazí na obrazovce. Zadejte jej ve Smart-Signage.

Režim offline

Webový i Android přehrávač uchovávají v mezipaměti aktivní seznam stop a jeho média. Když vypadne síť:

  • Vysílání pokračuje, dokud jsou média v mezipaměti.
  • Heartbeat se zařadí do fronty a odešle po obnovení sítě.
  • Nenápadný pruh hlásí „offline už X min“ (pouze v řídicím panelu, ne na obrazovce).

Aktualizace

PřehrávačZpůsob aktualizaceFrekvence
WebAutomaticky při načtení prohlížečePrůběžně
AndroidOTA podepsaná Smart-SignageMěsíčně (bezpečnostní: mimořádně)
TizenObchod výrobceChystá se

Doporučená hardwarová konfigurace

PoužitíCPURAMÚložištěSíť
1 obrazovka Full HDARM A53 nebo x86 dvoujádro2 GB16 GBWi-Fi N nebo Ethernet
Stěna 2×2 nebo 4KARM A76 nebo x86 čtyřjádro4 GB32 GBDoporučen Ethernet
Náročné video / interaktivníx86 i3 nebo ARM A788 GB64 GB SSDGigabitový Ethernet

Nenašli jste odpověď?

Tým podpory odpovídá do 24 pracovních hodin. Běžné případy pokrývají také FAQ a průvodce podporou.