Estado

La API de /osc/state muestra atributos state de la cámara. La diferencia entre esto y la info API es que state contiene valores mutables que representan el estado de la cámara (batteryLevel, por ejemplo), mientras que info contiene solo atributos estáticos de la cámara (por ejemplo, manufacturer o atributos que no cambian con frecuencia, como firmwareVersion)).

Entrada

  • Este comando no admite entradas.

Salida

Nombre Tipo Descripción
fingerprint Cadena Huella digital (identificador único) del estado actual de la cámara.
state Objeto Un objeto JSON que contiene la condición de varios de los estados de la cámara. Consulta la siguiente tabla.

Objeto state

Este objeto JSON proporciona la condición de varios de los estados de la cámara. Los fabricantes pueden proporcionar estados personalizados nuevos, que deben contener como prefijo un guión bajo ( _ ) para evitar colisiones de espacios de nombres.

Nombre Tipo Descripción
sessionId Cadena Id. de la sesión actual. Este campo dejó de estar disponible en el nivel de API 2.
batteryLevel Número Se expresa como un valor de punto flotante de la carga de batería restante; p. ej., 0.5
storageChanged Valor booleano Debe ser “true” si se inserta/retira un nuevo medio de almacenamiento (p. ej., una tarjeta SD o una unidad USB). Este campo dejó de estar disponible en el nivel de API 2.
storageUri Cadena Un identificador único para distinguir espacios de almacenamiento diferentes. Se usa para decir si el almacenamiento ha cambiado o no. Este campo se agregó en el nivel de API 2.
_vendorSpecific [tipo](optional) Estado adicional de la cámara específico para proveedores. Debe contener el prefijo ( _ ) para evitar colisiones de espacio de nombres.

Error

  • Este comando no muestra errores.

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