Smart-SignageSmart-Signage
Documentación

Todo lo necesario para dominar Smart-Signage.

Desde la creación de tu primera cuenta hasta la gestión de un parque de 500 pantallas: conceptos, guías, API, reproductores.

Inicio rápido

Smart-Signage es una plataforma SaaS. Accedes a ella desde cualquier navegador reciente. Sin instalación en el lado de gestión. En la pantalla, instalas el reproductor adaptado a tu material (web, APK Android, Tizen próximamente).

  1. 1

    Crea tu cuenta

    En my.smart-signage.app, crea tu cuenta gratuita. Tu espacio está listo de inmediato.

  2. 2

    Sube tus primeros medios

    Imagen, vídeo, PDF o feed web. Arrastra y suelta, eso es todo.

  3. 3

    Compón una playlist

    Arrastra los medios en orden, ajusta la duración por elemento, añade transiciones.

  4. 4

    Vincula tu pantalla

    Abre el reproductor, escanea el código PIN de 6 dígitos, queda vinculado a tu cuenta.

  5. 5

    Publica

    Asigna la playlist a la pantalla, la emisión arranca en un minuto.

Conceptos clave

Seis entidades estructuran la plataforma. Compréndelas una vez, sirven en todas partes.

Cliente (tenant)
Un cliente. Aísla totalmente medios, playlists, pantallas y usuarios. Un operador (ej. Smart-Signage) gestiona varios clientes desde la consola de administración.
Usuario & rol
Owner, Admin, Editor, Operator, Viewer. Los roles determinan qué se ve y qué se puede modificar.
Medio
Imagen, vídeo, PDF, URL o plantilla HTML. Almacenado en el CDN con miniatura y duración detectadas automáticamente.
Playlist
Secuencia ordenada de medios con duración, transición, rotación y zoom por elemento.
Calendario
Asignación de una playlist a una pantalla, en una franja horaria o un día concreto. Varios calendarios = franjas horarias combinadas.
Dispositivo (pantalla)
Un reproductor conectado. Identificado por un PIN y luego un token. Envía heartbeat + captura de pantalla.

Clientes y usuarios

Multi-cliente

Cada cliente tiene sus propios medios, playlists y pantallas. Un usuario pertenece a uno o varios clientes. Los operadores (revendedores, integradores) acceden a todos los clientes de su cartera a través de la consola de administración.

Roles

RolMediosPlaylistsPantallasFacturación
OwnerTodoTodoTodoTodo
AdminTodoTodoTodoLectura
EditorCrear / editarCrear / editarAsignar playlists
OperatorLeerLeerAsignar / vincular
ViewerLeerLeerLeer

Autenticación

Email / contraseña por defecto, con restablecimiento por email. Autenticación única (SSO) disponible en la oferta Premium.

Medios y biblioteca

Formatos admitidos

TipoFormatosTamaño máx.Notas
ImagenJPG, PNG, WEBP, SVG20 MBMiniatura generada automáticamente
VídeoMP4 (H.264 / H.265), WEBM500 MBRecompresión automática multi-resolución
PDFPDF 1.7+50 MBPágina a página o documento completo
URLWeb (HTTPS)Iframe en sandbox, scripts limitados
PlantillaHTML / CSS / JS5 MBVariables {{nombre}}, {{precio}}, {{fecha}}…

Organización

Carpetas, etiquetas, búsqueda de texto completo. Un medio tiene versiones: reemplazar el archivo propaga la nueva versión a todas las playlists que lo usan. No hace falta reasignar.

Plantillas y Studio IA

Studio IA genera una plantilla HTML/CSS a partir de tu brief. Tú editas el resultado visual, el código sigue accesible para los perfiles técnicos.

Variables disponibles

<div class="promo">
  <h1>{{ titulo }}</h1>
  <p>{{ descripcion }}</p>
  <span class="precio">{{ precio }} €</span>
  <small>Válido hasta el {{ fecha_fin | date:"d MMM" }}</small>
</div>

Las variables se definen por playlist o por emisión. También pueden alimentarse vía API (oferta Premium) — útil para agencias inmobiliarias, restaurantes, precios dinámicos.

Límites de Studio IA

  • Sin scripts externos no autorizados (seguridad).
  • Fuentes vía Google Fonts o subida del cliente.
  • 2 generaciones / mes en Free, 20 / mes en las ofertas de pago.

Playlists

Una playlist es una secuencia ordenada de elementos. Cada elemento tiene una duración, un modo de ajuste (cover / contain / fill), una rotación, un zoom y una transición.

Transiciones disponibles

  • CUT — corte seco (por defecto, el más fluido).
  • FADE — fundido encadenado de 500 ms.
  • SLIDE — deslizamiento horizontal de 800 ms.

Buenas prácticas

  • Duración de imagen: 6 a 10 s de media. Demasiado corto = lectura incompleta. Demasiado largo = cansancio.
  • Vídeo: deja la duración por defecto (= duración del archivo).
  • Combina un 70 % de contenidos estables + 30 % de promo / temporada.

Calendario y franjas horarias

El calendario asigna una playlist a una pantalla en una franja horaria. Varios calendarios pueden coexistir por orden de prioridad.

Tipos de franja

  • Horaria — ej. lunes-viernes 8h-11h: playlist «Croissants».
  • Con fecha — ej. del 1 al 6 de enero: playlist «Roscón de Reyes» (prioridad alta).
  • Permanente — playlist por defecto, reproducida fuera de cualquier franja especial.

Prioridad

Cuando varios calendarios están activos al mismo tiempo, gana la prioridad más alta. La promoción de temporada prevalece sobre la programación semanal, que prevalece sobre la playlist permanente.

