Commencer par une phrase
Une tâche CI dessine une affiche d’état après chaque exécution, avec quelques lignes de Python. Vous voulez la plus récente sur la télé de l’espace d’équipe.
- Vous
Notre tâche CI dessine une affiche d’état après chaque exécution. Mettez la plus récente sur la télé de l’espace d’équipe, et dites-moi quand la télé l’a réellement.
- Agent
La compilation 4821 est en ligne : PASSED, 221 tests sur 221. La télé a confirmé qu’elle avait l’affiche environ deux secondes après mon envoi, et j’ai pris une image de l’écran pour vérifier.

- Vous
La compilation 4822 vient d’échouer. Mettez la télé à jour.
- Agent
Mis à jour. La télé affiche maintenant FAILED en rouge, 219 tests sur 221.

La même chose depuis un script
Une tâche CI ne clavarde pas. Elle exécute une commande qui téléverse l’image et écrit la liste de lecture, et une seconde qui la met à l’écran et attend la confirmation de la télé :
screenrig playlist init build-4821.png --screen-id SCREEN --duration-ms 600000 --output board.json
screenrig screen publish SCREEN board.jsonSous le CLI se trouvent six appels HTTP avec un jeton porteur. Déclarer le téléversement, envoyer les octets, valider, créer la liste de lecture, diriger l’écran vers elle, relire l’écran. La référence de l’API les énumère un à un, et la référence du CLI énumère les codes de sortie. Un script qui s’exécute sans surveillance se connecte comme client de service.
Ce que vous dit une publication
Une publication attend la télé jusqu’à deux minutes, puis indique comment elle s’est terminée :
| La réponse | Ce que ça signifie | Que faire |
|---|---|---|
| En lecture | La télé a confirmé qu’elle a la liste de lecture. | Rien. |
| Assignée, écran hors ligne | La télé était éteinte ou déconnectée. Elle jouera la liste de lecture à sa reconnexion. | Relancez la même publication pour attendre. Elle ne crée jamais une deuxième liste de lecture. |
| Assignée, une prise de contrôle est affichée | Une substitution temporaire est à l’écran; la nouvelle liste de lecture est donc la liste par défaut et jouera quand la substitution prendra fin. | Attendez, ou effacez la prise de contrôle. |
| Assignée, la télé l’a refusée | La télé n’a pas pu basculer, par exemple vers une page dont l’adresse contient un identifiant de connexion. | Lisez la raison, corrigez-la, puis actualisez l’écran. |
| En attente de révision | Le projet exige qu’une personne approuve les changements. Rien ne joue tant qu’elle ne l’a pas fait. | Attendez l’approbation. |
| Déjà publié | La même publication a déjà été exécutée, et voici la réponse précédente. | Rien. |
Sans risque à réessayer, sans risque à partager
- Les nouvelles tentatives ne créent jamais de doublon. Envoyez deux fois la même publication et vous obtenez la même liste de lecture, pas une deuxième.
- Une mise à jour périmée est refusée. Mettez à jour avec la révision que vous avez lue. Si une autre tâche a modifié la liste de lecture avant, la vôtre est refusée et reçoit la révision actuelle; deux tâches ne peuvent donc pas s’écraser l’une l’autre.
- Une image de l’écran est gratuite. Il en va de même d’une actualisation ou d’une note sur un écran. Une commande qui met à jour tout un groupe d’écrans compte pour une seule requête, peu importe le nombre d’écrans touchés.
Votre agent peut créer un diaporama en une minute. Le maintenir en lecture sur chaque écran, sur chaque appareil, pendant des années, c’est ce que fait screenRIG.
Players explique comment installer un Player sur une télé donnée.
Ensuite : chaque appel, chaque champ et chaque erreur figurent dans la référence de l’API.
Lié
Autres guides
screenRIG est gratuit.
Installez le plugin officiel, jumelez un écran et votre agent y publie du contenu.
