Estado

La API de /osc/state muestra atributos state de la cámara. Diferencias entre esto y la API de info es que state contiene valores mutables que representa 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 que no cambian con frecuencia, como firmwareVersion).

Entrada

  • Este comando no admite entradas.

Salida

Nombre Tipo Descripción
fingerprint String 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 incluir el prefijo de un guion bajo ( _ ) para evitar colisiones de espacios de nombres.

Nombre Tipo Descripción
sessionId String 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 se 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 String Es un identificador único para distinguir almacenamientos diferentes. 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 específico del proveedor de la cámara. Usa el prefijo con un guion bajo ( _ ) 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
    }
}