Stato

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

Input

  • Questo comando non accetta input.

Output

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

state oggetto

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

Nome Tipo Descrizione
sessionId Stringa ID della sessione corrente. Questo campo è stato ritirato nel livello API 2.
batteryLevel Numero Espresso come valore in virgola mobile della batteria rimanente, ad esempio. 0,5
storageChanged Booleano True se viene inserito/rimosso un nuovo tipo di archiviazione (ad es. una scheda SD o un'unità USB). Questo campo è stato ritirato nel livello API 2.
storageUri Stringa Un identificatore univoco per distinguere i diversi spazi di archiviazione. Viene utilizzato per sapere se lo spazio di archiviazione è cambiato o meno. Questo campo è stato aggiunto nel livello API 2.
_vendorSpecific [tipo](facoltativo) Stato aggiuntivo della fotocamera specifico del fornitore. Fai precedere un trattino basso ( _) per evitare collisioni tra 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
    }
}