Dispositivos

O separador Dispositivos lista todos os ecrãs vinculados à sua empresa.

Colunas da lista

Ícone de plataforma

Na coluna da versão, um ícone indica o sistema do agente: Android, Linux ou Windows. Os equipamentos Linux com processador ARM mostram o logótipo do Raspberry Pi (ou um ícone de chip, se forem outra placa ARM). Ao passar o rato por cima vê-se a arquitetura e o modelo, por exemplo ARM64 · Raspberry Pi 5.

Filtros

Por empresa, sucursal, data ou texto livre (procura por nome, RDSXXXX, localização, departamento). Os filtros mantêm-se enquanto navega.

Menu "Ações"

Em cada linha tem dois menus pendentes:

Ações (utilizador)

• Painel do dispositivo — em Definições: modo Web/Playlist, URL inicial, whitelist, palavra-passe admin. Detalhe.
• Enviar mensagem ao suporte — envia uma incidência.
• Logs — mostra os últimos logs do agente. Útil para diagnóstico.
• Captura de ecrã — pede ao dispositivo uma captura JPEG do que está a mostrar. Abre um diálogo com um spinner; em ≤ 60 s a imagem aparece dentro do próprio diálogo e fica guardada na ficha do dispositivo. Se o dispositivo estiver desligado, o pedido fica pendente e é enviado assim que volte a estar online. Detalhe.
• Editar — nome, localização, empresa/sucursal, observações.
• Desbloquear token — cada ecrã fica associado ao dispositivo que o emparelhou. Para passar o lugar para outro equipamento, ou depois de reinstalar a app, prima Desbloquear token e confirme: o token é libertado e aparece Associar ecrã (QR) para emparelhar o novo dispositivo, que ocupa o lugar do anterior. Disponível para os utilizadores com permissão para modificar ecrãs, nos ecrãs da sua empresa; não está disponível com a licença expirada.
• Eliminar — apaga o dispositivo do plano (liberta o lugar).

Admin (apenas Promotienda)

Ações internas de suporte: ativar/desativar manualmente, retirar, ligar, atender incidência, etc.

Adicionar um dispositivo

Botão "+ Adicionar" no canto superior direito.

• Se o seu plano tem lugares livres, o dispositivo é criado de imediato sem custo.
• Se não tiver lugares livres, o sistema pede para ampliar o plano: pague o valor proporcional com o cartão e são criados tanto os lugares novos como os dispositivos.
• Receberá um email de confirmação com a lista de IDs criados e, se houve pagamento, a fatura PDF em anexo.

Importante: o dispositivo recém-criado existe apenas no painel. Para reproduzir conteúdo é necessário instalar o agente no hardware e emparelhá-lo com o ID atribuído. Se comprou o dispositivo à Promotienda isto já vem feito.

Comprar um dispositivo

Botão "Comprar dispositivo". Abre o catálogo com a opção de envio direto para a sua loja com a playlist e o WiFi pré-configurados. Inclui 1 ano de licença RDS grátis.

Mais detalhes aqui.

Estado de envio

Quando compra dispositivos pelo catálogo, durante o tempo em que demoram a ser enviados aparecem com um "Aguarda envio" e as ações do utilizador estão desativadas. A Promotienda marca-os como enviados quando saem do armazém — nessa altura as ações são reativadas e recebe um email de aviso.

Informação do dispositivo na ficha

Ao passar o rato sobre um dispositivo abre-se uma ficha com os seus dados em tempo real. As linhas relevantes:

O agente Android usa SystemClock.elapsedRealtime() (inclui tempo em deep-sleep). O agente Linux lê /proc/uptime.

Atualizar o agente

Em Painel do dispositivo → Versão do agente escolhe para que versão o ecrã se deve atualizar.

