Tutto ciò che serve per padroneggiare Smart-Signage.

Smart-Signage è una piattaforma SaaS. Vi si accede da qualsiasi browser recente. Nessuna installazione lato gestore. Sullo schermo, si installa il player adatto al proprio hardware (web, APK Android, Tizen in arrivo).

1. 1

   Create il vostro account

   Su my.smart-signage.app, create il vostro account gratuito. Il vostro spazio è pronto immediatamente.

2. 2

   Caricate i primi media

   Immagine, video, PDF o flusso web. Basta trascinare e rilasciare.

3. 3

   Componete una playlist

   Trascinate i media nell'ordine desiderato, regolate la durata per elemento, aggiungete transizioni.

4. 4

   Associate il vostro schermo

   Aprite il player, scansionate il codice PIN a 6 cifre, viene collegato al tenant.

5. 5

   Pubblicate

   Assegnate la playlist allo schermo, la diffusione parte entro un minuto.

Sei entità strutturano la piattaforma. Capitele una volta, servono ovunque.

Tenant

Un cliente. Isola completamente media, playlist, schermi e utenti. Un operatore (es. Smart-Signage) gestisce più tenant dalla console admin.

Utente & ruolo

Owner, Admin, Editor, Operator, Viewer. I ruoli determinano cosa si vede e cosa si può modificare.

Media

Immagine, video, PDF, URL o template HTML. Archiviato sul CDN con miniatura e durata rilevata automaticamente.

Playlist

Sequenza ordinata di media con durata, transizione, rotazione e zoom per elemento.

Palinsesto

Assegnazione di una playlist a uno schermo, su una fascia oraria o un giorno specifico. Più palinsesti = dayparting.

Device (schermo)

Un player connesso. Identificato da un PIN e poi da un token. Invia heartbeat + cattura schermo.

Multi-tenant

Ogni tenant ha i propri media, playlist e schermi. Un utente appartiene a uno o più tenant. Gli operatori (rivenditori, integratori) accedono a tutti i tenant del proprio portafoglio tramite la console admin.

Ruoli

Autenticazione

Email / password di default, con reset via email. Autenticazione unica (SSO) disponibile nell'offerta Premium.

Formati supportati

Organizzazione

Cartelle, tag, ricerca full-text. Un media è versionato: sostituire il file propaga la nuova versione a tutte le playlist che lo utilizzano. Nessuna necessità di riassegnare.

Studio IA genera un template HTML/CSS a partire dal vostro brief. Modificate il rendering visivo, il codice resta accessibile ai profili tecnici.

Variabili disponibili

<div class="promo">
  <h1>{{ titolo }}</h1>
  <p>{{ descrizione }}</p>
  <span class="prezzo">{{ prezzo }} €</span>
  <small>Valido fino al {{ data_fine | date:"d MMM" }}</small>
</div>

Le variabili sono definite per playlist o per diffusione. Possono anche essere alimentate via API (offerta Premium) — utile per agenzie immobiliari, ristoranti, prezzi dinamici.

Limiti Studio IA

• Nessuno script esterno non in whitelist (sicurezza).
• Font tramite Google Fonts o upload del tenant.
• 2 generazioni / mese in Free, 20 / mese sulle offerte a pagamento.

Una playlist è una sequenza ordinata di elementi. Ogni elemento ha una durata, una modalità di adattamento (cover / contain / fill), una rotazione, uno zoom e una transizione.

Transizioni disponibili

• CUT — taglio secco (predefinito, il più fluido).
• FADE — dissolvenza incrociata 500ms.
• SLIDE — scorrimento orizzontale 800ms.

Best practice

• Durata immagine: 6-10 s in media. Troppo corta = lettura incompleta. Troppo lunga = noia.
• Video: lasciate la durata predefinita (= durata del file).
• Mescolate il 70% di contenuti stabili + il 30% di promozioni / stagionali.

Il palinsesto assegna una playlist a uno schermo su una fascia oraria. Più palinsesti possono coesistere in ordine di priorità.

Tipi di fascia

• Oraria — es. lunedì-venerdì 8h-11h: playlist « Croissant ».
• Datata — es. dal 1° al 6 gennaio: playlist « Epifania » (priorità alta).
• Permanente — playlist predefinita, riprodotta al di fuori di ogni fascia speciale.

