Como implantar digital signage headless que o seu agente opera

Em uma configuração headless, o plano de controle é uma API, não uma página da web. Seu agente, um script ou um job de CI faz as mesmas chamadas que uma pessoa faria no dashboard, pela CLI, pela API REST ou pelo servidor MCP remoto. O Player em cada tela baixa o que lhe mandam reproduzir, reproduz a partir do armazenamento local e informa de volta: o que está exibindo, sua saúde e quais controles o dispositivo oferece. O dashboard continua lá para quem quiser usá-lo; nada depende de ele estar aberto. Digital signage headless explica o modelo, e a página da API cobre todas as interfaces.

Para um agente de IA, cole uma frase para ele, e ele instala o plugin oficial do screenRIG, que inclui a skill e a CLI screenrig. Na primeira execução, ele se cadastra: cria a sua organização e o seu projeto e envia um convite por e-mail. A página Início rápido traz a frase e os comandos de instalação para cada agente.

Um cliente MCP como Claude, ChatGPT ou Grok pode, em vez disso, se conectar ao servidor MCP remoto: uma pessoa o aprova no dashboard e escolhe Somente leitura, Propor ou Gerenciar para ele. Somente leitura basta para um agente que apenas observa, como na sessão acima. O plugin acrescenta as etapas que são executadas na sua máquina, como converter mídia e empacotar apps. Conectar um cliente MCP traz o endereço do servidor e o login.

Para um script, um job de CI ou o seu próprio serviço, crie um cliente de serviço apenas com o acesso de que ele precisa:

screenrig service-client create --name "rollout-pipeline" --access manage

Um cliente Somente leitura serve para uma tarefa de monitoramento, e as alterações de um cliente Propor esperam que uma pessoa as revise. Clientes de serviço cobre o login com uma chave ou um segredo.

Escolha dispositivos que iniciem sozinhos e que você possa recuperar à distância. Um Raspberry Pi ou PC Linux em uma instalação de quiosque, um player BrightSign, um PC com Windows ou um dispositivo Android gerenciado podem todos reiniciar sob comando; sticks e apps de TV são mais baratos, mas não podem. Como escolher um player de digital signage compara esses dispositivos, e Downloads lista todos eles.

Um código de pareamento resolve para uma tela. Para dez, um link de frota é uma única URL do Player que transforma cada dispositivo que a abre em uma tela própria no seu projeto, com as tags, os campos e a playlist do link, sem código para ler em voz alta.

screenrig fleet-links create --name "Kitsilano counters" --tag Kitsilano --tag Counter --playlist-id pl_MENU --max-screens 6 --expires-at 2026-11-30T23:59:59Z

A resposta traz a URL. Ela é uma credencial que cria telas, então entregue-a apenas à configuração do dispositivo, nunca a uma página ou a um chat. Depois, coloque-a onde o dispositivo a encontre:

• Raspberry Pi e Linux. Execute o instalador como quiosque com o link: curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk --fleet-link URL. O dispositivo passa a iniciar direto no Player, entra no projeto e volta sozinho depois de uma queda de energia.
• Android, Google TV e Amazon Signage Stick. Defina a chave fleet_link na configuração gerenciada do app, no seu gerenciador de dispositivos (pacote ai.screenrig.player).
• Um dispositivo Android 10 ou posterior, restaurado de fábrica e com câmera. Escaneie o código QR de proprietário do dispositivo Android do link na tela de boas-vindas. O Player gerenciado se instala como o app inicial do dispositivo, em tela cheia, sem gerenciador de dispositivos.
• Mac, Apple TV, iPhone e iPad. Defina fleet_link na configuração de app gerenciada do seu MDM.
• ChromeOS. Coloque o link na URL do app de quiosque no Google Admin console.

--max-screens e --expires-at impedem que um link vazado crie telas para sempre; as telas que ele já criou continuam reproduzindo. Um dispositivo que passa por powerwash ou é reinstalado volta como a mesma tela quando sua identidade antiga fica dez minutos em silêncio. O guia do Player traz a configuração de cada gerenciador de dispositivos.

As programações rodam no fuso horário de cada tela, então defina-o e depois diga às telas quando ficar ligadas:

screenrig screen set-timezone scr_KITS_COUNTER_1 --timezone America/Vancouver
screenrig screen display-schedule set --tag Window --file store-hours.json

A programação de display roda no player, então o display se apaga no horário de fechamento mesmo que a internet da loja esteja fora do ar. Os players compatíveis desligam a própria TV por HDMI-CEC, DDC/CI ou pela luz de fundo; os demais apagam a imagem. Veja HDMI-CEC para digital signage. Em todos os planos, uma programação de reinicialização reinicia os dispositivos em um horário tranquilo, como "Mon-Sun 04:00-04:30".

