Aller au contenu principal

Devices et players

Statut​

Document de cadrage PlayLoop — version initiale.

Définition​

Un device PlayLoop représente un écran ou player capable de récupérer et afficher une playlist.

Il peut correspondre à une TV, box Android, navigateur web, PWA, Raspberry Pi ou autre support technique à confirmer.

État actuel visible​

Le backend contient :

  • table playloop_devices ;
  • champs name, token, acteur_id, status, last_seen_at ;
  • statuts visibles active, inactive, revoked ;
  • token opaque de 64 caractères ;
  • token stocké hashé ;
  • token en clair retourné uniquement à la création ;
  • middleware device.token ;
  • endpoint /playloop/device/playlist ;
  • endpoint /playloop/device/ping.

Authentification device​

Le device s'authentifie avec :

  • header Authorization: Bearer {token} ;
  • header X-App-Source: playloop via le middleware identify.app.

Un token manquant, invalide ou révoqué retourne une erreur 401.

Cycle de vie cible​

  1. Création du device par un utilisateur autorisé.
  2. Affichage du token une seule fois.
  3. Configuration du player.
  4. Ping régulier.
  5. Récupération de la playlist.
  6. Surveillance du last_seen_at.
  7. Révocation si l'écran est perdu, remplacé ou compromis.

Players cibles​

PlayerStatut
Web playerVision cible réaliste pour démarrage.
PWA plein écranVision cible compatible stratégie web.
Android TVVision cible à évaluer.
Box Android / navigateur TVVision cible à tester.
Raspberry PiHypothèse future selon besoins terrain.

Principes​

  • Installation simple.
  • Token non exposé après création.
  • Révocation immédiate possible.
  • Statut device visible.
  • Résilience réseau à définir.
  • Mode plein écran adapté à l'affichage continu.

Points à clarifier​

  • Type de player prioritaire.
  • Fréquence de ping.
  • Cache local de playlist.
  • Comportement si aucune playlist active.
  • Processus de remplacement d'un écran.
  • Sécurité physique des devices.