Priorità

Quando più palinsesti sono attivi nello stesso istante, prevale la priorità più alta. La promozione stagionale prevale sulla programmazione settimanale, che prevale sulla playlist permanente.

Associare uno schermo

1. 1

   Aprite il player

   Sullo schermo, avviate l'app Smart-Signage o aprite https://player.smart-signage.app.

2. 2

   Annotate il PIN

   Viene visualizzato un codice a 6 cifre, valido 10 minuti.

3. 3

   Aggiungete lo schermo

   In Smart-Signage → Schermi → Aggiungi, inserite il PIN e il nome dello schermo.

4. 4

   Assegnate una playlist

   Selezionate la playlist o il palinsesto. La diffusione parte.

Proprietà di uno schermo

• Nome, posizione, tenant, tag.
• Risoluzione e orientamento rilevati (1920×1080, 1080×1920, 4K…).
• Fascia di spegnimento programmata (es. 22h-6h).
• Volume audio.

Heartbeat

Ogni player invia un battito ogni 30 secondi: versione, stato, playlist in corso, posizione nella playlist, temperatura (se disponibile), uptime, versione OS, ultimo media riprodotto.

Cattura schermo

Su richiesta o programmata ogni 5 minuti. Ideale per verificare visivamente che uno schermo diffonda correttamente ciò che deve. Archiviata cifrata, scade dopo 30 giorni.

Avvisi

• Schermo offline > 5 min (configurabile).
• Quota di archiviazione vicina al limite.
• Errore di diffusione (media corrotto, formato non supportato).
• Aggiornamento player disponibile.

Canale: email. Webhook disponibili con l'API dell'offerta Premium.

Disponibile nell'offerta Premium: un'API REST + webhook per automatizzare — creare un media, attivare una playlist, ricevere un evento. Accesso fornito su richiesta, token Bearer con scope per tenant.

Esempio: pubblicare una promo flash

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"]
  }'

Webhook emessi

• device.offline — schermo senza heartbeat > soglia.
• device.online — schermo di nuovo online.
• playlist.started / playlist.ended.
• media.uploaded.
• billing.threshold — soglia di fatturazione superata.

• Hosting — OVHcloud Roubaix & Strasburgo, dati archiviati in Francia.
• Crittografia — TLS 1.3 in transito, AES-256 a riposo, token degli schermi revocabili istantaneamente.
• GDPR — DPA disponibile su richiesta, registro dei trattamenti aggiornato.
• Backup — quotidiani, conservati 30 giorni.
• Audit — log di tutte le azioni admin, esportabile.

Il player è l'applicazione che gira sullo schermo. Tre varianti per coprire il 95% del parco esistente.

Player Web — installazione

1. 1

   Aprite l'URL

   https://player.smart-signage.app — funziona senza account.

2. 2

   Attivate lo schermo intero

   F11 o l'opzione « Schermo intero kiosk » del browser.

3. 3

   Disattivate lo standby

   Sistema → Alimentazione → Non mettere mai in standby (schermo).

4. 4

   Installate come PWA

   Opzionale: icona nella barra degli indirizzi → Installa. Lo schermo riapre l'app al riavvio.

5. 5

   Associate

   Inserite il PIN mostrato in Smart-Signage.

Player Android — installazione

1. 1

   Scaricate l'APK

   Da Smart-Signage → Schermi → Scarica il player Android (firmato).

2. 2

   Autorizzate fonti sconosciute

   Impostazioni → Sicurezza → Fonti sconosciute, per il tempo dell'installazione.

3. 3

   Installate

   Aprite l'APK dal gestore file o tramite ADB.

4. 4

   Modalità kiosk

   L'app blocca lo schermo su Smart-Signage all'avvio. Per uscire: codice admin a 6 cifre.

5. 5

   Associate

   Il PIN viene mostrato sullo schermo. Inseritelo lato Smart-Signage.

Modalità offline

I player Web e Android conservano in cache la playlist attiva e i suoi media. Se la rete cade:

• La diffusione continua finché i media sono in cache.
• L'heartbeat viene messo in coda e inviato al ritorno della rete.
• Un banner discreto segnala « offline da Xmin » (solo sulla dashboard, non sullo schermo).

Aggiornamenti

Configurazione hardware consigliata