Smart-SignageSmart-Signage
Documentação

Tudo o que precisa para dominar a Smart-Signage.

Da criação da sua primeira conta à gestão de um parque de 500 ecrãs: conceitos, guias, API, players.

Início rápido

A Smart-Signage é uma plataforma SaaS. Acede-se a partir de qualquer navegador recente. Nenhuma instalação do lado do gestor. Do lado do ecrã, instala-se o player adaptado ao seu equipamento (web, APK Android, Tizen brevemente).

  1. 1

    Crie a sua conta

    Em my.smart-signage.app, crie a sua conta gratuita. O seu espaço fica pronto de imediato.

  2. 2

    Carregue os seus primeiros média

    Imagem, vídeo, PDF ou feed web. Arraste e largue, é tudo.

  3. 3

    Componha uma playlist

    Arraste os média pela ordem, ajuste a duração por item, adicione transições.

  4. 4

    Emparelhe o seu ecrã

    Abra o player, digitalize o código PIN de 6 dígitos, fica ligado ao tenant.

  5. 5

    Publique

    Atribua a playlist ao ecrã, a transmissão arranca em menos de um minuto.

Conceitos chave

Seis entidades estruturam a plataforma. Compreenda-as uma vez, servem em todo o lado.

Tenant
Um cliente. Isola totalmente média, playlists, ecrãs e utilizadores. Um operador (ex. Smart-Signage) gere vários tenants a partir da consola de administração.
Utilizador & função
Owner, Admin, Editor, Operator, Viewer. As funções determinam o que se vê e o que se pode modificar.
Média
Imagem, vídeo, PDF, URL ou modelo HTML. Armazenado no CDN com miniatura e duração detetadas automaticamente.
Playlist
Sequência ordenada de média com duração, transição, rotação e zoom por item.
Planeamento
Atribuição de uma playlist a um ecrã, num intervalo horário ou num dia determinado. Vários planeamentos = dayparting.
Dispositivo (ecrã)
Um player conectado. Identificado por um PIN e depois um token. Envia heartbeat + captura de ecrã.

Tenants & utilizadores

Multi-tenant

Cada tenant tem os seus próprios média, playlists e ecrãs. Um utilizador pertence a um ou vários tenants. Os operadores (revendedores, integradores) acedem a todos os tenants da sua carteira através da consola de administração.

Funções

FunçãoMédiaPlaylistsEcrãsFaturação
OwnerTudoTudoTudoTudo
AdminTudoTudoTudoLeitura
EditorCriar / editarCriar / editarAtribuir playlists
OperatorLerLerAtribuir / emparelhar
ViewerLerLerLer

Autenticação

Email / palavra-passe por defeito, com reposição por email. Autenticação única (SSO) disponível na oferta Premium.

Média & biblioteca

Formatos suportados

TipoFormatosTamanho máx.Notas
ImagemJPG, PNG, WEBP, SVG20 MBMiniatura gerada automaticamente
VídeoMP4 (H.264 / H.265), WEBM500 MBRecompressão automática multi-resolução
PDFPDF 1.7+50 MBPágina a página ou documento completo
URLWeb (HTTPS)Iframe isolado (sandbox), scripts limitados
ModeloHTML / CSS / JS5 MBVariáveis {{nome}}, {{preço}}, {{data}}…

Organização

Pastas, tags, pesquisa full-text. Um média é versionado: substituir o ficheiro propaga a nova versão a todas as playlists que o utilizam. Sem necessidade de reatribuir.

Modelos & Studio IA

O Studio IA gera um modelo HTML/CSS a partir do seu briefing. Você edita o resultado visual, o código mantém-se acessível para os perfis técnicos.

Variáveis disponíveis

<div class="promo">
  <h1>{{ titulo }}</h1>
  <p>{{ descricao }}</p>
  <span class="preco">{{ preco }} €</span>
  <small>Válido até {{ data_fim | date:"d MMM" }}</small>
</div>

As variáveis são definidas por playlist ou por transmissão. Também podem ser alimentadas via API (oferta Premium) — útil para agências imobiliárias, restaurantes, preços dinâmicos.

Limites do Studio IA

  • Sem scripts externos não autorizados (segurança).
  • Fontes via Google Fonts ou carregamento pelo tenant.
  • 2 gerações / mês no Free, 20 / mês nas ofertas pagas.

Playlists

Uma playlist é uma sequência ordenada de itens. Cada item tem uma duração, um modo de ajuste (cover / contain / fill), uma rotação, um zoom e uma transição.

Transições disponíveis

  • CUT — corte seco (por defeito, o mais fluido).
  • FADE — dissolução encadeada de 500ms.
  • SLIDE — deslizamento horizontal de 800ms.

Boas práticas

  • Duração de imagem: 6 a 10 s em média. Demasiado curto = leitura incompleta. Demasiado longo = cansaço.
  • Vídeo: deixe a duração por defeito (= duração do ficheiro).
  • Combine 70 % de conteúdos estáveis + 30 % de promoção / sazonal.

Planeamento & dayparting

O planeamento atribui uma playlist a um ecrã num intervalo horário. Vários planeamentos podem coexistir por ordem de prioridade.

Tipos de intervalo

  • Horário — ex. segunda-sexta 8h-11h: playlist « Croissants ».
  • Com data — ex. de 1 a 6 de janeiro: playlist « Bolo-Rei » (prioridade alta).
  • Permanente — playlist por defeito, reproduzida fora de qualquer intervalo especial.

Prioridade