1. Em Versão de destino (a próxima a ser instalada) escolha uma versão publicada, ou — Sem destino (não atualizar) —.
2. Prima Guardar versão alvo. Até lá não se guarda nada: o rodapé do painel diz Por guardar e, depois de guardar, mostra a resposta do servidor, ou o motivo se a recusar (por exemplo, um agente demasiado antigo para se atualizar remotamente).
3. O ecrã transfere e instala a versão na ligação seguinte. Entretanto verá Atualização pendente para X junto à versão instalada.

No Android, a instalação só é automática em equipamentos com root. Nos restantes (tablets, telemóveis e TV sem root) o Android mostra a sua janela de instalação sobre o conteúdo e alguém junto do ecrã tem de premir Instalar. No Android 8 ou superior é preciso permitir antes Instalar apps desconhecidas para o Digital Signage RDS nas definições do Android. Se a instalação for recusada ou falhar, não volta a ser tentada até escolher outra versão de destino.

• Disponível no agente Android 2.0.0 ou superior e nos agentes Linux e Windows 2.0.
• Se a versão guardada já não estiver publicada, aparece como X (já não publicada).
• Se fechar o painel com alterações por guardar (em Definições, Reinício programado ou Versão do agente), o RDS pergunta «Há alterações por guardar neste dispositivo. Fechar e descartá-las?».

Capturas de ecrã

A partir de Ações → Captura de ecrã pode pedir ao dispositivo uma imagem JPEG do que está a mostrar no ecrã naquele momento. Funciona em Android, Linux e Windows.

Como funciona

1. Ao carregar na opção abre-se um diálogo modal com um spinner e a mensagem "Captura solicitada. A aguardar pelo dispositivo…". O contador a cinzento mostra os segundos decorridos.
2. O servidor marca o pedido (screenshot_pending=1) e injeta-o como flag na próxima resposta de heartbeat ao agente (≤ 60 s).
3. O agente:
   • Linux captura com scrot o ecrã :0 (tudo o que se vê, incluindo o navegador WebKit do modo kiosk ou o leitor de playlist).
   • Android captura com PixelCopy a janela da Activity em primeiro plano (PlayerActivity ou KioskBrowserActivity). Isso inclui o conteúdo WebView/Surface acelerado por GPU.
4. O JPEG (qualidade 70, ~150–400 KB típico) é assinado com HMAC-SHA256 v2 e enviado a /suport/upload_screenshot.php por POST.
5. O servidor verifica a assinatura, guarda a imagem como /screenshots/<num_serie_gprs>.jpg (sempre uma única imagem por dispositivo, é sobrescrita), limpa o flag e marca a hora screenshot_at.
6. O diálogo, que estava a fazer polling a cada 4 s, deteta a nova imagem e substitui-a por uma pré-visualização clicável (abre a imagem original num separador à parte).

Tempos e novas tentativas

• Em condições normais, a imagem aparece em 5–60 s.
• Se o dispositivo estiver desligado, sem rede, ou o agente parado, o diálogo expira aos 120 s e mostra: "O dispositivo não respondeu a tempo. O pedido fica pendente — se voltar a ficar online a imagem será enviada igualmente." O pedido não é cancelado: assim que o agente voltar a fazer heartbeat, recolhe o flag e envia a imagem. Só tem de atualizar a ficha do dispositivo para a ver.
• No Android, só se captura enquanto a Activity do kiosk está em primeiro plano (onResume). Se o dispositivo estiver bloqueado ou a mostrar outra app, a captura aguarda o próximo regresso ao kiosk.

Privacidade e permissões

• Apenas utilizadores com permissão Gestão > Ecrãs > Modificar (ou Admin > Ecrãs > Criar) podem solicitar capturas.
• A imagem é servida apenas através do painel e fica associada ao num_serie_gprs do dispositivo. Não existe endpoint público para listá-las.
• Cada nova captura sobrescreve a anterior — só fica guardada a mais recente.

Ver a imagem mais tarde

Se fechar o diálogo, a última captura continua acessível:

• Na ficha do dispositivo (clique no nome ou no ID) existe uma secção "Captura de ecrã" com a imagem e a data/hora em que foi tirada.