Agente Android — Configuração
As definições estão protegidas por palavra-passe. Para as abrir: toque 4 vezes no fundo e escolha o nível Admin ou Utilizador.
Definições que são geridas a partir do painel web
Estes valores geram-se em Painel → Dispositivos → Editar kiosk, não no dispositivo. O agente recebe-os no próximo heartbeat:
- Modo Web Kiosk vs Playlist
- URL inicial (modo Web Kiosk)
- Whitelist de URLs (modo Web Kiosk)
- Playlist atribuída (modo Playlist)
- Palavra-passe do menu admin
Definições geridas no dispositivo
Estas só podem ser alteradas a partir das definições locais do agente (nível Admin):
| Definição | Descrição |
|---|---|
| URL do servidor | Endpoint base RDS. Por defeito https://rds.digitalsignagerds.com. |
| ID do dispositivo | Código RDSXXXX atribuído no painel. Sem isto o agente não consegue autenticar-se. |
| Intervalo de sync | Tempo entre heartbeats / verificações de conteúdo novo. |
| Caminho de armazenamento | Onde guardar a cache local de vídeos e imagens (tipicamente armazenamento externo). |
| Modo de visualização | Ecrã inteiro com stretch ou letterbox conforme o aspect ratio do vídeo. |
| Volume | Slider de volume do leitor. |
Palavra-passe admin
Dois níveis:
- Admin (
contrassenya_settings) — controlo total. - Utilizador (
contraUser_settings) — apenas consulta.
A palavra-passe de fábrica está documentada internamente e deve ser alterada em produção. O painel web sinaliza com um aviso vermelho qualquer dispositivo que ainda utilize a palavra-passe de fábrica.
WiFi
O agente Android não gere a configuração WiFi internamente — usa a configuração do sistema Android. Para adicionar ou alterar WiFi:
- Ligue um teclado/rato ao dispositivo e entre nas definições do Android.
- Ou, se comprou o dispositivo à Promotienda e indicou SSID + palavra-passe no formulário de compra, vem pré-configurado e liga-se sozinho no primeiro arranque.
Reset / limpeza
Se precisar de desvincular o dispositivo do painel:
- No painel, Ações → Eliminar sobre a linha — liberta o lugar.
- No dispositivo, abra Definições (Admin) → apague ID do dispositivo e URL do servidor. Ou desinstale a app a partir do Android.
Bloqueio de quiosque (modo de ecrã fixo)
Impede sair da aplicação: sem barra de estado, sem painel de notificações, sem recentes e sem menu de encerramento. Há dois mecanismos e o agente usa o melhor disponível em cada equipamento.
No menu Admin (2016), logo abaixo do botão de bloqueio, o agente indica que método este equipamento em concreto vai usar, para não depender de suposições:
| O que mostra | O que significa |
|---|---|
| Método de bloqueio: LockTask (proprietário do dispositivo) — ativo | Bloqueio real em curso. |
| Método de bloqueio: LockTask (proprietário do dispositivo) — disponível | Aprovisionado corretamente; ativa-se ao ligar o bloqueio. |
| Método de bloqueio: root (desativar SystemUI) | Apenas equipamentos com root. Funciona no Android 5.1; no Android 10+ o sistema restaura a interface ao fim de poucos segundos. |
| Sem método de bloqueio disponível neste dispositivo | Nem proprietário do dispositivo nem root: o botão não terá efeito real. |
Aprovisionar como proprietário do dispositivo
É a opção recomendada e não requer root. Faz-se uma única vez, durante a instalação, e o equipamento não pode ter nenhuma conta Google adicionada (se tiver, é preciso removê-la ou repor de fábrica primeiro).
adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver
Resposta esperada: Success: Device owner set to package ....
Depois, ative Bloqueio completo de quiosque no menu Admin. O agente volta a entrar em bloqueio sozinho após cada reinício, mudança de modo ou atualização.
Para retirar o bloqueio, desative-o a partir do menu Admin antes de retirar o equipamento. Um dispositivo que continua proprietário e bloqueado só se recupera por ADB ou com uma repositura de fábrica.
Requisitos
- Agente 2.4.0 ou superior.
- Android 5.1 ou superior (testado de Android 5.1 a Android 15).
- Sem contas no dispositivo no momento de aprovisionar.