status

Kommando: status
Bereich: Grundlage
Profil: Pflicht
Antwort: Zustand und Eckdaten der Anzeige

Auftrag und Antwort#

{"v":1,"cmd":"status"}

{"v":1,"ok":true,"result":{
  "state":"active","session":true,
  "monitor":{"index":1,"w":1920,"h":1080},
  "uptime_s":38412}}

Feld	Pflicht	Inhalt
`state`	ja	`idle`, `active`, `farewell` oder `saver`
`session`	ja	ob gerade eine Sitzung offen ist
`monitor.index`	nein	Nummer des bespielten Bildschirms
`monitor.w`, `monitor.h`	nein	dessen Auflösung in Bildpunkten
`uptime_s`	nein	Laufzeit der Anzeige in Sekunden

Wozu#

status ist für die Fehlersuche und für Verwaltungsoberflächen gedacht: Es beantwortet die Frage „Was steht dort gerade eigentlich?", ohne dass jemand vor dem Bildschirm stehen muss.

Für den laufenden Betrieb braucht es das Kommando nicht. Ein Steuerprogramm führt seinen eigenen Stand mit und fragt ihn nicht bei der Anzeige ab – insbesondere darf es nicht in kurzen Abständen abfragen, um Änderungen zu bemerken.