Agent Android — Installation

Prérequis

• Android 5.0 (API 21) ou supérieur. Vérifié jusqu'à Android 15.
• Écran en orientation paysage (l'agent force le landscape).
• ~200 Mo libres sur le stockage externe pour le cache de contenu (plus, selon le poids de votre playlist).
• Connexion internet — Ethernet ou WiFi.

Installer l'APK

L'APK s'appelle promotienda.rds.apk et est fourni par Promotienda.

1. Activez sur l'appareil Paramètres → Sécurité → Sources inconnues (ou l'équivalent pour votre version d'Android : autoriser l'installation d'APKs depuis la source que vous allez utiliser).
2. Téléchargez l'APK depuis le lien fourni par Promotienda.
3. Ouvrez-le depuis le gestionnaire de fichiers pour démarrer l'installation.
4. Accordez les permissions demandées au premier démarrage :
   • Stockage — pour enregistrer les vidéos et images téléchargées.
   • Localisation — l'agent envoie les coordonnées GPS au serveur (uniquement si disponibles).
   • Afficher au-dessus des autres apps — pour les dialogues de paramètres.

Sur Android 6+, certaines permissions ne sont demandées qu'à la première utilisation.

Premier démarrage

À la première ouverture, l'app tente de s'authentifier contre le serveur avec la configuration par défaut et affiche un fond neutre jusqu'à avoir une playlist assignée.

Pour configurer l'appareil :

1. Tapez 4 fois sur n'importe quel point du fond en moins de 3 secondes.
2. Un dialogue de mot de passe apparaît. Il y a deux niveaux :
   • Admin — accès complet aux paramètres (URL du serveur, intervalles de sync, chemin de stockage).
   • Utilisateur — lecture seule : info de l'appareil et config de base.
3. Après saisie du mot de passe, vous avez 30 secondes avant que les paramètres ne se ferment pour inactivité.

Le bouton Retour de l'appareil ouvre aussi l'invite de mot de passe.

Auto-démarrage

L'APK enregistre un receiver BOOT_COMPLETED — lorsque l'appareil redémarre (coupure de courant, redémarrage programmé, etc.) l'agent démarre automatiquement sans intervention.

Activer comme app Home (nécessaire sur Android 10+)

Depuis Android 10 (API 29), les apps ne peuvent plus lancer d'Activities depuis un broadcast receiver / service en arrière-plan. Le receiver BOOT_COMPLETED démarre le service, mais l'Activity du kiosk reste bloquée et l'appareil reste sur le launcher après redémarrage.

La solution standard pour un kiosk est de déclarer l'APK comme app Home de l'appareil. Une seule fois par appareil.

Assistant automatique (depuis v2.1) : à la première ouverture de l'app sur un appareil où elle n'est pas encore l'app Home, un dialogue apparaît :

Configurer comme app d'accueil Pour que le kiosk démarre automatiquement à chaque allumage de l'appareil, configurez-le comme app Home. [ Plus tard ] [ Configurer ]

Appuyez sur Configurer et les paramètres Android s'ouvriront directement sur l'écran Default home app. Choisissez "Digital Signage RDS" et confirmez.

Assistant manuel (si vous avez appuyé Plus tard ou si le dialogue n'est pas apparu) :

1. Paramètres → Apps → Apps par défaut → App Home (sur certains OEMs : Paramètres → Apps → "App d'accueil" ou Paramètres → Home)
2. Choisir "Digital Signage RDS" dans la liste
3. Accepter la confirmation

Dès lors, Android lance le kiosk directement au démarrage (sans passer par le launcher). Le bouton HOME ramène aussi toujours au kiosk — utile pour empêcher l'utilisateur de sortir.

Le dialogue automatique réapparaît à chaque démarrage tant que le kiosk n'est pas l'app Home. Si vous le rejetez avec Plus tard, il réapparaît au prochain démarrage de l'app ou au redémarrage de l'appareil.

Activer le service d'accessibilité (captures plein écran)

Juste après le dialogue Home, si l'appareil est Android 11+ et que le service d'accessibilité de captures n'est pas activé, un second dialogue apparaît :

Activer les captures distantes Pour autoriser le panneau RDS à demander des captures d'écran à tout moment (même si l'app n'est pas au premier plan), activez le service d'accessibilité de "Digital Signage RDS". [ Plus tard ] [ Activer ]

Appuyez sur Activer → les paramètres d'accessibilité s'ouvrent → Services téléchargés → Digital Signage RDS → Activer. Confirmez l'avertissement système sur les permissions.

Sans ce service :

• Les captures n'ont lieu que lorsqu'une Activity du kiosk est au premier plan.
• Si le kiosk a planté ou affiche un dialogue système, le panneau recevra une image du dernier frame visible — pas l'écran actuel.

Avec le service activé, les captures fonctionnent toujours, incluent l'UI système / dialogues d'erreur / lockscreen, et survivent aux plantages de l'Activity (Android relance automatiquement le binding d'accessibilité).

Comme pour le dialogue Home : si vous le rejetez avec Plus tard, il réapparaît à chaque démarrage jusqu'à ce que le service soit activé.

Vérifier l'auto-démarrage

Après un redémarrage, les logs de l'agent enregistrent :

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

Si vous voyez la ligne BroadcastReceived mais que le kiosk n'apparaît pas, il manque presque certainement l'étape app Home. Voir les logs dans le panneau : Actions → Logs.

Version installée

La version de l'agent est visible dans Paramètres → version. Elle est aussi rapportée au serveur à chaque heartbeat et affichée dans la colonne version de la liste des appareils.

Version minimale supportée pour Android : 2.0.0. Les versions inférieures affichent un bandeau End of Life dans le panneau.