ScreenGuruParlons de votre projet
← Téléchargements

Votre caisse.
Le compteur du rayon.

SDK Android 0.1.0 · Android 5 / API 21 minimum · bibliothèque à intégrer dans votre application de caisse.

Télécharger le SDK et sa documentation

Cette archive développeur contient la bibliothèque AAR, ses dépendances à déclarer, le guide complet et un exemple Java. Ce n’est pas un player ni une application de caisse prête à installer.

Le relais reste dans la caisse

Une caisse Android conserve la valeur de référence du compteur. D’autres caisses dédiées au même rayon peuvent le piloter. Les players lisent la même valeur sur le réseau local Ethernet ou Wi-Fi ; aucun boîtier relais supplémentaire n’est nécessaire.

Le SDK se compile avec JDK 17 et le SDK Android 37. Le guide de l’archive détaille l’ajout de l’AAR, des dépendances et du service de premier plan dans votre APK. Appelez CounterTerminalService.connect(context, listener) depuis l’activité visible. Fermer la connexion de l’interface ne doit pas arrêter le service du relais.

Associer le rayon et ses appareils

  1. Créer le compteur dans le cloud

    Dans « Studio d’écrans → Compteurs de rayon », créez le rayon du magasin et générez le code pour la caisse de référence.

  2. Associer la caisse

    Sur le terminal fourni par le service, appelez enroll(cloudUrl, code, endpoint, callback). Conservez https://cloud.screenguru.io pour le cloud. L’adresse locale du relais ressemble à ws://192.168.1.10:8766/counter/v1. Le protocole chiffre les échanges applicatifs et vérifie l’identité des appareils.

  3. Préparer le réseau local

    Réservez l’adresse IPv4 de la caisse dans le DHCP du magasin et autorisez le port TCP 8766 entre caisses et écrans. Ne publiez pas ce port sur Internet. Utilisez un code propre à chaque caisse secondaire ; ne copiez jamais les clés ou préférences d’un appareil.

  4. Affecter les écrans

    Ajoutez les écrans du rayon, sélectionnez ce compteur comme source du widget « Indicateur » dans la composition, puis publiez. L’association initiale exige Internet.

Les commandes de votre caisse

  • increment() : client suivant.
  • decrement() : précédent, avec plancher à zéro.
  • reset() : remise à zéro à la demande.
  • set(long) : choisir un numéro.
  • recall() : annoncer à nouveau le numéro courant.
  • configure(JSONObject) : format, annonces, volume et remise à zéro automatique optionnelle.
  • status() : état confirmé et disponibilité des écrans.

Affichez la valeur confirmée par le relais, sans l’incrémenter par anticipation. En cas de résultat uncertain=true, ne renvoyez pas automatiquement la commande : consultez le résultat après reconnexion. Le guide complet décrit les callbacks et inclut un exemple compilé.

Sans Internet, avec le réseau du magasin

Après association et téléchargement, les commandes locales, la persistance et les médias fonctionnent sans Internet. Les commandes venant du cloud nécessitent que le relais soit joignable. Si un écran manque, la caisse doit afficher « Un de vos écrans est hors ligne ». S’il perd la caisse de référence, le widget indique « Indisponible ».

À la reconnexion, l’écran récupère la dernière valeur sans rejouer les anciennes annonces. Les sons doivent être présents localement ; une voix uniquement en ligne n’est pas utilisée. La remise à zéro automatique est désactivée par défaut. Les révisions affichées permettent de distinguer un message reçu d’un numéro réellement présenté par le player.

Vérifier cette livraison

Archive : screenguru-counter-sdk-0.1.0.zip · 141276 octets.

SHA-256 :

524c3b81fbb5323109ef7de8090d0703569db33e070698100b2a203ea0edc6e4

Commit source : 945596b92657f79b60e3b2bbddc7dc141f3a0eab.

Utilisez l’archive officielle et ses empreintes, puis testez votre intégration sur votre caisse et vos écrans. La qualification automatisée ne certifie pas tous les firmwares, cartes réseau, haut-parleurs ou modes de veille. Les projets Samsung/Tizen et LG Signage restent distincts des players déjà livrés.