State

Die /osc/state API gibt state-Attribute der Kamera zurück. Der Unterschied zwischen dieser und der info API besteht darin, dass state veränderliche Werte enthält. für den Kamerastatus (z. B. batteryLevel), während die info enthält nur statische Attribute der Kamera (z. B. manufacturer oder Attribute, die sich nicht oft ändern, wie firmwareVersion).

Eingabe

  • Für diesen Befehl ist keine Eingabe erforderlich.

Ausgabe

Name Typ Beschreibung
fingerprint String Fingerabdruck (eindeutige Kennung) des aktuellen Kamerastatus.
state Object Ein JSON-Objekt, das den Status verschiedener Kamerazustände enthält. Siehe die nächste Tabelle.

state Objekt

Dieses JSON-Objekt enthält den Status verschiedener Kamerazustände. Hersteller dürfen neue, benutzerdefinierte Statuswerte bereitstellen, denen ein Unterstrich ( _ ) vorangestellt werden sollte um Namespace-Konflikte zu vermeiden.

Name Typ Beschreibung
sessionId String ID der aktuellen Sitzung. Dieses Feld wurde in API-Level 2 eingestellt.
batteryLevel Zahl Ausgedrückt als Gleitkommawert des verbleibenden Akkus, z.B. 0,5
storageChanged Boolesch „True“, wenn ein neuer Speichertyp (z.B. eine SD-Karte oder ein USB-Speicher) eingesetzt oder entfernt wird. Dieses Feld wurde in API-Level 2 eingestellt.
storageUri String Eine eindeutige Kennung zur Unterscheidung verschiedener Speicher. Gibt an, ob der Speicher geändert wurde oder nicht. Dieses Feld wurde in API-Ebene 2 hinzugefügt.
_vendorSpecific [Typ](optional) Anbieterspezifischer zusätzlicher Status der Kamera. Verwenden Sie einen Unterstrich ( _ ), um Namespace-Konflikte zu vermeiden.

Fehler

  • Dieser Befehl gibt keine Fehler zurück.

Beispiel
Anfrage 
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
    }
}