Pantallas y vinculación

Vincular una pantalla

  1. 1

    Abre el reproductor

    En la pantalla, abre la app Smart-Signage o entra en https://player.smart-signage.app.

  2. 2

    Anota el PIN

    Aparece un código de 6 dígitos, válido durante 10 minutos.

  3. 3

    Añade la pantalla

    En Smart-Signage → Pantallas → Añadir, introduce el PIN y el nombre de la pantalla.

  4. 4

    Asigna una playlist

    Selecciona la playlist o el calendario. La emisión arranca.

Propiedades de una pantalla

  • Nombre, ubicación, cliente, etiquetas.
  • Resolución y orientación detectadas (1920×1080, 1080×1920, 4K…).
  • Franja de suspensión programada (ej. 22h-6h).
  • Volumen de audio.

Monitorización y alertas

Heartbeat

Cada reproductor envía una señal cada 30 segundos: versión, estado, playlist en curso, posición en la playlist, temperatura (si está disponible), tiempo de actividad, versión del SO, último medio reproducido.

Captura de pantalla

Bajo demanda o programada cada 5 minutos. Ideal para comprobar visualmente que una pantalla emite bien lo que debe. Almacenada cifrada, caduca a los 30 días.

Alertas

  • Pantalla sin conexión > 5 min (configurable).
  • Cuota de almacenamiento cerca del límite.
  • Fallo de emisión (medio corrupto, formato no admitido).
  • Actualización del reproductor disponible.

Canal: email. Webhooks disponibles con la API de la oferta Premium.

API y webhooks

Disponible en la oferta Premium: una API REST + webhooks para automatizar — crear un medio, activar una playlist, recibir un evento. Acceso proporcionado bajo petición, token Bearer con alcance por cliente.

Ejemplo: lanzar una promoción 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"]
  }'

Webhooks emitidos

  • device.offline — pantalla sin heartbeat > umbral.
  • device.online — pantalla de vuelta.
  • playlist.started / playlist.ended.
  • media.uploaded.
  • billing.threshold — nivel de facturación superado.

Seguridad y cumplimiento

  • Alojamiento — OVHcloud Roubaix & Estrasburgo, datos almacenados en Francia.
  • Cifrado — TLS 1.3 en tránsito, AES-256 en reposo, tokens de pantalla revocables al instante.
  • RGPD — DPA disponible bajo petición, registro de tratamientos actualizado.
  • Copias de seguridad — diarias, conservadas 30 días.
  • Auditoría — registro de todas las acciones de administración, exportable.

Reproductores

El reproductor es la aplicación que se ejecuta en la pantalla. Tres variantes para cubrir el 95 % del parque existente.

Reproductor Web

Chrome / Edge / Firefox / Safari ≥ 2022

  • Cero instalación
  • Actualizaciones automáticas
  • PWA instalable
  • Depende del navegador
  • Suspensión del sistema a gestionar
Recomendado

Reproductor Android

Android 9+ · APK firmado Smart-Signage

  • Modo kiosco nativo
  • Caché sin conexión robusta
  • Actualización automática
  • Requiere instalación inicial
Próximamente

Reproductor Tizen / WebOS

TV profesional Samsung & LG · 2024+

  • Sin dispositivo externo
  • Optimizado por el fabricante
  • En beta
  • Certificación en curso

Reproductor Web — instalación

  1. 1

    Abre la URL

    https://player.smart-signage.app — funciona sin cuenta.

  2. 2

    Activa la pantalla completa

    F11 u opción «Pantalla completa kiosco» del navegador.

  3. 3

    Desactiva la suspensión

    Sistema → Alimentación → No suspender nunca (pantalla).

  4. 4

    Instala como PWA

    Opcional: icono de la barra de direcciones → Instalar. La pantalla reabre la app al reiniciar.

  5. 5

    Vincula

    Introduce el PIN mostrado en Smart-Signage.

Reproductor Android — instalación

  1. 1

    Descarga el APK

    Desde Smart-Signage → Pantallas → Descargar el reproductor Android (firmado).

  2. 2

    Autoriza orígenes desconocidos

    Ajustes → Seguridad → Orígenes desconocidos, mientras dure la instalación.

  3. 3

    Instala

    Abre el APK desde el gestor de archivos o vía ADB.

  4. 4

    Modo kiosco

    La app bloquea la pantalla en Smart-Signage al arrancar. Para salir: código de administrador de 6 dígitos.

  5. 5

    Vincula

    El PIN se muestra en la pantalla. Introdúcelo en Smart-Signage.

Modo sin conexión

Los reproductores Web y Android conservan en caché la playlist activa y sus medios. Si la red se cae:

  • La emisión continúa mientras los medios estén en caché.
  • El heartbeat se pone en cola y se envía al volver la red.
  • Un aviso discreto indica «sin conexión desde hace Xmin» (solo en el panel, no en la pantalla).

Actualizaciones

ReproductorModo de actualizaciónFrecuencia
WebAutomática al recargar el navegadorContinua
AndroidOTA firmada Smart-SignageMensual (seguridad: ad hoc)
TizenTienda del fabricantePróximamente

Configuración de hardware recomendada

UsoCPURAMAlmacenamientoRed
1 pantalla Full HDARM A53 o x86 dual-core2 GB16 GBWifi N o Ethernet
Muro 2×2 o 4KARM A76 o x86 quad-core4 GB32 GBEthernet recomendado
Vídeo pesado / interactivox86 i3 o ARM A788 GB64 GB SSDEthernet Gigabit

¿No encuentras tu respuesta?

El equipo de soporte responde en menos de 24 h laborables. Si no, la FAQ y la guía de soporte cubren los casos habituales.

Guía de soporte FAQ