Agente Android — Instalação

Requisitos

• Android 5.0 (API 21) ou superior. Testado até Android 15.
• Ecrã em orientação horizontal (o agente força landscape).
• ~200 MB livres em armazenamento externo para cache de conteúdo (mais, conforme o peso da sua playlist).
• Ligação à internet — Ethernet ou WiFi.

Instalar o APK

O APK chama-se promotienda.rds.apk e é disponibilizado pela Promotienda.

1. Ative no dispositivo Definições → Segurança → Origens desconhecidas (ou o equivalente da sua versão do Android: permitir instalar APKs a partir da fonte que vai utilizar).
2. Descarregue o APK a partir da ligação fornecida pela Promotienda.
3. Abra-o a partir do gestor de ficheiros para iniciar a instalação.
4. Conceda as permissões solicitadas no primeiro arranque:
   • Armazenamento — para guardar vídeos e imagens descarregados.
   • Localização — o agente envia coordenadas GPS para o servidor (apenas se disponíveis).
   • Mostrar sobre outras apps — para os diálogos de definições.

No Android 6+ algumas permissões só são pedidas quando necessárias pela primeira vez.

Primeiro arranque

Ao abrir a app pela primeira vez tenta autenticar-se contra o servidor com a configuração por defeito e mostra um fundo neutro até ter uma playlist atribuída.

Para configurar o dispositivo:

1. Toque 4 vezes em qualquer ponto do fundo em menos de 3 segundos.
2. Aparece um diálogo de palavra-passe. Existem dois níveis:
   • Admin — acesso completo às definições (URL do servidor, intervalos de sync, caminho de armazenamento).
   • Utilizador — apenas leitura: informação do dispositivo e config básica.
3. Após introduzir a palavra-passe tem 30 segundos antes de as definições se fecharem por inatividade.

O botão Voltar do dispositivo também abre o pedido de palavra-passe.

Auto-arranque

O APK regista um receiver BOOT_COMPLETED — quando o dispositivo reiniciar (por corte de energia, reinício programado, etc.) o agente arrancará automaticamente sem intervenção.

Ativar como app Home (necessário no Android 10+)

Desde o Android 10 (API 29) as apps não podem lançar Activities a partir de um broadcast receiver / serviço em segundo plano. O receiver BOOT_COMPLETED arranca o serviço, mas a Activity do kiosk fica bloqueada e o dispositivo fica no launcher após reiniciar.

A solução padrão para um kiosk é declarar o APK como app Home do dispositivo. Só é necessário uma vez por dispositivo.

Assistente automático (desde v2.1): ao abrir a app pela primeira vez num dispositivo onde ainda não é a app Home, aparece um diálogo:

Configurar como app de arranque Para que o kiosk inicie automaticamente cada vez que o dispositivo é ligado, configure-o como aplicação Home. [ Mais tarde ] [ Configurar ]

Carregue em Configurar e abrir-se-ão as definições do Android diretamente no ecrã Default home app. Escolha "Digital Signage RDS" e confirme.

Assistente manual (se carregou Mais tarde ou o diálogo não apareceu):

1. Settings → Apps → Default apps → Home app (em alguns OEMs: Settings → Apps → "App de início" ou Settings → Home)
2. Escolher "Digital Signage RDS" da lista
3. Aceitar a confirmação

A partir desse momento, o Android lança o kiosk diretamente no arranque (sem passar pelo launcher). O botão HOME também regressa sempre ao kiosk — útil para evitar que o utilizador saia.

O diálogo automático volta a ser apresentado em cada início enquanto o kiosk não for a app Home. Se o descartar com Mais tarde, voltará a aparecer na próxima vez que abrir a app ou o dispositivo reiniciar.

Ativar o serviço de acessibilidade (capturas full-screen)

Logo após o diálogo de Home, se o dispositivo for Android 11+ e o serviço de acessibilidade de capturas não estiver ativado, aparece um segundo diálogo:

Ativar capturas remotas Para permitir ao painel RDS solicitar capturas de ecrã a qualquer momento (mesmo se a app não estiver em primeiro plano), ative o serviço de acessibilidade de "Digital Signage RDS". [ Mais tarde ] [ Ativar ]

Carregue em Ativar → abrem-se as definições de acessibilidade → Serviços descarregados → Digital Signage RDS → Ativar. Confirme o aviso do sistema sobre as permissões.

Sem este serviço:

• As capturas são feitas apenas enquanto uma Activity do kiosk está em primeiro plano.
• Se o kiosk tiver caído ou mostrar um diálogo do sistema, o painel receberá uma imagem do último frame visível — não o ecrã atual.

Com o serviço ativado, as capturas funcionam sempre, incluem system UI / diálogos de erro / lockscreen, e sobrevivem a falhas da Activity (o Android relança automaticamente o binding de acessibilidade).

Tal como o diálogo de Home: se o descartar com Mais tarde, reaparece em cada início até o serviço estar ativado.

Verificar o auto-arranque

Após um reinício, os logs do agente registam:

[BOOT      ] BroadcastReceived: android.intent.action.BOOT_COMPLETED
[BOOT      ] MainActivity launch requested
[BOOT      ] AutoStartUp service start requested
[SYSTEM    ] Digital Signage RDS …

Se vir a linha de BroadcastReceived mas o kiosk não aparece, quase de certeza falta o passo de app Home. Veja os logs no painel: Ações → Logs.

Versão instalada

A versão do agente verá em Definições → versão. Também é reportada ao servidor em cada heartbeat e aparece na coluna versão da lista de dispositivos.

Versão mínima suportada para Android: 2.0.0. Versões inferiores apresentam um aviso End of Life no painel.