Les réglages
Toutes les variables que lit le service de l'écran, et toutes les routes qu'il expose : la référence complète, à côté des chapitres qui les expliquent une à une.
Les variables d'environnement
Posées dans /etc/ecran-atelier.env (chapitre Installer l'écran), en droits 600 : elles l'emportent sur celles de l'unité systemd.
| Variable | Défaut | Rôle |
|---|---|---|
ADRESSE | :8099 | Où le service écoute. |
MUSIC_ASSISTANT | http://127.0.0.1:8095 | L'API de Music Assistant. |
MUSIC_ASSISTANT_JETON | (vide) | Le jeton d'accès : obligatoire depuis Music Assistant 2.10. |
METEO | 50.85,4.35 | Le lieu de la météo : « lat,lon », ou le nom d'une commune. |
VISUALISEUR_DECALAGE_MS | 0 | Le décalage entre le son et le spectre : la latence de ton enceinte (chapitre Installer l'écran). |
ADRESSE_MACHINES | :8098 | Où les services des machines (ecran-agent) se connectent : définie et vide, le port reste fermé. |
JETONS_MACHINES | (vide) | « Nom=jeton;Nom2=jeton2 », un jeton par machine ; vide, le port des machines reste fermé. |
Mets toujours METEO à ta commune ou tes coordonnées. Le défaut interne du service n'est pas destiné à servir en pratique : le laisser de côté affiche une météo qui n'est pas la tienne.
Les routes
« Réservé à l'écran » veut dire : le service ne répond qu'aux appels venus de la machine hôte elle-même ; vu du réseau, il répond 403.
| Route | Rôle |
|---|---|
GET / | La page, en plein écran. |
POST /etat | gproj — ou tout autre outil — y pousse l'état des fenêtres (chapitre Les projets). |
GET /flux | Le flux d'évènements que la page ouvre : elle est prévenue dès que l'état change, plutôt que de réinterroger / toutes les cinq secondes. |
POST /musique | Une touche de musique : lecture, pause, précédent, suivant, volume, ou lancer un favori. Réservé à l'écran. |
GET /visualiseur | Le jeton et l'adresse du relais MilkDrop, pour le spectre. Réservé à l'écran. |
POST /touche | Un appui sur une touche de machine. Réservé à l'écran. |
GET /icone/<empreinte>.png | L'icône d'une touche de machine, immuable. |
TCP 8098 | Les services des machines (ecran-agent) s'y connectent. |
GET /essai/trames | Une seconde de trames réelles, pour /?essai=spectre. |
GET /api/vue | Le même contenu que la page, en JSON : pour diagnostiquer sans regarder l'écran. |
GET /sante | Le service répond-il : {"etat":"ok"}. |