Stato

L'API /osc/state restituisce gli attributi state della videocamera. La differenza tra questa API e l'API info è che state contiene valori modificabili che rappresentano lo stato della fotocamera (ad esempio batteryLevel), mentre info contiene solo attributi statici della videocamera (ad esempio manufacturer o attributi che non cambiano spesso come firmwareVersion).

Input

  • Questo comando non accetta input.

Output

Nome Digitare Descrizione
fingerprint Stringa Impronta (identificatore univoco) dello stato corrente della videocamera.
state Oggetto Un oggetto JSON contenente lo stato dei vari stati della videocamera. Consulta la tabella successiva.

state oggetto

Questo oggetto JSON fornisce lo stato dei vari stati della videocamera. I produttori possono fornire nuovi stati personalizzati, che devono essere preceduti da un trattino basso ( _) per evitare collisioni dello spazio dei nomi.

Nome Digitare Descrizione
sessionId Stringa ID della sessione corrente. Questo campo è stato ritirato nel livello API 2.
batteryLevel Numero Espressa come valore in virgola mobile della batteria rimanente, ad esempio 0,5
storageChanged Booleano True se un nuovo tipo di archiviazione (ad esempio una scheda SD o un'unità USB) viene inserito/rimosso. Questo campo è stato ritirato nel livello API 2.
storageUri Stringa Un identificatore univoco per distinguere spazi di archiviazione diversi. Viene utilizzato per capire se lo spazio di archiviazione è cambiato o meno. Questo campo è stato aggiunto al livello API 2.
_vendorSpecific [tipo](facoltativo) Stato aggiuntivo specifico del fornitore relativo alla videocamera. Prefisso con un trattino basso ( _) per evitare collisioni dello spazio dei nomi.

Errore

  • Questo comando non restituisce errori.

Esempio
Richiedi 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Risposta 
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
    }
}