Quando vários planeamentos estão ativos no mesmo instante, a prioridade mais alta prevalece. A promoção sazonal prevalece sobre a programação semanal, que prevalece sobre a playlist permanente.

Ecrãs & emparelhamento

Emparelhar um ecrã

  1. 1

    Abra o player

    No ecrã, inicie a app Smart-Signage ou abra https://player.smart-signage.app.

  2. 2

    Anote o PIN

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

  3. 3

    Adicione o ecrã

    Em Smart-Signage → Ecrãs → Adicionar, introduza o PIN e o nome do ecrã.

  4. 4

    Atribua uma playlist

    Selecione a playlist ou o planeamento. A transmissão arranca.

Propriedades de um ecrã

  • Nome, localização, tenant, tags.
  • Resolução e orientação detetadas (1920×1080, 1080×1920, 4K…).
  • Intervalo de suspensão programado (ex. 22h-6h).
  • Volume de áudio.

Monitorização & alertas

Heartbeat

Cada player envia um sinal a cada 30 segundos: versão, estado, playlist em curso, posição na playlist, temperatura (se disponível), uptime, versão do SO, último média reproduzido.

Captura de ecrã

A pedido ou programada a cada 5 minutos. Ideal para verificar visualmente que um ecrã transmite bem o que deve. Armazenada cifrada, expira em 30 dias.

Alertas

  • Ecrã offline > 5 min (configurável).
  • Quota de armazenamento perto do limite.
  • Falha de transmissão (média corrompido, formato não suportado).
  • Atualização do player disponível.

Canal: email. Webhooks disponíveis com a API da oferta Premium.

API & webhooks

Disponível na oferta Premium: uma API REST + webhooks para automatizar — criar um média, ativar uma playlist, receber um evento. Acesso fornecido a pedido, token Bearer delimitado por tenant.

Exemplo: lançar uma promoção relâmpago

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

Webhooks emitidos

  • device.offline — ecrã sem heartbeat > limite.
  • device.online — ecrã de volta.
  • playlist.started / playlist.ended.
  • media.uploaded.
  • billing.threshold — patamar de faturação ultrapassado.

Segurança & conformidade

  • Alojamento — OVHcloud Roubaix & Estrasburgo, dados armazenados em França.
  • Cifragem — TLS 1.3 em trânsito, AES-256 em repouso, tokens de ecrã revogáveis instantaneamente.
  • RGPD — DPA disponível a pedido, registo de tratamentos atualizado.
  • Cópias de segurança — diárias, mantidas 30 dias.
  • Auditoria — registo de todas as ações de administração, exportável.

Players

O player é a aplicação que corre no ecrã. Três variantes para cobrir 95 % do parque existente.

Player Web

Chrome / Edge / Firefox / Safari ≥ 2022

  • Zero instalação
  • Atualizações automáticas
  • PWA instalável
  • Depende do navegador
  • Suspensão do sistema a gerir
Recomendado

Player Android

Android 9+ · APK assinado Smart-Signage

  • Modo quiosque nativo
  • Cache offline robusta
  • Auto-atualização
  • Requer instalação inicial
Brevemente

Player Tizen / WebOS

TV profissional Samsung & LG · 2024+

  • Sem box externa
  • Otimizado pelo fabricante
  • Em beta
  • Certificação em curso

Player Web — instalação

  1. 1

    Abra o URL

    https://player.smart-signage.app — funciona sem conta.

  2. 2

    Ative o ecrã inteiro

    F11 ou opção « Ecrã inteiro quiosque » do navegador.

  3. 3

    Desative a suspensão

    Sistema → Alimentação → Nunca suspender (ecrã).

  4. 4

    Instale como PWA

    Opcional: ícone da barra de endereço → Instalar. O ecrã reabre a app ao reiniciar.

  5. 5

    Emparelhe

    Introduza o PIN exibido em Smart-Signage.

Player Android — instalação

  1. 1

    Descarregue o APK

    A partir de Smart-Signage → Ecrãs → Descarregar o player Android (assinado).

  2. 2

    Autorize fontes desconhecidas

    Definições → Segurança → Fontes desconhecidas, durante a instalação.

  3. 3

    Instale

    Abra o APK a partir do gestor de ficheiros ou via ADB.

  4. 4

    Modo quiosque

    A app bloqueia o ecrã na Smart-Signage no arranque. Para sair: código de administração de 6 dígitos.

  5. 5

    Emparelhe

    O PIN é exibido no ecrã. Introduza-o do lado da Smart-Signage.

Modo offline

Os players Web e Android mantêm em cache a playlist ativa e os seus média. Se a rede cair:

  • A transmissão continua enquanto os média estiverem em cache.
  • O heartbeat fica em fila de espera e é enviado no regresso da rede.
  • Uma faixa discreta assinala « offline há Xmin » (apenas no painel, não no ecrã).

Atualizações

PlayerModo de atualizaçãoCadência
WebAutomática ao recarregar navegadorContínua
AndroidOTA assinada Smart-SignageMensal (segurança: pontual)
TizenLoja do fabricanteBrevemente

Configuração de hardware recomendada

UsoCPURAMArmazenamentoRede
1 ecrã Full HDARM A53 ou x86 dual-core2 GB16 GBWifi N ou Ethernet
Mural 2×2 ou 4KARM A76 ou x86 quad-core4 GB32 GBEthernet recomendado
Vídeo pesado / interativox86 i3 ou ARM A788 GB64 GB SSDEthernet Gigabit

Não encontrou a sua resposta?

A equipa de suporte responde em 24h úteis. Caso contrário, a FAQ e o guia de suporte cobrem os casos comuns.

Guia de suporte FAQ