Estado

La API de /osc/state muestra los atributos state de la cámara. La diferencia entre esto y la API de info es que state contiene valores mutables que representan el estado de la cámara (por ejemplo, batteryLevel), 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 el estado 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 tener el prefijo de un guion bajo ( _) para evitar colisiones de espacios de nombres.

Nombre Tipo Descripción
sessionId Cadena Es el 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 batería restante, p. ej., 0.5.
storageChanged Booleano Verdadero si se inserta o quita un nuevo tipo 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 Es un identificador único para distinguir distintos almacenamientos. Se usa para decir si el almacenamiento ha cambiado o no. Este campo se agregó en el nivel de API 2.
_vendorSpecific [tipo](opcional) Estado adicional de la cámara específico para proveedores Debe incluir el prefijo ( _ ) para evitar colisiones de espacios 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
    }
}