State

Mit der API /osc/state werden state-Attribute der Kamera zurückgegeben. Der Unterschied zwischen dieser API und der API info besteht darin, dass die API state änderbare Werte enthält, die den Kamerastatus angeben (z. B. batteryLevel), während die API info ausschließlich statische Attribute der Kamera enthält (z. B. manufacturer oder Attribute wie firmwareVersion), die nur selten geändert werden.

Eingabe

  • Für diesen Befehl sind keine Eingaben möglich.

Ausgabe

Name Typ Beschreibung
fingerprint Zeichenfolge Fingerabdruck (eindeutiges Kennzeichen) des aktuellen Kamerazustands.
state Objekt Ein JSON-Objekt, das den Status verschiedener Kamerazustände enthält. Siehe nachfolgende Tabelle.

Objekt state

Dieses JSON-Objekt enthält den Status verschiedener Kamerazustände. Hersteller können neue, herstellerspezifische Zustände bereitstellen, denen ein Unterstrich (_) vorangestellt sein sollte, um Namespace-Konflikte zu vermeiden.

Name Typ Beschreibung
sessionId Zeichenfolge ID der aktuellen Sitzung. Dieses Feld wurde in API Level 2 verworfen.
batteryLevel Zahl Ausgedrückt als Gleitkommawert, z. B. der verbleibenden Akkuleistung. 0,5
storageChanged Boolesch Wert „true“, wenn ein Speichermedium (z. B. eine SD-Karte oder ein USB-Laufwerk) hinzugefügt/entfernt wird. Dieses Feld wurde in API Level 2 verworfen.
storageUri Zeichenfolge Ein eindeutiger Bezeichner zur Unterscheidung zwischen unterschiedlichen Speichermedien. Gibt an, ob der Speicher geändert wurde oder nicht. Dieses Feld wurde in API Level 2 hinzugefügt.
_vendorSpecific [Typ](optional) Lieferantenspezifischer zusätzlicher Zustand der Kamera. Ein Unterstrich (_) sollte vorangestellt sein, um Namensraumkonflikte zu vermeiden.

Fehler

  • Dieser Befehl gibt keine Fehler zurück.

Beispiel
Anforderung 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Antwort 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "fingerprint": "12EGA33",
    "state": {
        "sessionId": "12ABC3",
        "batteryLevel": 0.5,
        "storageChanged": false
    }
}