Um agente publica a partir de uma frase. Pelo código, screen publish cria uma playlist a partir de um arquivo preparado, atribui a playlist e espera até que o Player informe que a está exibindo:

screenrig screen publish scr_KITS_COUNTER_1 menu.json
screenrig screen screenshot --tag Kitsilano --output shots/

Uma atribuição não é prova de reprodução, então a publicação espera o Player, e uma captura de tela mostra o que está na tela. As mudanças de frota vão por tag ou pasta, e uma ação de frota é uma solicitação, não importa quantas telas alcance. Uma gravação pode levar uma verificação de revisão (--expect-rev), para que dois autores não se sobrescrevam em silêncio.

Todo projeto começa com um e-mail para o proprietário quando uma tela fica offline por 10 minutos. Adicione as condições que importam para você:

screenrig notifications create --email owner --conditions screen_offline,display_disconnected,not_playing,glass_blank,glass_frozen --tag Kitsilano

As notificações também monitoram um dispositivo superaquecido, armazenamento cheio, uma atualização de conteúdo travada, um Player que falha repetidamente e uma playlist que parou de avançar. E-mail e webhooks assinados vêm em todos os planos; o roteamento para Slack, Teams, PagerDuty ou Telegram vem com o Plus. Para um agente que reage por conta própria, screenrig events follow transmite os eventos do projeto, e os eventos de tela são gratuitos no fluxo de escuta.

Cada Player informa a própria saúde a cada quinze minutos e de imediato quando a conexão do display ou a energia muda: tempo ativo, memória, temperatura nos dispositivos que a têm, rede e falhas. screen show devolve essas informações junto com as capacidades do host da tela, para que o agente saiba o que uma tela consegue fazer antes de tentar.

Quando uma tela falha, o agente começa pela correção mais barata e só usa o que aquele Player declara:

1. Olhe. screen show informa a última queda da tela e, assim que um relatório de saúde chega a uma conclusão, uma causa provável: uma reinicialização do dispositivo, uma falha do app, a rede ou o screenRIG. Uma captura de tela mostra o que está na tela.
2. Recarregue. screen reload atualiza o conteúdo sem mexer no dispositivo.
3. Reinicie o app ou limpe o cache. screen restart-app reinicia o Player; screen clear-cache descarta o conteúdo baixado, mantém o pareamento e baixa tudo de novo.
4. Reinicie. screen reboot reinicia o dispositivo nos Players que oferecem esse suporte. Enviada a uma tela offline, a reinicialização fica na fila por até 24 horas e é executada quando a tela volta. Uma reinicialização que você pediu não gera alerta de offline enquanto o dispositivo reinicia.
5. Troque o hardware. Se um dispositivo morrer, pareie o substituto e execute screen replace: o novo dispositivo assume o nome, as tags, o fuso horário, a playlist, as programações e o histórico da tela antiga.

A referência da CLI lista todos os comandos de dispositivo e os Players que os aceitam.

• Agente conectado, ou um cliente de serviço com o menor acesso de que precisa
• Players escolhidos pela reinicialização remota onde uma visita ao local é cara
• Um link de frota por loja ou grupo, com tags, uma playlist, um limite de telas e uma data de expiração
• O fuso horário de cada tela definido
• Programação de display para telas que devem ficar apagadas fora do expediente
• Primeira publicação verificada com uma captura de tela de cada tela
• Notificações para offline, display desconectado, sem reprodução e imagem em branco ou congelada
• Uma pessoa indicada que recebe os alertas

Preciso mesmo do dashboard?

Não. Tudo neste guia funciona pelo agente, pela CLI ou pela API. O dashboard é só mais um cliente, útil quando uma pessoa quer dar uma olhada.

Posso implantar sem ler códigos de pareamento em voz alta?

Sim. Um link de frota cadastra cada dispositivo que o abre, seja por um gerenciador de dispositivos, por uma opção do instalador Linux ou por um código QR Android.

O que acontece quando a internet cai em uma loja?

Os Players nativos continuam reproduzindo o que baixaram, e as programações de display continuam rodando no dispositivo. Você recebe um aviso de offline depois que a tela fica offline pelo tempo de espera que você definiu.

Quanto custa uma implantação?

O screenRIG é gratuito, com telas ilimitadas no Standard. Veja preços para saber o que os planos pagos acrescentam.

• screenrig.ai/docs/start
• screenrig.ai/docs/players
• screenrig.ai/docs/cli
• screenrig.ai/docs/service-clients